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는 수동 및 능동 서브도메인 탐지, 웹 취약점 검사(예: 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-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)).
- **웹 스크래핑**: 수동 URL 소스 및 라이브 웹 메타데이터에서 서브도메인 추출([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 감지**: 웹 애플리케이션 방화벽 감지([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)로 발견된 host:port 쌍의 노출된 서비스 핑거프린팅.
- **서비스 취약점(선택 사항)**: 심층 포트스캔 프로필은 [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 대상을 선택적으로 열거 및 스캔.
### 웹 분석
- **웹 프로빙**: 표준 및 비표준 포트에서 라이브 웹 서버 감지([httpx](https://github.com/projectdiscovery/httpx)).
- **스크린샷**: 웹 페이지의 스크린샷 캡처([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)로 노출된 LLM 서비스에 대한 발견된 웹/API 엔드포인트 프로빙.
- **퍼징**: 디렉터리 및 매개변수 퍼징 수행([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-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 블록 스캔.
- **스캔 재개**: 마지막 완료 단계부터 스캔 재개.
- **사용자 지정 출력**: 사용자 정의 디렉터리에 결과 저장.
- **Diff 모드**: 후속 스캔에서 새로 발견된 항목 강조.
- **범위 필터링**: 범위 내 및 범위 외 목록 지원 ([inscope](https://github.com/tomnomnom/hacks/tree/master/inscope)).
- **알림**: Slack, Discord 또는 Telegram을 통해 알림 전송 ([notify](https://github.com/projectdiscovery/notify)).
- **결과 압축**: 결과 압축 및 전송.
- **Faraday 통합**: 보고용으로 [Faraday](https://github.com/infobyte/faraday)에 결과 내보내기.
- **AI 보고서 생성**: 로컬 AI 모델을 사용하여 보고서 생성 ([reconftw_ai](https://github.com/six2dez/reconftw_ai)).
- **빠른 재스캔 모드**: 새 자산이 발견되지 않으면 무거운 단계를 자동으로 건너뜀 (`--quick-rescan` / `QUICK_RESCAN`).
- **Hotlist 빌더**: 새 발견 사항을 기반으로 가장 위험한 자산을 점수화하고 강조 (`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 | 웹 분석, 퍼징, 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`로 설정하세요.
- 기존 설정이 있는 경우, 시스템 패키지를 건드리지 않고 Go 바이너리, pipx 패키지, 저장소를 새로 고치려면 `./install.sh --tools`를 실행하세요.
- 자세한 지침은 [설치 가이드](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
```
대상 목록의 경우, 목록 파일을 컨테이너에 바인딩하고 컨테이너 내부 경로를 참조하세요: ```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`를 전달하세요.
- 알림을 사용하는 경우 컨테이너 내부의 `~/.config/notify/provider-config.yaml`에 notify 구성을 마운트하세요.
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 릴리스를 계속 받게 됩니다.** 이는 의도된 설계입니다.
Go 바이너리는 `reconftw`이고, bash 진입점은 `reconftw.sh`입니다. 이 둘은 서로 덮어쓰지
않으므로 둘 다 유지하고 언제든지 전환할 수 있습니다.
현재 베타 버전은 **`v5.0.0-beta.1`**입니다. 이 버전은 `releases/latest`로 제공되지 않으므로
태그를 명시적으로 지정해야 합니다:```bash
curl -sSL "https://github.com/six2dez/reconftw/releases/download/v5.0.0-beta.1/reconftw_Linux_x86_64.tar.gz" | tar xz
sudo install -m 755 reconftw /usr/local/bin/reconftw
reconftw version
```
플랫폼에 맞는 자산을 [릴리스 페이지](https://github.com/six2dez/reconftw/releases/tag/v5.0.0-beta.1)에서 선택하세요 — `Darwin` 및 `arm64` 빌드, 정적 musl 빌드, `.deb`/`.rpm` 패키지가 모두 게시되어 있습니다.
- [**베타가 무엇이고, 무엇이 아닌지**](https://github.com/six2dez/reconftw/blob/main/docs/V2-BETA-ANNOUNCEMENT.md) — 아직 완료되지 않은 세 가지 항목을 포함합니다.
- [**문제 보고**](https://github.com/six2dez/reconftw/issues/new?template=v2-beta-feedback.md) — v2 베타 피드백 템플릿입니다. bash 릴리스의 버그는 여전히 일반 Bug report로 제출하세요.
## 🛠️ 문제 해결
- macOS의 Bash 4+: 스크립트는 Homebrew Bash에서 자동으로 재실행됩니다. Bash < 4 관련 메시지가 표시되면 `brew install bash`를 실행하고, 새 터미널을 연 후 `./install.sh`를 다시 실행하세요.
- macOS의 timeout: macOS는 `brew install coreutils`를 통해 `gtimeout`을 제공합니다. 스크립트는 이제 이를 자동으로 감지하여 사용합니다.
- 네트워크 문제: 설치 프로그램은 대부분의 명령 출력을 숨깁니다. 실패할 경우 `reconftw.cfg`에서 `upgrade_tools=true`로 재실행하거나, `./install.sh --tools`를 실행하거나, 누락된 도구를 수동으로 설치하세요(오류 메시지에 도구 이름이 표시됩니다).
- GOPATH 바이너리: 바이너리는 `/usr/local/bin`에 복사됩니다. 원하지 않으면 `~/go/bin`이 `PATH`에 포함되어 있는지 확인하세요.
- Nuclei 템플릿: 템플릿이 클론되지 않은 경우 `~/nuclei-templates`를 제거하고 `./install.sh`를 다시 실행하세요.
## 🔑 API 체크리스트 (선택 사항)
- `subfinder`: `~/.config/subfinder/provider-config.yaml`
- GitHub 토큰: `~/Tools/.github_tokens` (줄당 하나)
- GitLab 토큰: `~/Tools/.gitlab_tokens` (줄당 하나)
- WHOISXML: `reconftw.cfg` 또는 환경 변수에 `WHOISXML_API` 설정
- ASN 열거 (`asnmap`): 환경/설정에 `PDCP_API_KEY` 설정 (`ASN_ENUM`은 설정되지 않으면 건너뜀)
- Slack/Discord/Telegram: `~/.config/notify/provider-config.yaml`에서 `notify` 구성
- SSRF 서버: 사용 시 `COLLAB_SERVER` 환경 변수/설정
- Blind XSS 서버: 사용 시 `XSS_SERVER` 환경 변수/설정
## 💾 요구 사항
- 디스크: 10–20 GB 여유 공간 권장 (도구 체인 + 데이터)
- 네트워크: 설치 및 업데이트 중 안정적인 연결
- OS: Bash ≥ 4를 갖춘 Linux/macOS
- 추가: `make lint`/`make fmt`용 `shellcheck` 및 `shfmt` (선택 사항)
## ⚙️ 구성
`reconftw.cfg` 파일은 reconFTW의 전체 실행을 제어합니다. 세부적인 사용자 지정이 가능합니다:
- **도구 경로**: 도구, 리졸버, 워드리스트 경로 설정 (`tools`, `resolvers`, `fuzz_wordlist`).
- **API 키**: 환경 변수 또는 `secrets.cfg`를 통해 Shodan, WHOISXML 등의 키 구성 ([SECURITY.md](https://github.com/six2dez/reconftw/blob/main/SECURITY.md) 참조).
- **스캔 모드**: 모듈 활성화/비활성화 (예: `OSINT`, `SUBDOMAINS_GENERAL`, `VULNS_GENERAL`).
- **성능**: 스레드, 속도 제한, 타임아웃 조정 (예: `FFUF_THREADS`, `HTTPX_RATELIMIT`).
- **적응형 속도 제한**: 429/503 오류 시 자동 백오프 (`ADAPTIVE_RATE_LIMIT`, `MIN_RATE_LIMIT`, `MAX_RATE_LIMIT`).
- **증분 스캔**: 마지막 실행 이후의 새 발견 항목만 스캔 (`INCREMENTAL_MODE`).
- **알림**: Slack, Discord 또는 Telegram 알림 설정 (`NOTIFY_CONFIG`).
```
---
[Read more](https://github.com/six2dez/reconftw)