ruzzy

ruzzy 技能概覽

ruzzy 是用來做什麼的

ruzy 技能能幫你使用 Ruzzy，這是一個建立在 libFuzzer 上、以 coverage-guided 為核心的 Ruby fuzzing 工具。它的目標是想對 Ruby 程式碼做 fuzz，特別是 Ruby C extensions，並透過 sanitizer 偵測 crash 的人。如果你需要的是一條比單純翻 repo 還要具體的 ruzy install 與使用路徑，這個技能是為 Security Audit 工作準備的，不是一般 Ruby 自動化。

適合誰使用

如果你是以下情境，適合使用 ruzzy 技能：

• 測試帶有 native extensions 的 Ruby gem
• 想找 Ruby C 程式碼中的記憶體破壞或未定義行為
• 用 fuzzing 驗證 parser、serializer 或輸入處理流程
• 想判斷 Ruzzy 是否適合 Security Audit 工作流

如果你只需要單元測試、簡單的 property tests，或不含 native code 目標的黑箱應用測試，這個技能就沒那麼適合。

它和其他方法有什麼不同

Ruzzy 被定位成 Ruby 裡適合做 coverage-guided fuzzing 的正式可用方案。實際上的差異在於，它會透過程式碼覆蓋率和 sanitizers 給你回饋，因此比單純「丟隨機輸入」更擅長找出嚴重失敗。主要代價是設定成本：你需要正確的 Ruby、clang 與 Linux 環境，而且目標本身也得真的能被 fuzz。

ruzzy 技能怎麼用

安裝並驗證環境

進行 ruzy install 時，先從技能內容和專案的 SKILL.md 開始。repo 說 Ruzzy 支援 Linux x86-64 與 AArch64/ARM64。如果是 macOS 或 Windows，就要改用 Dockerfile 或 development environment，而不是原生安裝。

實際上可用這樣的方式檢查安裝是否正常：

export ASAN_OPTIONS="allocator_may_return_null=1:detect_leaks=0:use_sigaltstack=0"
LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \
  ruby -e 'require "ruzzy"; Ruzzy.dummy'

如果這個測試跑出預期中的 crash，代表 build 與 sanitizer 的串接已經正常。

把模糊目標改寫成可用的提示

要讓 ruzy usage 發揮效果，不要只模糊地說「幫我 fuzz 我的 gem」。你要提供足夠資訊，讓技能能選出 entry point 和 harness。建議至少包含：

• 目標 gem 或 repository 名稱
• 你要 fuzz 的是純 Ruby 還是 C extension
• 要驅動的 method、parser 或 API
• 範例輸入格式
• 你最在意的是 crash、hang，還是 coverage 成長

較好的輸入方式：

“Use ruzzy for Security Audit on this Ruby C extension. The target is MyGem::Parser.parse, which accepts a string payload and can reach native code. Help me build a minimal harness and a seed corpus for malformed JSON-like inputs.”

先讀 repo 裡的哪些內容

先看 SKILL.md，再檢查以下章節：

• When to Use
• Quick Start
• Installation
• Platform Support

如果你需要調整工作流程，先看安裝指令和任何內嵌的 repo 參照，再把範例複製到自己的專案。最大的導入阻礙通常是平台不相容，或是 fuzz 的抽象層級選錯了。

實務上可行的工作流程

一個穩定的 ruzy guide 流程是：

1. 確認平台以及 Ruby/clang 前置條件
2. 驗證 ASAN preload 設定
3. 選一個小而且可預測的 entry point
4. 針對那個 entry point 建立最小化 harness
5. 先短時間 fuzz，再逐步擴大覆蓋範圍

做 Security Audit 時，初期範圍要收斂。與其一次 fuzz 整個應用的所有表面，不如先鎖定一個穩定、輸入邊界清楚的 target，通常更有價值。

ruzzy 技能 FAQ

ruzzy 只適合 native extensions 嗎？

不是。這個技能同時支援純 Ruby 程式碼與 Ruby C extensions，但當有 native code 參與時，它的價值最明顯。如果你的目標只是應用邏輯測試，普通測試套件或 property-based testing 可能更簡單。

ruzzy 很難安裝嗎？

在支援的 Linux 系統上，ruzy install 的路徑算直接，但環境細節很重要。clang、Ruby 與 sanitizer 設定必須對得上。如果你在 macOS 或 Windows 上，預期要用 Docker 或 development environment，而不是直接原生安裝。

什麼情況下不該用 ruzzy？

如果目標無法反覆驅動、你無法隔離出穩定的輸入 entry point，或程式高度依賴外部服務，就不要用 Ruzzy。這些情況下，fuzzing 的訊號會很弱，設定成本也會大於價值。

初學者適合用嗎？

可以，但前提是你已經知道要測哪個 function 或 parser。若你還需要先找出目標表面，它就不是最容易上手的第一個 security 工具。初學者最好的做法，是先從 toy example 開始，再調整成一個小型 harness。

如何改進 ruzzy 技能

讓技能鎖定更窄的目標

品質提升最大的地方，就是把目標收窄。不要只說「fuzz 我的 gem」，要明確指定可呼叫的 surface、預期輸入型別，以及你在意的失敗類型。像是「找出 decode(input_string) 在遇到 malformed UTF-8 與巢狀分隔符時的 crash」就比泛泛請求好得多。

用真實輸入與邊界案例做種子

當你提供具代表性的 seed，尤其是目標有結構化輸入時，Ruzzy 的效果會明顯更好。建議放入：

• 3 到 10 個有效範例
• malformed 變體
• 邊界案例，例如空字串、超大 buffer、截斷資料

這比冗長指令更重要，因為初始 corpus 會直接影響探索方向。

針對 crash、hang 與 coverage 反覆調整

第一次跑完後，先改善 harness，再擴大執行時間。如果看到 crash，就把最小重現範例抽出來；如果看到 hang，就收緊 timeout 並簡化狀態；如果 coverage 停滯，就降低 setup 成本，移除 harness 中不必要的依賴。這個回饋循環，正是 ruzy usage 在 Security Audit 工作中真正有效的地方。