agentleFS
HiyokoSauna37HiyokoSauna37/claudecode-re-toolkit/.claude/skills/ghidra-headless/SKILL.md

ghidra-headless

Skill17 starsChanged 2 months agoMITView on GitHub

Ghidra Headless AnalyzerをDockerコンテナで実行し、PE/ELF/.NET/ARM バイナリの静的解析・デコンパイル・インポート分析を行う。quarantine 由来 .enc.gz の自動復号にも対応。 Use when: バイナリ解析(EXE/DLL/.NET/ARM/Android), デコンパイル, 静的解析, reverse engineering, マルウェア解析, CTF reversing, quarantine .enc.gz 解析 Do NOT use for: 動的解析(malware-sandbox), メモリダンプ解析(memory-forensics)

  • Reads credentials
  • Installs packages

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. aphrody-code/nie★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository6 other files it gives its agents.

The file

Files
SKILL.md

コマンド早見表

コンテナ管理

bash tools/ghidra-headless/ghidra.sh start     # ビルド&起動
bash tools/ghidra-headless/ghidra.sh stop      # 停止
bash tools/ghidra-headless/ghidra.sh status    # 状態確認

PE トリアージ(Phase 0)

bash tools/ghidra-headless/ghidra.sh pe-triage <binary|file.enc.gz>           # 入力種別を問わずこれ一本
bash tools/ghidra-headless/ghidra.sh pe-triage --in-container <container-path> # コンテナ内パスを直接指定

入口は ghidra.sh pe-triage に一本化されている(ホスト側 python pe_triage.py を直接叩かないこと)。通常 PE / .enc.gz / zip / コンテナ内パスのいずれもコンテナ内で処理され、ホストに平文検体は出ない。analyze-full を使う場合は Phase 0 が内包されるので事前単独実行は不要(戦略判断を先にしたい場合のみ単独で打つ)。

Verdict意味次アクション
PACKER_DETECTED:xxxパッカー検出malware-sandbox動的解析優先(静的解析スキップ)
HIGH_ENTROPY_PACKEDエントロピー>7.0動的解析検討
RWX_SECTIONRWXセクションデフォルト: analyze-full / パッカー疑い濃厚なら malware-sandbox 併用
LOW_IMPORTS_DYNAMIC_APIインポート極少デフォルト: analyze-full / 動的 API 解決の疑い濃厚なら malware-sandbox
MANY_SUSPICIOUS_APIS不審API 5件超デフォルト: analyze-full / 特定 API を深掘りしたい場合のみ imports/xrefs 個別
CLEAN_TRIAGE特筆なしanalyze-full(フル解析) or 個別コマンド

分岐ルール: PACKER_DETECTED / HIGH_ENTROPY_PACKED は malware-sandbox へエスカレーション(静的解析の ROI が低い)。それ以外はすべて analyze-full がデフォルト。個別深掘り(特定 API の xrefs 等)が目的の場合のみ imports/strings/xrefs に切り替える。

Ghidra解析

bash tools/ghidra-headless/ghidra.sh analyze <binary>                         # フル解析(推奨)
bash tools/ghidra-headless/ghidra.sh analyze --processor ARM:LE:32:v8T <bin>  # ARM Thumb強制
bash tools/ghidra-headless/ghidra.sh info <binary>                            # アーキテクチャ/セクション
bash tools/ghidra-headless/ghidra.sh decompile <binary>                       # C疑似コード
bash tools/ghidra-headless/ghidra.sh functions <binary>                       # 関数一覧
bash tools/ghidra-headless/ghidra.sh strings <binary>                         # 文字列+xref
bash tools/ghidra-headless/ghidra.sh imports <binary>                         # インポート(不審APIフラグ)
bash tools/ghidra-headless/ghidra.sh exports <binary>                         # エクスポート
bash tools/ghidra-headless/ghidra.sh xrefs <binary>                           # クロスリファレンス

ポスト解析

bash tools/ghidra-headless/ghidra.sh pe-triage <binary>       # PEトリアージ(pefile + DiE)
bash tools/ghidra-headless/ghidra.sh floss <binary>           # FLOSS難読化文字列解除(stack/decoded strings)
bash tools/ghidra-headless/ghidra.sh viz <binary>             # バイナリ可視化(エントロピー+bigram PNG)
bash tools/ghidra-headless/ghidra.sh office-analyze <file>    # Officeマクロ解析(VBA/OLE, oletools)
bash tools/ghidra-headless/ghidra.sh yara-scan <binary>       # YARAスキャン(APT帰属/ファミリ判定)
bash tools/ghidra-headless/ghidra.sh capa <binary>            # CAPA(capability+ATT&CKマッピング)
bash tools/ghidra-headless/ghidra.sh ioc-extract <binary>     # IOC自動抽出(IP/Domain/URL/Hash等)
bash tools/ghidra-headless/ghidra.sh classify <binary>                  # マルウェア種別自動分類
bash tools/ghidra-headless/ghidra.sh maldev-detect <binary>             # オペレータ手法検出(精密、analyze-full 後)
bash tools/ghidra-headless/ghidra.sh maldev-detect scan-binary <path>   # 生バイナリ直接スキャン(Ghidra 不要・5秒)
bash tools/ghidra-headless/ghidra.sh maldev-detect list                 # 検出可能 15 テクニックのカタログ
bash tools/ghidra-headless/ghidra.sh pe-fallback-extract <binary>       # Ghidra非依存のstrings/imports抽出(IOC/分類のfallback入力)
bash tools/ghidra-headless/ghidra.sh analyze-full <binary>              # フルパイプライン(Phase 0-7)
bash tools/ghidra-headless/ghidra.sh analyze-full --zip-password PW <file.zip>  # ZIPアーカイブ対応(container内展開)

maldev-detect の使い分け:

  • maldev-detect <binary> — analyze-full 後の精密検出(imports / strings / decompiled C をすべて使う)
  • maldev-detect scan-binary <path> — サンプル受領直後の即時トリアージ(Ghidra 待たない、5 秒以内)
  • maldev-detect list — 15 テクニックの ATT&CK マッピングを確認
  • 共通フラグ: --min-severity high / --json-only

f00crew 0x33 系のオペレータ手法を検出(実装は 15 テクニック = PEB walking / ROR13 hash / FNV-1a/djb2 hash / Process Hollowing / Early Bird APC / NtCreateThreadEx / Reflective DLL / Module Stomping / kernel callback / DKOM token-steal / Driver self-hide / Direct syscall(Hell's Gate) / multi-layer crypto / inline AES / IAT hooking)。出力は tools/ghidra-headless/output/<binary>_maldev.json に severity / confidence / 証拠 / ATT&CK を記録。同数の YARA ルール(yara-rules/custom/maldev_techniques.yar、15 ルール)と相補的。

AdaptixC2 ビーコン専用(KB-22 参照)

bash tools/ghidra-headless/ghidra.sh adaptix-profile <binary|file.enc.gz>     # 埋込 RC4 profile を抽出して JSON 出力(C2 URL/UA/Beacon-ID パラメータ等を取得)
bash tools/ghidra-headless/ghidra.sh adaptix-hash-match <binary|file.enc.gz>  # decompile 内のハッシュ定数 → API 名 にマップ(要 analyze/decompile 先行)

出力: output/<binary>_profile.json / output/<binary>_api_hashes.csv

.NETバイナリ

bash tools/ghidra-headless/ghidra.sh dotnet-decompile <binary|file.enc.gz>    # C#ソースへデコンパイル
bash tools/ghidra-headless/ghidra.sh dotnet-metadata <binary|file.enc.gz>     # アセンブリメタデータ
bash tools/ghidra-headless/ghidra.sh dotnet-types <binary|file.enc.gz>        # 型/クラス一覧

出力先: tools/dotnet-decompiler/output/<binary_name>/

  • Source/ — C# ソース(ILSpy デコンパイル結果、*.cs ファイル群)
  • metadata.json — アセンブリメタデータ(dotnet-metadata の出力)
  • types.txt — 型/クラス一覧(dotnet-types の出力)

出力読み取り(MSYS変換回避、必ずこれを使う)

bash tools/ghidra-headless/ghidra.sh output ls "sample*"
bash tools/ghidra-headless/ghidra.sh output cat sample_info.txt
bash tools/ghidra-headless/ghidra.sh output head sample_decompiled.c 100
bash tools/ghidra-headless/ghidra.sh output grep "connect" sample_strings.txt

重要: docker exec ghidra-headless cat ... 直接実行はMSYSパス変換で失敗する。

analyze-full パイプライン

Phase 0: PE Triage(コンテナ内、数秒)→ Verdict で戦略調整
Phase 1: FLOSS(コンテナ内)→ stack strings / decoded strings 抽出(XOR/難読化解除)
Phase 2: Binary Visualization(コンテナ内)→ エントロピープロファイル + bigram PNG
Phase 2b: Office Document(自動検出時のみ)→ oletools: VBA macro / auto-exec 分析
Phase 3: YARA Scan(コンテナ内)
Phase 4: CAPA Analysis(コンテナ内)
Phase 5: Ghidra Analysis(コンテナ内、デコンパイル含む)
Phase 6: IOC Extraction(ホスト、Ghidra 出力をパース)
Phase 7: Malware Classification(ホスト、IOC + 文字列から分類)

実装はシーケンシャル(Phase 0→7)。各 Phase は "non-critical, continuing" で続行するため一部失敗しても他は完走する。Ghidra Analysis は Phase 5 のため FLOSS/YARA/CAPA より遅れて完了する → ユーザー報告は段階的に。

Phase 5 失敗時の自動フォールバック(KB-24): Ghidra スクリプトが失敗すると pe_fallback_extract.py が自動実行され、pefile ベースで _pe_strings.txt / _pe_imports.txt を生成する。これにより Phase 6 (IOC) / Phase 7 (分類) は Ghidra 非依存で続行可能。

ZIP パスワード付きアーカイブ対応: analyze-full --zip-password infected sample.zip でコンテナ内 7z 展開 → 解析。展開後は最大サイズのファイルを自動選択。

watchtowr-report / reviewer は analyze-full のパイプライン外(shell から skill を自動呼び出しできないため)。ただし analyze-full 完了時に「Next step (manual)」セクションを表示し、watchtowr-report への入力アーティファクトのフルパスを列挙するため、そのまま skill 呼び出しに渡せる。reviewer 系は report 生成後に別途依頼。

Phase 0 は analyze-full が内包する — analyze-full を打つなら事前の pe-triage 単独実行は不要。

pe-triage を単独で先打ちすべきケース(analyze-full の前に Verdict 先読み):

  • 大サイズ (50MB+) or 低インポート数 (10 DLL 未満) でパッカー疑惑濃厚 → 数分の analyze-full を走らせる前に打ち切り判断
  • 迷ったら(未知検体・事前情報なしの場合を含む)analyze-full 直行で OK

analyze-full 中の PACKER_DETECTED 挙動: パイプラインに自動中断ロジックは無く、PACKER_DETECTED が出ても Phase 1〜5(YARA / CAPA / Ghidra / IOC / 分類)は すべて完走する(各ステップは "non-critical, continuing" で続行)。Phase 0 の <binary>_triage.json を読んで verdict == PACKER_DETECTED:* の場合、ユーザー側で Phase 1 以降の出力を見て ROI 低と判断したら malware-sandbox に切り替える。

YARA/CAPA は Ghidra 解析とは独立(いずれもコンテナ内実行)。先に完了したら即ユーザーへ 中間報告 すること:

  • YARA 完了 → ファミリ名・ルール一致数を報告
  • CAPA 完了 → 主要 ATT&CK TTP(Top 5-10)を報告
  • Ghidra 完了後 → IOC / 分類と統合して最終レポートへ

.NET 判別(最優先分岐)

Ghidra でデコンパイルする前に .NET バイナリかチェック。3つのシグナルのいずれかで判定:

シグナル取得方法
VT タグassembly / msil / dotnet
info 出力セクションに CLR / CLI Stream
CAPAバックエンド dotnet(ghidra.sh capa が .NET バイナリを自動判定 — 追加フラグ不要)

判別タイミング: pe-triage は PE パッカー検出のみで .NET 判定はしない(CLI Stream シグナルは出ない)。事前情報なしの検体は ghidra.sh info <binary> を 1 回打って CLI Stream の有無を確認 → .NET なら dotnet-decompile、通常 PE なら analyze-full に分岐。VT タグで事前に .NET と分かっていれば pe-triage すらスキップして直接 dotnet-decompile でよい。

.NET 確定 → ghidra.sh decompile はスキップし ghidra.sh dotnet-decompile <binary> を使う(Ghidra のデコンパイラは CLR を認識できない)。

構成: tools/dotnet-decompiler/dotnet-decompile.exe(Go ラッパー)が docker compose 経由で dotnet-decompiler コンテナを起動し、コンテナ内で ILSpy CLI (ilspycmd 11.0) を実行する。.enc.gz はコンテナ内で decrypt_quarantine.py により復号 → ILSpy 解析 → output volume (./output) でホストに回収。

初回セットアップ:

# 1. Go ラッパーをビルド (必須、CLAUDE.md ルール: -trimpath 必須)
cd tools/dotnet-decompiler && go build -trimpath -ldflags="-s -w" -o dotnet-decompile.exe .

# 2. Docker イメージをビルド (image 未ビルドの環境のみ、約 1.22GB / 5-10分)
docker compose -f tools/dotnet-decompiler/docker-compose.yml up -d --build

Docker image はホスト全体 (daemon 単位) で共有される — 別 repo (例: life repo) で同じ basename dotnet-decompiler/ から既にビルド済みなら image (dotnet-decompiler-dotnet-decompiler:latest) を再利用できるので Step 2 はスキップ可。先に tools/dotnet-decompiler/dotnet-decompile.exe preflight を打って Docker daemon / Container / ilspycmd / QUARANTINE_PASSWORD が全 OK ならビルド不要。

稼働確認: tools/dotnet-decompiler/dotnet-decompile.exe preflight(停止中なら dotnet-decompile.exe 自体が ensureRunning で自動 up) 不在時のエラー: Error: dotnet-decompile.exe not found. Build with: cd tools/dotnet-decompiler && go build -trimpath -ldflags="-s -w" -o dotnet-decompile.exe .

.NET でも pe-triage / yara-scan / capa は有効: .NET バイナリは PE ヘッダを持つので、ConfuserEx / Costura / SmartAssembly 等の .NET パッカー検出は pe-triage で可能。YARA/CAPA も .NET に対応(CAPA は dotnet バックエンドを使う)。

.NET では analyze-full を使わない: analyze-full の Phase 1 には Ghidra analyze が含まれるが CLR は解析できず Ghidra 出力は無意味になる。.NET では個別コマンド(pe-triage → yara-scan + capa + dotnet-decompile + dotnet-metadata + dotnet-types を並列)→ 最後に watchtowr-report スキルで統合、という流れにする。

並列実行手段: Claude Code では Agent tool を使って subagent を 1 メッセージ内で複数 dispatch するのが推奨(独立コマンドは並列実行される)。手動の bash 実行なら別ターミナル or & でバックグラウンド化。

Ghidra コマンドの並列実行は OK(KB-23): ghidra.sh の run_headless は per-invocation で project name に PID + nano-second suffix を付与するので、yara-scan / capa / imports / strings 等の同時実行で LockException: Unable to lock project! /analysis/projects/tmp_project は出ない。古いプロジェクトは -deleteProject で自動削除される。

Go バイナリ解析

Go バイナリは標準 Ghidra 解析で strings/imports が極端に少なくなる(48MB バイナリで 374 文字列のみ等)。Go が文字列を PE string table ではなく独自のシンボルテーブル (gopclntab) に格納するため。

検出方法

  • pe_triage.py: .symtab / .gopclntab セクション、\xff Go build ID: マーカー
  • DiE: "Go" コンパイラ検出
  • 48MB+ の Windows EXE でインポートが極少(KERNEL32 + MSVCRT のみ等) → Go の可能性大

推奨ワークフロー

  1. pe-triage で Go 検出 → analyze-full を実行するが strings/imports 結果は参考程度
  2. Docker コンテナ内で raw strings 抽出(IOC 発見の主力):
    bash tools/ghidra-headless/ghidra.sh decrypt <file.enc.gz>
    docker exec ghidra-headless strings -n 8 /tmp/<binary> | grep -iE "http|api\.telegram|sql|vmware|Processor|Stealer"
  3. Go シンボルから構造体・メソッド名を抽出(main.*Processor, main.*SendTo* 等)
  4. YARA / CAPA は Go バイナリでも有効(PE ヘッダは存在する)
  5. Ghidra decompile は Go ランタイムのノイズが大きいため、xref の多い関数に絞る

Go Stealer の典型パターン

  • エクスポートに _cgo_dummy_export / go*CB / *Trampoline → CGo 使用
  • *Processor 型(ChromeBasedProcessor 等)→ モジュール式 Stealer
  • api.telegram.org/bot%s/%s → Telegram Bot API exfil
  • SELECT host_key, name, path, encrypted_value → Cookie/パスワード窃取 SQL

解析起点の選択

起点状況最初のコマンド
A. 気になるAPIVT/サンドボックスでAPI判明imports → xrefs追跡
B. 特定の文字列C2ドメイン等の手がかりstrings → xrefs追跡
C. 動的解析の補完挙動把握済み、詳細知りたいdecompile(特定関数)
D. 手がかりなし未知検体info → imports → strings → functions → xrefs → decompile

A-C該当時はショートカット。Dの場合のみ標準フローを使用。

.enc.gz ファイルの扱い

全コマンドが .enc.gz を直接受け付ける。 対象: pe-triage / info / analyze / analyze-full / decompile / functions / strings / imports / exports / xrefs / yara-scan / capa / ioc-extract / classify / adaptix-profile / adaptix-hash-match / dotnet-decompile / dotnet-metadata / dotnet-types。ghidra.sh が自動で復号→解析→復号済み削除。

pe-triage の .enc.gz は in-container 経路に自動切替(KB-22): 過去にホスト側 Python に渡す経路で OSError: [Errno 22] Invalid argument: 'C:\\Users\\...\\Temp\\tmp.XXX\\...' という MSYS パス変換バグがあった。.enc.gz を渡すと自動的に「コンテナ内で復号→コンテナ内で pe_triage.py 実行→結果のみ docker cp」のフローに切り替わる。

bash tools/ghidra-headless/ghidra.sh analyze "tools/malware-fetch/Quarantine/<domain>/<ts>/<file>.enc.gz"

禁止(繰り返し指摘済み、絶対厳守):

  • decrypt_quarantine.py をホストで実行禁止
  • openssl/gunzip/python3 -c でホスト復号禁止
  • docker cp で復号済みバイナリをホストにコピー禁止

quarantine CLIツール

tools/quarantine/quarantine.exe list              # 隔離エントリ一覧
tools/quarantine/quarantine.exe info 1            # 詳細(番号 or ドメイン部分一致)
tools/quarantine/quarantine.exe check             # Ghidraコンテナ準備状況
tools/quarantine/quarantine.exe analyze 1         # 復号+Ghidra解析

analyze N が No encrypted files to analyze. を返した場合: そのエントリに .enc.gz バイナリが存在しない(平文ファイルのみ)。quarantine.exe info N でパスを確認し別エントリを選択する。平文 JS/HTML は ghidra-headless のスコープ外 → malware-fetch の js_deobfuscate.py 等を使う。

出力先

種別パス
Ghidra結果tools/ghidra-headless/output/<binary>_<種別>.txt/.c
PE Triage<binary>_triage.json
PE Fallback<binary>_pe_strings.txt, <binary>_pe_imports.txt
YARA<binary>_yara.json
CAPA<binary>_capa.json
IOC<binary>_iocs.json
分類<binary>_classification.json
.NETtools/dotnet-decompiler/output/<binary>/
ログtools/ghidra-headless/logs/YYYYMMDD_<target>.md

セットアップ(初回のみ)

# 検体に触るツール(pe-triage / yara-scan / capa / floss / pe-fallback-extract)は
# すべてコンテナ内で動く。ホストへの pip install は不要(capa/FLOSS/YARA/pefile は
# Dockerfile でピン止め済み: flare-capa 9.4.0 / flare-floss 3.1.1 + capa ルール同梱)
bash tools/ghidra-headless/ghidra.sh start        # Ghidraコンテナ初回ビルド(Ghidra 12.1.3 + Jython 拡張)
# .NET 解析を使うなら:
cd tools/dotnet-decompiler && go build -trimpath -ldflags="-s -w" -o dotnet-decompile.exe .
# Docker image — 別 repo で同じ basename `dotnet-decompiler/` から既にビルド済みなら image はホスト共有なのでスキップ可:
docker compose -f tools/dotnet-decompiler/docker-compose.yml up -d --build
# 状態確認 (image / container / ilspycmd / .env が全て OK なら build 不要):
tools/dotnet-decompiler/dotnet-decompile.exe preflight

Knowledge Base

KB-1〜KB-18, KB-22-23 → references/kb-entries.md(KB-19/20/21 は現状欠番)

KB内容
1-3特化解析手順(InfoStealer/Ransomware/RAT)
4-5マルウェアファミリ(MetaStealer・Teddy/StealC v2)
6-7パッカー/ドロッパー(VMProtect・Etset/UPX)
8Go製バイナリ解析パターン
9UPXドロッパー→動的→再解析パイプライン
10decompile_all.py制限事項
11Mergen Devirtualization連携
12全既知問題(bind mount/Python deps/MSYS path等)
13-14マルウェアパターン(.NET Loader/Go Dropper+DDR)
15.enc.gz yara-scan/capa自動復号
16.NETバイナリ解析ガイド
17Ghidraデコンパイラ権限エラー修正
18.NETパイプライン改善
22AdaptixC2 beacon 解析パターン(C++ Connector/HTTP RTTI / DJB2 variant hash seed=0x624 / RC4 profile / Pack=BE & Unpack=LE 非対称 / 動的 API 解決ビーコンには CAPA が無効)
23Ghidra プロジェクトロック(per-invocation suffix 化済 → 並列実行 OK)と pe-triage .enc.gz の MSYS パスバグ → in-container 自動切替
24Ghidra スクリプト陳腐化問題: scripts/ を volume mount して即時反映。Phase 5 失敗時は pe_fallback_extract.py が自動生成する _pe_strings.txt / _pe_imports.txt で IOC/分類が続行。YARA 出力は /analysis/output/ にもコピーし output ls で参照可能に。ZIP は --zip-password で container 内 7z 展開。
25MSI/DLLサイドローディング解析パターン (Beagle Campaign 2026): pe_triage.py が MSI を検出→"MSI_INSTALLER" verdict。analyze-full は MSI を 7z 展開→内包 PE を個別 YARA/CAPA→最大 PE を Ghidra 解析。msi_extract.py で OLE テーブルパース(File Table / CustomAction / ProductName)。Delphi/FMX バイナリは RTTI (FMX.Controls.*, TMethodImplementationIntercept) から内部構造復元可能。HTML Content Padding (> 5MB .text + HTML tags) は YARA を完全回避するため RTTI/import ベース検出が必要。DoH URL (cloudflare-dns.com/dns-query 等) がバイナリ内にある場合は sandbox.sh capture-c2 を使用(FakeNet DNS listener 無効)。

コスト閾値

指標閾値推奨
関数数5000超imports/strings/xrefsで特定→個別decompile
サイズ50MB超個別コマンドで必要関数のみ
decompile時間10分超/関数難読化→malware-sandbox検討
strings90%以上暗号化動的解析エスカレーション
imports10 DLL未満動的API解決の可能性

エスカレーション・IOC活用・Radare2併用 → references/advanced-analysis.md レポート執筆ガイド → references/report-guide.md

関連スキル

malware-fetch(バイナリ取得) / forensic-analysis(不審EXE深掘り) / memory-forensics(malfindダンプ) / kali-pentest(CTF/r2トリアージ) / malware-sandbox(パック検体動的解析) / mergen(VMProtect除去) / watchtowr-report(レポート生成)

標準化ツール(bb-toolkit 連携)

ツール用途
tools/ghidra-headless/scripts/lnk-parser.pyLNK構造パース(パディング難読化検出、埋込PE/PDF抽出、MachineID 取得)。pylnk3 は ansi encoding バグで使えないので必ずこちらを使う
tools/ghidra-headless/scripts/pe-encrypt.pyGhidra コンテナ内ファイル → quarantine .enc.gz 形式 (AES-256-CBC + gzip)。ホスト経由で VM に渡す時の標準手段
tools/ghidra-headless/scripts/chunk-extract.pyPE .rdata から RVA+size 指定で埋込バイナリ抽出 (entropy/magic付き)。Rust/Go マルウェアの DAT_xxx 展開用
tools/ghidra-headless/scripts/adaptix_profile_extract.py (Python)AdaptixC2 beacon 内蔵 profile を抽出し RC4 復号。ghidra.sh adaptix-profile 経由で呼び出される。--profile-rva / --profile-size で getProfile() の指す RVA とサイズを上書き可(KB-22)
tools/ghidra-headless/scripts/adaptix_hash_match.py (Python)AdaptixC2 の動的 API 解決ハッシュ → API 名にマップ(FUN_1400111a1(handle, 0x...) パターンを抽出)。バンドル済 adaptix_apidefines.h (GPL-3.0 snapshot) と照合
tools/bb-toolkit/go/bb-gcs-enum (Go)GCS 公開バケット全列挙 + ダウンロード (LOLCloud 偵察)

落とし穴(2026-04-19 セッションで判明)

  • BusyBox strings は -e l 非対応: Alpine ベースの ghidra-headless コンテナで UTF-16LE 文字列抽出したい場合、python3 -c "..." で直接デコードするか apk add binutils で GNU strings を入れる
  • unzip は AES-256 (PKv5.1) 非対応: MalwareBazaar 配布 ZIP は AES-256 なので必ず 7z x -pinfected を使う(コンテナに既存)
  • docker cp で MSYS パス変換: ホスト → コンテナの /tmp/... 指定時、MSYS_NO_PATHCONV=1 プレフィックスを付ける
  • Windows ドライブパス (C:\...) の扱い: bash tools/ghidra-headless/ghidra.sh <cmd> C:\malware\x.exe のように ghidra.sh 経由で渡す分には内部で変換済みで問題なく通る。docker exec / docker cp に直接渡す時だけ MSYS 変換で失敗するので、出力参照は必ず ghidra.sh output <subcmd> を使う
  • yara-scan / capa / floss / pe-triage / pe-fallback-extract はコンテナ内実行: ホストパス・.enc.gz・.zip・コンテナ内絶対パス(/tmp/... /analysis/...)のいずれも直接渡せる。復号済みバイナリがホストに出ることはない(CLAUDE.md 準拠)
  • Sleep(大きな数値) は単位要注意: Rust の Duration::from_nanos(800_000_000) は 0.8 秒。静的解析で見た数値を秒単位と誤読しない。ProcMon の Process Start→Exit で実時間確認
  • VMware 単一キー検知の典型: HKLM\SOFTWARE\VMware, Inc.\VMware Tools RegOpenKey → 存在で即 exit する Rust マルウェアが多い。動的解析で 1 秒以内に exit するなら VM 検知を疑う
  • Ghidra 12.1 の Debugger-agent-x64dbg は headless から使えない: TraceRmi ベースのデバッガ連携は GUI 前提で、HeadlessAnalyzer は GhidraState(null, …) を組み立てるため Debugger の tool が存在しない。x64dbg 連携が要る場面は静的側ではなく malware-sandbox 側で扱う(tools/malware-sandbox/x64dbg_driver.py。malware-sandbox スキルの「x64dbg 自動制御」節)
  • Jython は 12.1 から opt-in Extension: GP-6754 で同梱をやめ、GP-6826 で support/jythonRun も削除された。本 repo の Dockerfile は拡張を明示インストール済みなので scripts/*.py(Jython)はそのまま動くが、素の公式イメージに差し替えると全ポストスクリプトが黙って動かなくなる。なお Jython は実行のたび scripts/ghidra_common$py.class を bind mount 側に再生成する(.gitignore 済み)

注意

  • タイムアウト: 5分/ファイル、MAXMEM=4G
  • プロジェクトDBは毎回削除(-deleteProject)
  • 大バイナリ(>50MB)はdecompile_all非推奨

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.