reconFTWは、ターゲットドメインに対して自動偵察を実行するために設計されたツールであり、最適なツール群を実行してスキャンを行い脆弱性を発見します。
<h1 align="center">
<br>
<a href="https://github.com/six2dez/reconftw"><img src="https://raw.githubusercontent.com/six2dez/reconftw/main/images/banner.png" alt="reconftw"></a>
<br>
reconFTW
<br>
</h1>
<p align="center">
<a href="https://github.com/six2dez/reconftw/releases/tag/v4.1"><img src="https://img.shields.io/badge/release-v4.1-2ea043?style=for-the-badge" alt="Release"></a>
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge" alt="License"></a>
<a href="https://github.com/six2dez/reconftw/issues?q=is%3Aissue+is%3Aclosed"><img src="https://img.shields.io/github/issues-closed-raw/six2dez/reconftw.svg?style=for-the-badge" alt="Closed Issues"></a>
<a href="https://discord.gg/R5DdXVEdTy"><img src="https://img.shields.io/discord/1048623782912340038.svg?style=for-the-badge&logo=discord&label=discord" alt="Discord"></a>
<a href="https://t.me/joinchat/H5bAaw3YbzzmI5co"><img src="https://img.shields.io/badge/telegram-@ReconFTW-26A5E4?style=for-the-badge&logo=telegram&logoColor=white" alt="Telegram"></a>
<a href="https://twitter.com/Six2dez1"><img src="https://img.shields.io/badge/twitter-@Six2dez1-1D9BF0?style=for-the-badge&logo=x&logoColor=white" alt="Twitter"></a>
</p>
<p align="center">
<a href="https://docs.reconftw.com"><img src="https://img.shields.io/badge/GitBook-%23000000.svg?style=for-the-badge&logo=gitbook&logoColor=white" alt="Docs"></a>
<a href="https://github.com/six2dez/reconftw"><img src="https://img.shields.io/badge/Bash%20Script-%23121011.svg?style=for-the-badge&logo=gnu-bash&logoColor=white" alt="Bash Script"></a>
<a href="https://github.com/six2dez/reconftw"><img src="https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black" alt="Linux"></a>
<a href="https://github.com/six2dez/reconftw"><img src="https://img.shields.io/badge/macOS-000000?style=for-the-badge&logo=macos&logoColor=F0F0F0" alt="macOS"></a>
<a href="https://github.com/six2dez/reconftw"><img src="https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge&logo=github&logoColor=white" alt="GitHub"></a>
</p>
<p align="center">
<a href="https://github.com/six2dez/reconftw/actions"><img src="https://img.shields.io/badge/github_actions-%232671E5.svg?style=for-the-badge&logo=githubactions&logoColor=white" alt="GitHub Actions"></a>
<a href="https://hub.docker.com/r/six2dez/reconftw"><img src="https://img.shields.io/badge/docker-%230db7ed.svg?style=for-the-badge&logo=docker&logoColor=white" alt="Docker"></a>
<a href="https://github.com/six2dez/reconftw/tree/main/Terraform"><img src="https://img.shields.io/badge/terraform-%23844FBA.svg?style=for-the-badge&logo=terraform&logoColor=white" alt="Terraform"></a>
<a href="https://github.com/six2dez/reconftw/tree/main/Terraform"><img src="https://img.shields.io/badge/ansible-%231A1918.svg?style=for-the-badge&logo=ansible&logoColor=white" alt="Ansible"></a>
<a href="https://github.com/six2dez/reconftw"><img src="https://img.shields.io/badge/Go-00ADD8.svg?style=for-the-badge&logo=go&logoColor=white" alt="Go"></a>
<a href="https://github.com/six2dez/reconftw"><img src="https://img.shields.io/badge/Python-3776AB.svg?style=for-the-badge&logo=python&logoColor=white" alt="Python"></a>
</p>
<p align="center">
<a href="https://www.buymeacoffee.com/six2dez"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black" alt="Buy Me a Coffee"></a>
<a href="https://github.com/sponsors/six2dez"><img src="https://img.shields.io/badge/sponsor-30363D?style=for-the-badge&logo=GitHub-Sponsors&logoColor=EA4AAA" alt="GitHub Sponsors"></a>
<a href="https://www.paypal.com/paypalme/six2dez"><img src="https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="PayPal"></a>
</p>
**reconFTW** は、セキュリティ研究者やペネトレーションテスター向けに設計された、強力な自動偵察ツールです。サブドメイン列挙、脆弱性スキャン、OSINTなどを実行し、ターゲットに関するインテリジェンス収集のプロセスを効率化します。モジュール設計、豊富な設定オプション、AX Frameworkによる分散スキャン対応を備えたreconFTWは、包括的な結果を効率的に提供するように構築されています。
reconFTWは、パッシブおよびアクティブなサブドメイン発見、Web脆弱性チェック(例:XSS、SSRF、SQLi)、OSINT、ディレクトリファジング、ポートスキャン、スクリーンショット取得など、幅広い技術を活用します。最先端のツールやAPIと統合してカバレッジと精度を最大化し、偵察活動において常に先手を打てるようにします。
**主な機能:**
- 包括的なサブドメイン列挙(パッシブ、ブルートフォース、順列、証明書透過性など)
- XSS、SSRF、SQLi、LFI、SSTIなどの脆弱性スキャン
- メール、メタデータ、APIリーク、サードパーティの設定ミスに対するOSINT
- AX Frameworkによる分散スキャンで高速実行
- 詳細な設定ファイルによるカスタマイズ可能なワークフロー
- レポート作成と可視化のためのFaradayとの統合
- Docker、Terraform、Ansibleデプロイメントのサポート
**免責事項:** 事前の同意なしにターゲットを攻撃するためのreconFTWの使用は違法です。適用されるすべての法律を遵守する責任はユーザーにあります。開発者は、このツールの誤用またはそれによって引き起こされた損害について一切の責任を負いません。責任を持って使用してください。
---
## 📔 目次
- [📔 目次](#-table-of-contents)
- [✨ 機能](#-features)
- [OSINT](#osint)
- [サブドメイン](#subdomains)
- [ホスト](#hosts)
- [Web分析](#web-analysis)
- [脆弱性チェック](#vulnerability-checks)
- [その他](#extras)
- [🏗️ アーキテクチャ](#️-architecture)
- [💿 インストール](#-installation)
- [ローカルインストール (PC/VPS/VM)](#local-installation-pcvpsvm)
- [Docker](#docker)
- [Terraform + Ansible](#terraform--ansible)
- [v2ベータ版(Goリライト)の試用](#trying-the-v2-beta-go-rewrite)
- [⚙️ 設定](#️-configuration)
- [🚀 使用方法](#-usage)
- [ターゲットオプション](#target-options)
- [モードオプション](#mode-options)
- [一般オプション](#general-options)
- [使用例](#example-usage)
- [☁️ AX Frameworkサポート(旧Axiom)](#️-ax-framework-support-previously-axiom)
- [💻 Faradayサポート](#-faraday-support)
- [🧠 AI統合](#-ai-integration)
- [🗂️ データ管理](#️-data-management)
- [Makefile](#makefile)
- [手動](#manual)
- [🧪 テスト](#-testing)
- [マインドマップ/ワークフロー](#mindmapworkflow)
- [サンプルビデオ](#sample-video)
- [🤝 貢献方法](#-how-to-contribute)
- [🔒 セキュリティ](#-security)
- [❓ ヘルプが必要ですか?](#-need-help)
- [💖 このプロジェクトを支援する](#-support-this-project)
- [🙏 謝辞](#-thanks)
- [📝 変更履歴](#-changelog)
- [🛠️ 開発](#️-development)
- [📜 ライセンス](#-license)
- [⭐ スター履歴](#-star-history)
---
## ✨ 機能
reconFTWには、偵察を徹底的かつ効率的に行うための機能が満載されています。以下は、スクリプトと設定の最新機能を反映した、その機能の詳細な内訳です。
### OSINT
- **ドメイン情報**: ドメイン登録詳細のWHOISルックアップ([whois](https://github.com/rfc1036/whois))。
- **メールおよびパスワードリーク**: 漏洩したメールと認証情報を検索([emailfinder](https://github.com/Josue87/EmailFinder) および [LeakSearch](https://github.com/JoelGMSec/LeakSearch))。
- **Microsoft 365/Azureマッピング**: Microsoft 365およびAzureテナントを識別([msftrecon](https://github.com/Arcanum-Sec/msftrecon))。
- **メタデータ抽出**: インデックス化されたOffice文書からメタデータを抽出([metagoofil](https://github.com/opsdisk/metagoofil))。
- **APIリーク**: 公開ソース内の露出したAPIを検出([porch-pirate](https://github.com/MandConsultingGroup/porch-pirate)、[SwaggerSpy](https://github.com/UndeadSec/SwaggerSpy)、[postleaksNg](https://github.com/six2dez/postleaksNG))。
- **Google Dorking**: 機密情報のための自動Google dorkクエリ([dorks_hunter](https://github.com/six2dez/dorks_hunter) および [xnldorker](https://github.com/xnl-h4ck3r/xnldorker))。
- **GitHub分析**: 選択可能なエンジンでGitHub組織のリポジトリとシークレットをスキャン([enumerepo](https://github.com/trickest/enumerepo)、[trufflehog](https://github.com/trufflesecurity/trufflehog)、[gitleaks](https://github.com/gitleaks/gitleaks)、[titus](https://github.com/praetorian-inc/titus)、[noseyparker](https://github.com/praetorian-inc/noseyparker))。
- **GitHub Actions監査(オプション)**: [gato](https://github.com/praetorian-inc/gato) でワークフローアーティファクトとCI/CD露出を監査。
- **サードパーティの設定ミス**: 設定ミスのあるサードパーティサービスを識別([misconfig-mapper](https://github.com/intigriti/misconfig-mapper))。
- **メール衛生**: SPF/DMARC設定をレビューし、スプーフィングや配信性の問題をフラグ付け。
- **クラウドストレージ列挙**: 露出のため主要プロバイダー間でバケットを調査([cloud_enum](https://github.com/initstring/cloud_enum))。
- **スプーフィング可能なドメイン**: スプーフィングに対して脆弱なドメインをチェック([spoofcheck](https://github.com/MattKeeley/Spoofy))。
### サブドメイン
- **パッシブ列挙**: サブドメイン発見にAPIと公開ソースを使用([subfinder](https://github.com/projectdiscovery/subfinder) および [github-subdomains](https://github.com/gwen001/github-subdomains))。
- **証明書透過性**: 証明書透過性ログを照会([crt](https://github.com/cemulus/crt))。
- **NOERROR発見**: DNS NOERROR応答を持つサブドメインを識別([dnsx](https://github.com/projectdiscovery/dnsx)、詳細は[こちら](https://www.securesystems.de/blog/enhancing-subdomain-enumeration-ents-and-noerror/))。
- **ブルートフォース**: カスタマイズ可能なワードリストでDNSブルートフォースを実行([puredns](https://github.com/d3mondev/puredns) およびカスタムワードリスト)。
- **順列**: AI、正規表現、ツールを使用してサブドメイン順列を生成(単一の順列エンジンとしての[Gotator](https://github.com/Josue87/gotator)、さらに[regulator](https://github.com/cramppet/regulator) と [subwiz](https://github.com/hadriansecurity/subwiz))。
- **Webスクレイピング**: パッシブURLソースとライブWebメタデータからサブドメインを抽出([urlfinder](https://github.com/projectdiscovery/urlfinder)、[waymore](https://github.com/xnl-h4ck3r/waymore)、[httpx](https://github.com/projectdiscovery/httpx)、[csprecon](https://github.com/edoardottt/csprecon))。
- **DNSレコード**: サブドメインのDNSレコードを解決([dnsx](https://github.com/projectdiscovery/dnsx))。
- **Google Analytics**: Analytics IDを介してサブドメインを識別([AnalyticsRelationships](https://github.com/Josue87/AnalyticsRelationships))。
- **TLSハンドシェイク**: TLSポートを介してサブドメインを発見([tlsx](https://github.com/projectdiscovery/tlsx))。
- **再帰的検索**: 再帰的なパッシブまたはブルートフォース列挙を組み合わせて実行([dsieve](https://github.com/trickest/dsieve))。
- **サブドメインテイクオーバー**: 脆弱なサブドメインを検出([nuclei](https://github.com/projectdiscovery/nuclei) および [dnstake](https://github.com/pwnesia/dnstake))。
- **DNSゾーン転送**: 設定ミスのあるDNSゾーン転送をチェック([dig](https://linux.die.net/man/1/dig))。
- **クラウドバケット**: 設定ミスのあるクラウドバケットと露出したストレージ資産を識別([S3Scanner](https://github.com/sa7mon/S3Scanner) および [cloud_enum](https://github.com/initstring/cloud_enum))。
- **クラウドカバレッジに関する注記**: CloudHunterをcloud_enumに置き換えた後、クラウドバケットチェックにはAlibaba OSSカバレッジは含まれなくなりました。
- **クラウド出力の移行**: レガシーの `cloudhunter_*` バケットアーティファクトは削除されました。代わりに `subdomains/cloud_enum_buckets_trufflehog.txt` を使用してください。
- **リバースIPルックアップ**: IP範囲を介してサブドメインを発見([hakip2host](https://github.com/hakluke/hakip2host))。
### ホスト
- **IP情報**: 地理位置情報とWHOISデータを取得([ipinfo](https://www.ipinfo.io/))。
- **CDN検出**: CDNの背後にあるIPを識別([cdncheck](https://github.com/projectdiscovery/cdncheck))。
- **WAF検出**: Webアプリケーションファイアウォールを検出([wafw00f](https://github.com/EnableSecurity/wafw00f))。
- **ポートスキャン**: [nmap](https://github.com/nmap/nmap) によるアクティブスキャン(オプションで[naabu](https://github.com/projectdiscovery/naabu) が先行)および [smap](https://github.com/s0md3v/Smap) によるパッシブスキャン。
- **サービスフィンガープリンティング**: [nerva](https://github.com/praetorian-inc/nerva) で発見されたホスト:ポートペア上の露出サービスをフィンガープリント。
- **サービス脆弱性(オプション)**: 詳細なポートスキャンプロファイルは、[vulners](https://github.com/vulnersCom/nmap-vulners) によるCVEマッチングで結果を強化できます。
- **パスワードスプレー**: エンジン選択で識別されたサービスに対してパスワードスプレーを試行([brutespray](https://github.com/x90skysn3k/brutespray) または [brutus](https://github.com/praetorian-inc/brutus))。
- **地理位置情報**: IPアドレスを地理的位置にマッピング([ipinfo](https://www.ipinfo.io/))。
- **IPv6発見**: `IPV6_SCAN` が有効な場合、発見されたIPv6ターゲットをオプションで列挙およびスキャン。
### Web分析
- **Webプロービング**: 標準および非標準ポートでライブWebサーバーを検出([httpx](https://github.com/projectdiscovery/httpx))。
- **スクリーンショット**: Webページのスクリーンショットをキャプチャ([nuclei](https://github.com/projectdiscovery/nuclei))。
- **仮想ホストファジング**: HTTPヘッダーをファジングして仮想ホストを識別([VhostFinder](https://github.com/wdahlenburg/VhostFinder))。
- **CMS検出**: コンテンツ管理システムを識別([CMSeeK](https://github.com/Tuhinshubhra/CMSeeK))。
- **URL抽出**: URLをパッシブおよびアクティブに収集([urlfinder](https://github.com/projectdiscovery/urlfinder)、[waymore](https://github.com/xnl-h4ck3r/waymore)、[katana](https://github.com/projectdiscovery/katana)、[github-endpoints](https://gist.github.com/six2dez/d1d516b606557526e9a78d7dd49cacd3)、[JSA](https://github.com/w9w/JSA))。
- **URLパターン分析**: パターンを使用してURLを分類([urless](https://github.com/xnl-h4ck3r/urless)、[gf](https://github.com/tomnomnom/gf)、[gf-patterns](https://github.com/1ndianl33t/Gf-Patterns))。
- **ファビコンテック偵察**: ファビコンハッシュからテクノロジーを識別([favirecon](https://github.com/edoardottt/favirecon))。
- **JavaScript分析**: JSファイルからシークレットとエンドポイントを抽出([subjs](https://github.com/lc/subjs)、[JSA](https://github.com/w9w/JSA)、[xnLinkFinder](https://github.com/xnl-h4ck3r/xnLinkFinder)、[getjswords](https://github.com/m4ll0k/BBTz)、[mantra](https://github.com/MrEmpy/mantra)、[jsluice](https://github.com/BishopFox/jsluice))。
- **ソースマップ抽出**: JavaScriptソースマップから機密データを取得([sourcemapper](https://github.com/denandz/sourcemapper))。
- **GraphQL検出**: nucleiでGraphQLエンドポイントを発見し、オプションで詳細なイントロスペクションを実行([GQLSpection](https://github.com/doyensec/GQLSpection))。
- **パラメータ発見**: エンドポイント上の隠しパラメータをブルートフォース([arjun](https://github.com/s0md3v/Arjun))。
- **WebSocket監査**: `ws://` および `wss://` エンドポイントでアップグレードハンドシェイクとオリジン処理を検証。
- **gRPCリフレクション**: 露出したサービスリフレクションのために一般的なgRPCポートをプローブ([grpcurl](https://github.com/fullstorydev/grpcurl))。
- **LLMサービスフィンガープリンティング(オプション)**: [julius](https://github.com/praetorian-inc/julius) で発見されたWeb/APIエンドポイントをプローブして、露出したLLMサービスを検出。
- **ファジング**: ディレクトリおよびパラメータファジングを実行([ffuf](https://github.com/ffuf/ffuf))。
- **ファイル拡張子ソート**: URLをファイル拡張子ごとに整理。
- **ワードリスト生成**: ファジング用のカスタムワードリストを作成。
- **パスワード辞書**: ライブコンテンツからパスワード辞書を生成([cewler](https://github.com/roys/cewler))。
- **IISショートネームスキャン**: IISショートネームの脆弱性を検出([shortscan](https://github.com/bitquark/shortscan))。
### 脆弱性チェック
- **CVE**: CVEおよび一般的な脆弱性をチェック [nuclei](https://github.com/projectdiscovery/nuclei)
- **Nuclei DAST**: 収集されたURLとGF候補に対して `nuclei -dast` テンプレートを実行し、追加のDASTカバレッジを提供。
- **XSS**: クロスサイトスクリプティング脆弱性をテスト([dalfox](https://github.com/hahwul/dalfox))。
- **SSL/TLS**: SSL/TLSの設定ミスをチェック([testssl](https://github.com/drwetter/testssl.sh))。
- **SSRF**: サーバーサイドリクエストフォージェリをテスト([interactsh](https://github.com/projectdiscovery/interactsh)、[ffuf](https://github.com/ffuf/ffuf) によるパラメータ値、およびオプションの代替プロトコルペイロード)。
- **CRLF**: CRLFインジェクションの脆弱性をチェック([crlfuzz](https://github.com/dwisiswant0/crlfuzz))。
- **LFI**: ファジングによるローカルファイルインクルージョンをテスト([ffuf](https://github.com/ffuf/ffuf))。
- **SSTI**: サーバーサイドテンプレートインジェクションを検出([TInjA](https://github.com/Hackmanit/TInjA))。
- **SQLi**: SQLインジェクションをテスト([SQLMap](https://github.com/sqlmapproject/sqlmap) および [ghauri](https://github.com/r0oth3x49/ghauri))。
- **壊れたリンク**: テイクオーバーされやすい可能性のある壊れたリンクと外部参照を識別([second-order](https://github.com/mhmdiaa/second-order))。
- **コマンドインジェクション**: コマンドインジェクションの脆弱性をテスト([commix](https://github.com/commixproject/commix))。
- **HTTPリクエストスマグリング**: リクエストスマグリングの脆弱性をチェック([smugglex](https://github.com/hahwul/smugglex))。
- **Webキャッシュ**: Webキャッシュの脆弱性を識別([Web-Cache-Vulnerability-Scanner](https://github.com/Hackmanit/Web-Cache-Vulnerability-Scanner) および [toxicache](https://github.com/xhzeem/toxicache))。
- **4XXバイパス**: 4XX応答のバイパスを試行([nomore403](https://github.com/devploit/nomore403))。
- **パラメータファジング**: 脆弱性のためにURLパラメータをファジング([nuclei](https://github.com/projectdiscovery/nuclei))。
### その他- **マルチスレッド**: パフォーマンスを最適化します([Interlace](https://github.com/codingo/Interlace))。
- **カスタムリゾルバ**: DNSリゾルバを生成します([dnsvalidator](https://github.com/vortexau/dnsvalidator))。
- **Dockerサポート**: [DockerHub](https://hub.docker.com/r/six2dez/reconftw)で公式Dockerイメージを提供。
- **AWSデプロイ**: TerraformとAnsibleでデプロイします。
- **IP/CIDRサポート**: IPレンジとCIDRブロックをスキャンします。
- **スキャン再開**: 最後に完了したステップからスキャンを再開します。
- **カスタム出力**: 結果をユーザー定義のディレクトリに保存します。
- **差分モード**: 後続のスキャンで新たな発見を強調表示します。
- **スコープフィルタリング**: スコープ内・スコープ外リストをサポートします([inscope](https://github.com/tomnomnom/hacks/tree/master/inscope))。
- **通知**: Slack、Discord、またはTelegramでアラートを送信します([notify](https://github.com/projectdiscovery/notify))。
- **結果のZIP圧縮**: 結果を圧縮して送信します。
- **Faraday統合**: レポート用に結果を[Faraday](https://github.com/infobyte/faraday)へエクスポートします。
- **AIレポート生成**: ローカルAIモデルを使用してレポートを生成します([reconftw_ai](https://github.com/six2dez/reconftw_ai))。
- **クイック再スキャンモード**: 新しいアセットが検出されない場合、重いステージを自動的にスキップします(`--quick-rescan` / `QUICK_RESCAN`)。
- **ホットリストビルダー**: 新たな発見に基づいて、最もリスクの高いアセットをスコアリングして強調表示します(`hotlist.txt`)。
- **コマンドトレース**: `SHOW_COMMANDS`を切り替えて、実行されたすべてのコマンドをデバッグ用にターゲットログへ記録します。
- **アセットストア**: `ASSET_STORE`が有効な場合、後続の自動化のために発見を`assets.jsonl`に追記します。
- **統合レポート**: スキャン終了時に`report/report.json`と`report/index.html`を自動生成します。
- **ARMサポート**: Raspberry PiおよびARMアーキテクチャ(MacOS MXを含む)と互換性があります。
- **ヘルスチェック**: `--health-check`による組み込みのシステムヘルスチェック(Dockerの`HEALTHCHECK`でも使用)。
- **インクリメンタルモード**: 前回の実行以降の新しい発見のみをスキャンします(`--incremental`)。
- **適応型レート制限**: 429/503エラー時に自動的にバックオフします(`--adaptive-rate`)。
- **構造化ログ**: 高度な分析用のオプションのJSONログ出力(`STRUCTURED_LOGGING`)。
- **入力サニタイズ**: コマンドインジェクションを防ぐため、すべてのユーザー入力をサニタイズします。
- **ドライラン(予行演習)モード**: コマンドを実行せずに、実行される内容をプレビューします(`--dry-run`)。
- **並列モード**: 独立した機能を並列実行してスキャンを高速化します(`--parallel`、`--no-parallel`で無効化)。
- **モジュラーアーキテクチャ**: 保守性を高めるため、コードベースを8つの専門モジュールに分割。
- **シークレット管理**: 環境変数、`secrets.cfg`、Dockerランタイムシークレット([SECURITY.md](https://github.com/six2dez/reconftw/blob/main/SECURITY.md)を参照)。
- **サーキットブレーカー**: スキャンのハングを防ぐため、繰り返し失敗したツールを自動的にスキップします。
- **チェックポイントシステム**: 最後に成功したフェーズから中断されたスキャンを再開します。
- **macOSネイティブサポート**: macOSとの完全な互換性(BSD coreutils、Homebrew Bash 4+)。
---
## 🏗️ アーキテクチャ
reconFTWはモジュラーアーキテクチャを使用しています。メインのエントリポイント(`reconftw.sh`)が引数の解析を処理し、`modules/`ディレクトリから8つの専門モジュールを読み込みます。
### ディレクトリ構成```
reconftw/
├── reconftw.sh # Entry point — arg parsing, module loading, dispatch
├── reconftw.cfg # Default configuration
├── install.sh # Installer
├── Makefile # Data management, lint, fmt, test targets
├── modules/
│ ├── core.sh # Lifecycle, logging, notifications, cleanup (1024 lines)
│ ├── modes.sh # Scan modes, argument parsing, help (902 lines)
│ ├── subdomains.sh # Subdomain enumeration (1938 lines)
│ ├── web.sh # Web analysis, fuzzing, JS checks (1712 lines)
│ ├── vulns.sh # Vulnerability scanning (926 lines)
│ ├── osint.sh # OSINT functions (500 lines)
│ ├── axiom.sh # Ax/Axiom fleet helpers (143 lines)
│ └── utils.sh # Utilities, sanitization, validation (508 lines)
├── tests/
│ ├── run_tests.sh # Test runner
│ ├── unit/ # bats-core unit tests
│ ├── integration/ # Integration tests
│ └── fixtures/ # Test data
├── Docker/
│ └── Dockerfile # Official Docker image
└── Terraform/ # AWS deployment
```
### モジュールリファレンス
| モジュール | 行数 | 目的 |
|--------|------:|---------|
| `core.sh` | 1024 | ライフサイクル管理、ロギング、通知、クリーンアップトラップ |
| `modes.sh` | 902 | スキャンモード定義、引数解析、ヘルプ出力 |
| `subdomains.sh` | 1938 | すべてのサブドメイン列挙関数 |
| `web.sh` | 1712 | Web解析、ファジング、JS解析、CMS検出 |
| `vulns.sh` | 926 | 脆弱性スキャン(XSS、SQLi、SSRFなど) |
| `osint.sh` | 500 | OSINT関数(WHOIS、メール、ドーク、メタデータ) |
| `utils.sh` | 508 | 共有ユーティリティ、入力サニタイズ、検証 |
| `axiom.sh` | 143 | Ax/Axiom分散フリート管理 |
`--source-only` フラグを使用すると、メインロジックを実行せずに `reconftw.sh` をソースとして読み込むことができ、個々の関数のユニットテストが可能になります。
---
## 💿 インストール
reconFTWは、さまざまな環境に適した複数のインストール方法をサポートしています。十分なディスク容量(推奨:最低10 GB)と安定したインターネット接続を確保してください。
### クイックスタート
1) クローンしてインストール```yaml
git clone https://github.com/six2dez/reconftw
cd reconftw
./install.sh --verbose
```
2) スキャンを実行する(フル+再開)```bash
./reconftw.sh -d example.com -r
```
3) 最小限の実行(パッシブのみのフットプリント)```bash
./reconftw.sh -d example.com -p
```
> ヒント: 後で `./install.sh --tools` を再実行すると、システムパッケージを再インストールせずにツールチェーンを更新できます。
### ローカルインストール(PC/VPS/VM)
1. **前提条件**:
- **Golang**: 最新バージョン(`reconftw.cfg` でデフォルトで `install_golang` が有効)。
- **システム権限**: root で実行していない場合は、プロンプトを回避するために sudo を設定します:
```bash
sudo echo "${USERNAME} ALL=(ALL:ALL) NOPASSWD: ALL" | sudo tee -a /etc/sudoers.d/reconFTW
```
2. **手順**: ```bash
git clone https://github.com/six2dez/reconftw
cd reconftw
./install.sh
./reconftw.sh -d target.com -r
```
3. **注意事項**:
- `install.sh` スクリプトは、依存関係、ツールのインストール、およびパスの設定(`GOROOT`、`GOPATH`、`PATH`)を行います。
- Golang がすでに設定されている場合は、`reconftw.cfg` で `install_golang=false` を設定してください。
- 既存のセットアップの場合、`./install.sh --tools` を実行すると、システムパッケージに触れることなく、Go バイナリ、pipx パッケージ、およびリポジトリを更新できます。
- 詳細な手順については、[インストールガイド](https://github.com/six2dez/reconftw/wiki/0.-Installation-Guide) を確認してください。
### Docker
1. **イメージをプルする**: ```bash
docker pull six2dez/reconftw:main
```
2. **コンテナを実行する**: ```bash
docker run -it --rm \
-v "${PWD}/OutputFolder/:/reconftw/Recon/" \
six2dez/reconftw:main -d example.com -r
```
For a list of targets, bind the list file into the container and reference the in-container path:
ターゲットのリストについては、リストファイルをコンテナにバインドし、コンテナ内のパスを参照します: ```bash
docker run -it --rm \
-v "${PWD}/domains.txt:/reconftw/domains.txt:ro" \
-v "${PWD}/OutputFolder/:/reconftw/Recon/" \
six2dez/reconftw:main -l /reconftw/domains.txt -r
```
3. **結果の表示**:
- 結果はホスト上の `OutputFolder` ディレクトリに保存されます(コンテナ内ではありません)。
4. **カスタマイズ**:
- Docker イメージを変更するか、独自のイメージをビルドします。詳細は [Docker ガイド](https://github.com/six2dez/reconftw/wiki/4.-Docker) を参照してください。
- カスタムビルドで Ax ツールをスキップするには、`--build-arg INSTALL_AXIOM=false` を渡します。
- 通知を使用する場合は、notify 設定をコンテナ内の `~/.config/notify/provider-config.yaml` にマウントします。
5. **実行時のシークレット**:
API キーとシークレットは環境変数を介して渡します。イメージに焼き込まないでください。 ```bash
docker run -it --rm \
-e SHODAN_API_KEY="your-key" \
-e PDCP_API_KEY="your-projectdiscovery-key" \
-e COLLAB_SERVER="your-server" \
-e XSS_SERVER="your-server" \
-v "${PWD}/OutputFolder/:/reconftw/Recon/" \
six2dez/reconftw:main -d example.com -r
```
See [SECURITY.md](https://github.com/six2dez/reconftw/blob/main/SECURITY.md) を参照して、シークレット管理の完全なガイダンスを確認してください。
6. **ヘルスチェック**:
Dockerイメージには、60秒ごとに `./reconftw.sh --health-check` を実行する組み込みの `HEALTHCHECK` が含まれています。手動で実行することもできます: ```bash
docker exec <container-id> ./reconftw.sh --health-check
```
### Terraform + Ansible
- Terraform と Ansible を使用して、AWS 上に reconFTW をデプロイします。
- セットアップ手順については、[Terraform/README.md](https://github.com/six2dez/reconftw/blob/main/Terraform/README.md) のガイドに従ってください。
---
## v2 ベータ版(Go による書き直し)を試す
reconFTW は Go で書き直されています。この書き直し版は**オプトインのプレリリース**として提供されます。これは
[リリースページ](https://github.com/six2dez/reconftw/releases) に掲載されており、GitHub は
`releases/latest` をプレリリースに指定することはありません。つまり、**何もしなければ、引き続き
bash リリースを利用できます。** これは意図的な設計です。
---
[Read more](https://github.com/six2dez/reconftw)