
reconFTW es una herramienta diseñada para realizar reconocimiento automatizado en un dominio objetivo ejecutando el mejor conjunto de herramientas para realizar escaneos y encontrar vulnerabilidades.
<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** es una potente herramienta automatizada de reconocimiento diseñada para investigadores de seguridad y pentesters. Agiliza el proceso de recopilación de inteligencia sobre un objetivo mediante la enumeración de subdominios, el escaneo de vulnerabilidades, OSINT y más. Con un diseño modular, amplias opciones de configuración y soporte para escaneo distribuido mediante AX Framework, reconFTW está construido para ofrecer resultados completos de manera eficiente.
reconFTW aprovecha una amplia gama de técnicas, incluido el descubrimiento de subdominios pasivo y activo, comprobaciones de vulnerabilidades web (p. ej., XSS, SSRF, SQLi), OSINT, fuzzing de directorios, escaneo de puertos y captura de pantallas. Se integra con herramientas y APIs de vanguardia para maximizar la cobertura y la precisión, garantizando que te mantengas a la vanguardia en tus esfuerzos de reconocimiento.
**Características clave:**
- Enumeración integral de subdominios (pasiva, fuerza bruta, permutaciones, transparencia de certificados, etc.)
- Escaneo de vulnerabilidades para XSS, SSRF, SQLi, LFI, SSTI y más
- OSINT para correos electrónicos, metadatos, fugas de APIs y configuraciones incorrectas de terceros
- Escaneo distribuido con AX Framework para una ejecución más rápida
- Flujos de trabajo personalizables con un archivo de configuración detallado
- Integración con Faraday para informes y visualización
- Soporte para despliegues con Docker, Terraform y Ansible
**Aviso legal:** El uso de reconFTW para atacar objetivos sin consentimiento previo es ilegal. Es responsabilidad del usuario cumplir todas las leyes aplicables. Los desarrolladores no asumen ninguna responsabilidad por el uso indebido o los daños causados por esta herramienta. Úsala de forma responsable.
---
## 📔 Tabla de Contenidos
- [📔 Tabla de Contenidos](#-tabla-de-contenidos)
- [✨ Características](#-características)
- [OSINT](#osint)
- [Subdominios](#subdominios)
- [Hosts](#hosts)
- [Análisis Web](#análisis-web)
- [Comprobaciones de Vulnerabilidades](#comprobaciones-de-vulnerabilidades)
- [Extras](#extras)
- [🏗️ Arquitectura](#️-arquitectura)
- [💿 Instalación](#-instalación)
- [Instalación Local (PC/VPS/VM)](#instalación-local-pcvpsvm)
- [Docker](#docker)
- [Terraform + Ansible](#terraform--ansible)
- [Probar la versión beta v2 (reescritura en Go)](#probar-la-versión-beta-v2-reescritura-en-go)
- [⚙️ Configuración](#️-configuración)
- [🚀 Uso](#-uso)
- [Opciones de Objetivo](#opciones-de-objetivo)
- [Opciones de Modo](#opciones-de-modo)
- [Opciones Generales](#opciones-generales)
- [Ejemplos de Uso](#ejemplos-de-uso)
- [☁️ Soporte de AX Framework (anteriormente Axiom)](#️-soporte-de-ax-framework-anteriormente-axiom)
- [💻 Soporte de Faraday](#-soporte-de-faraday)
- [🧠 Integración de IA](#-integración-de-ia)
- [🗂️ Gestión de Datos](#️-gestión-de-datos)
- [Makefile](#makefile)
- [Manual](#manual)
- [🧪 Pruebas](#-pruebas)
- [Mindmap/Flujo de trabajo](#mindmapflujo-de-trabajo)
- [Vídeo de muestra](#vídeo-de-muestra)
- [🤝 Cómo Contribuir](#-cómo-contribuir)
- [🔒 Seguridad](#-seguridad)
- [❓ ¿Necesitas Ayuda?](#-necesitas-ayuda)
- [💖 Apoya Este Proyecto](#-apoya-este-proyecto)
- [🙏 Agradecimientos](#-agradecimientos)
- [📝 Registro de Cambios](#-registro-de-cambios)
- [🛠️ Desarrollo](#️-desarrollo)
- [📜 Licencia](#-licencia)
- [⭐ Historial de Estrellas](#-historial-de-estrellas)
---
## ✨ Características
reconFTW está repleto de funciones para que el reconocimiento sea exhaustivo y eficiente. A continuación se muestra un desglose detallado de sus capacidades, actualizado para reflejar la funcionalidad más reciente del script y la configuración.
### OSINT
- **Información de Dominio**: Consulta WHOIS para obtener detalles de registro del dominio ([whois](https://github.com/rfc1036/whois)).
- **Fugas de Correos y Contraseñas**: Busca correos electrónicos y credenciales filtrados ([emailfinder](https://github.com/Josue87/EmailFinder) y [LeakSearch](https://github.com/JoelGMSec/LeakSearch)).
- **Mapeo de Microsoft 365/Azure**: Identifica inquilinos de Microsoft 365 y Azure ([msftrecon](https://github.com/Arcanum-Sec/msftrecon)).
- **Extracción de Metadatos**: Extrae metadatos de documentos de Office indexados ([metagoofil](https://github.com/opsdisk/metagoofil)).
- **Fugas de APIs**: Detecta APIs expuestas en fuentes públicas ([porch-pirate](https://github.com/MandConsultingGroup/porch-pirate), [SwaggerSpy](https://github.com/UndeadSec/SwaggerSpy) y [postleaksNg](https://github.com/six2dez/postleaksNG)).
- **Google Dorking**: Consultas automatizadas de Google dork para información sensible ([dorks_hunter](https://github.com/six2dez/dorks_hunter) y [xnldorker](https://github.com/xnl-h4ck3r/xnldorker)).
- **Análisis de GitHub**: Escanea organizaciones de GitHub en busca de repositorios y secretos con motores seleccionables ([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)).
- **Auditoría de GitHub Actions (Opcional)**: Audita artefactos de flujos de trabajo y exposición de CI/CD con [gato](https://github.com/praetorian-inc/gato).
- **Configuraciones Incorrectas de Terceros**: Identifica servicios de terceros mal configurados ([misconfig-mapper](https://github.com/intigriti/misconfig-mapper)).
- **Higiene de Correo**: Revisa la configuración de SPF/DMARC para señalar problemas de suplantación o entregabilidad.
- **Enumeración de Almacenamiento en la Nube**: Inspecciona buckets de los principales proveedores en busca de exposición ([cloud_enum](https://github.com/initstring/cloud_enum)).
- **Dominios Suplantables**: Comprueba dominios vulnerables a la suplantación ([spoofcheck](https://github.com/MattKeeley/Spoofy)).
### Subdominios
- **Enumeración Pasiva**: Utiliza APIs y fuentes públicas para el descubrimiento de subdominios ([subfinder](https://github.com/projectdiscovery/subfinder) y [github-subdomains](https://github.com/gwen001/github-subdomains)).
- **Transparencia de Certificados**: Consulta registros de transparencia de certificados ([crt](https://github.com/cemulus/crt)).
- **Descubrimiento NOERROR**: Identifica subdominios con respuestas DNS NOERROR ([dnsx](https://github.com/projectdiscovery/dnsx), más información [aquí](https://www.securesystems.de/blog/enhancing-subdomain-enumeration-ents-and-noerror/)).
- **Fuerza Bruta**: Realiza fuerza bruta DNS con listas de palabras personalizables ([puredns](https://github.com/d3mondev/puredns) y listas de palabras personalizadas).
- **Permutaciones**: Genera permutaciones de subdominios mediante IA, regex y herramientas ([Gotator](https://github.com/Josue87/gotator) como único motor de permutaciones, además de [regulator](https://github.com/cramppet/regulator) y [subwiz](https://github.com/hadriansecurity/subwiz)).
- **Web Scraping**: Extrae subdominios de fuentes de URLs pasivas y metadatos web en vivo ([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)).
- **Registros DNS**: Resuelve registros DNS de subdominios ([dnsx](https://github.com/projectdiscovery/dnsx)).
- **Google Analytics**: Identifica subdominios mediante IDs de Analytics ([AnalyticsRelationships](https://github.com/Josue87/AnalyticsRelationships)).
- **Handshake TLS**: Descubre subdominios mediante puertos TLS ([tlsx](https://github.com/projectdiscovery/tlsx)).
- **Búsqueda Recursiva**: Realiza enumeración recursiva pasiva o de fuerza bruta combinada ([dsieve](https://github.com/trickest/dsieve)).
- **Toma de Control de Subdominios**: Detecta subdominios vulnerables ([nuclei](https://github.com/projectdiscovery/nuclei) y [dnstake](https://github.com/pwnesia/dnstake)).
- **Transferencia de Zona DNS**: Comprueba transferencias de zona DNS mal configuradas ([dig](https://linux.die.net/man/1/dig)).
- **Buckets en la Nube**: Identifica buckets en la nube mal configurados y activos de almacenamiento expuestos ([S3Scanner](https://github.com/sa7mon/S3Scanner) y [cloud_enum](https://github.com/initstring/cloud_enum)).
- **Nota sobre Cobertura en la Nube**: Las comprobaciones de buckets en la nube ya no incluyen cobertura de Alibaba OSS tras reemplazar CloudHunter por cloud_enum.
- **Migración de Salida en la Nube**: Los artefactos heredados de buckets `cloudhunter_*` se eliminaron; usa `subdomains/cloud_enum_buckets_trufflehog.txt` en su lugar.
- **Búsqueda Inversa de IP**: Descubre subdominios mediante rangos de IP ([hakip2host](https://github.com/hakluke/hakip2host)).
### Hosts
- **Información de IP**: Recupera datos de geolocalización y WHOIS ([ipinfo](https://www.ipinfo.io/)).
- **Detección de CDN**: Identifica IPs detrás de CDNs ([cdncheck](https://github.com/projectdiscovery/cdncheck)).
- **Detección de WAF**: Detecta firewalls de aplicaciones web ([wafw00f](https://github.com/EnableSecurity/wafw00f)).
- **Escaneo de Puertos**: Escaneo activo con [nmap](https://github.com/nmap/nmap) (opcionalmente precedido por [naabu](https://github.com/projectdiscovery/naabu)) y escaneo pasivo con [smap](https://github.com/s0md3v/Smap).
- **Huella de Servicios**: Obtiene la huella de servicios expuestos en pares host:puerto descubiertos con [nerva](https://github.com/praetorian-inc/nerva).
- **Vulnerabilidades de Servicios (Opcional)**: El perfil de escaneo de puertos profundo puede enriquecer los resultados con coincidencias de CVE mediante [vulners](https://github.com/vulnersCom/nmap-vulners).
- **Password Spraying**: Intenta password spraying en servicios identificados con selección de motor ([brutespray](https://github.com/x90skysn3k/brutespray) o [brutus](https://github.com/praetorian-inc/brutus)).
- **Geolocalización**: Mapea direcciones IP a ubicaciones geográficas ([ipinfo](https://www.ipinfo.io/)).
- **Descubrimiento de IPv6**: Opcionalmente enumera y escanea objetivos IPv6 descubiertos cuando `IPV6_SCAN` está habilitado.
### Análisis Web
- **Sondeo Web**: Detecta servidores web en vivo en puertos estándar y poco comunes (([httpx](https://github.com/projectdiscovery/httpx))).
- **Capturas de Pantalla**: Captura capturas de pantalla de páginas web ([nuclei](https://github.com/projectdiscovery/nuclei)).
- **Fuzzing de Hosts Virtuales**: Identifica hosts virtuales mediante fuzzing de cabeceras HTTP ([VhostFinder](https://github.com/wdahlenburg/VhostFinder)).
- **Detección de CMS**: Identifica sistemas de gestión de contenidos ([CMSeeK](https://github.com/Tuhinshubhra/CMSeeK)).
- **Extracción de URLs**: Recopila URLs de forma pasiva y activa ([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) y [JSA](https://github.com/w9w/JSA)).
- **Análisis de Patrones de URL**: Clasifica URLs mediante patrones ([urless](https://github.com/xnl-h4ck3r/urless), [gf](https://github.com/tomnomnom/gf) y [gf-patterns](https://github.com/1ndianl33t/Gf-Patterns)).
- **Reconocimiento de Tecnología por Favicon**: Identifica tecnologías a partir de hashes de favicon ([favirecon](https://github.com/edoardottt/favirecon)).
- **Análisis de JavaScript**: Extrae secretos y endpoints de archivos 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)).
- **Extracción de Source Maps**: Recupera datos sensibles de source maps de JavaScript ([sourcemapper](https://github.com/denandz/sourcemapper)).
- **Detección de GraphQL**: Descubre endpoints de GraphQL con nuclei y opcionalmente realiza introspección en profundidad ([GQLSpection](https://github.com/doyensec/GQLSpection)).
- **Descubrimiento de Parámetros**: Fuerza bruta de parámetros ocultos en endpoints ([arjun](https://github.com/s0md3v/Arjun)).
- **Auditoría de WebSockets**: Valida handshakes de actualización y manejo de origen en endpoints `ws://` y `wss://`.
- **Reflexión gRPC**: Sondea puertos gRPC comunes en busca de reflexión de servicios expuesta ([grpcurl](https://github.com/fullstorydev/grpcurl)).
- **Huella de Servicios LLM (Opcional)**: Sondea endpoints web/API descubiertos en busca de servicios LLM expuestos con [julius](https://github.com/praetorian-inc/julius).
- **Fuzzing**: Realiza fuzzing de directorios y parámetros ([ffuf](https://github.com/ffuf/ffuf)).
- **Clasificación por Extensiones de Archivo**: Organiza URLs por extensiones de archivo.
- **Generación de Listas de Palabras**: Crea listas de palabras personalizadas para fuzzing.
- **Diccionario de Contraseñas**: Genera diccionarios de contraseñas a partir de contenido en vivo ([cewler](https://github.com/roys/cewler)).
- **Escaneo de Nombres Cortos IIS**: Detecta vulnerabilidades de nombres cortos IIS ([shortscan](https://github.com/bitquark/shortscan)).
### Comprobaciones de Vulnerabilidades
- **CVEs**: Comprueba CVEs y vulnerabilidades comunes [nuclei](https://github.com/projectdiscovery/nuclei)
- **Nuclei DAST**: Ejecuta plantillas `nuclei -dast` sobre URLs recopiladas y candidatos GF para cobertura DAST adicional.
- **XSS**: Prueba vulnerabilidades de cross-site scripting ([dalfox](https://github.com/hahwul/dalfox)).
- **SSL/TLS**: Comprueba configuraciones incorrectas de SSL/TLS ([testssl](https://github.com/drwetter/testssl.sh)).
- **SSRF**: Prueba server-side request forgery ([interactsh](https://github.com/projectdiscovery/interactsh), valores de parámetros con [ffuf](https://github.com/ffuf/ffuf), y payloads de protocolos alternativos opcionales).
- **CRLF**: Comprueba vulnerabilidades de inyección CRLF ([crlfuzz](https://github.com/dwisiswant0/crlfuzz)).
- **LFI**: Prueba inclusión local de archivos mediante fuzzing ([ffuf](https://github.com/ffuf/ffuf)).
- **SSTI**: Detecta inyección de plantillas del lado del servidor ([TInjA](https://github.com/Hackmanit/TInjA)).
- **SQLi**: Prueba inyección SQL ([SQLMap](https://github.com/sqlmapproject/sqlmap) y [ghauri](https://github.com/r0oth3x49/ghauri)).
- **Enlaces Rotos**: Identifica enlaces rotos y referencias externas propensas a toma de control ([second-order](https://github.com/mhmdiaa/second-order)).
- **Inyección de Comandos**: Prueba vulnerabilidades de inyección de comandos ([commix](https://github.com/commixproject/commix)).
- **HTTP Request Smuggling**: Comprueba vulnerabilidades de contrabando de solicitudes ([smugglex](https://github.com/hahwul/smugglex)).
- **Caché Web**: Identifica vulnerabilidades de caché web ([Web-Cache-Vulnerability-Scanner](https://github.com/Hackmanit/Web-Cache-Vulnerability-Scanner) y [toxicache](https://github.com/xhzeem/toxicache)).
- **Bypass de 4XX**: Intenta eludir respuestas 4XX ([nomore403](https://github.com/devploit/nomore403)).
- **Fuzzing de Parámetros**: Fuzzea parámetros de URL en busca de vulnerabilidades ([nuclei](https://github.com/projectdiscovery/nuclei)).
### Extras- **Multithreading**: Optimiza el rendimiento ([Interlace](https://github.com/codingo/Interlace)).
- **Resolvedores personalizados**: Genera resolvedores DNS ([dnsvalidator](https://github.com/vortexau/dnsvalidator)).
- **Soporte Docker**: Imagen oficial de Docker en [DockerHub](https://hub.docker.com/r/six2dez/reconftw).
- **Despliegue en AWS**: Se despliega mediante Terraform y Ansible.
- **Soporte IP/CIDR**: Escanea rangos de IP y bloques CIDR.
- **Reanudación de escaneos**: Reanuda escaneos desde el último paso completado.
- **Salida personalizada**: Guarda los resultados en un directorio definido por el usuario.
- **Modo Diff**: Destaca nuevos hallazgos en escaneos posteriores.
- **Filtrado de alcance**: Admite listas dentro y fuera del alcance ([inscope](https://github.com/tomnomnom/hacks/tree/master/inscope)).
- **Notificaciones**: Envía alertas mediante Slack, Discord o Telegram ([notify](https://github.com/projectdiscovery/notify)).
- **Compresión de resultados**: Comprime y envía los resultados.
- **Integración con Faraday**: Exporta resultados a [Faraday](https://github.com/infobyte/faraday) para informes .
- **Generación de informes con IA**: Genera informes usando modelos de IA locales ([reconftw_ai](https://github.com/six2dez/reconftw_ai)).
- **Modo de reescaneo rápido**: Omite automáticamente etapas pesadas cuando no se descubren nuevos activos (`--quick-rescan` / `QUICK_RESCAN`).
- **Constructor de listas calientes**: Puntúa y resalta los activos de mayor riesgo (`hotlist.txt`) según nuevos hallazgos.
- **Rastreo de comandos**: Activa `SHOW_COMMANDS` para registrar cada comando ejecutado en los registros del objetivo para depuración.
- **Almacén de activos**: Añade hallazgos a `assets.jsonl` para automatización posterior cuando `ASSET_STORE` está habilitado.
- **Informe consolidado**: Genera automáticamente `report/report.json` y `report/index.html` al final del escaneo.
- **Soporte ARM**: Compatible con Raspberry Pi y arquitecturas ARM (incluido MacOS MX).
- **Verificación de salud**: Verificación de salud del sistema integrada mediante `--health-check` (también usada por Docker `HEALTHCHECK`).
- **Modo incremental**: Solo escanea nuevos hallazgos desde la última ejecución (`--incremental`).
- **Limitación de velocidad adaptativa**: Retrocede automáticamente ante errores 429/503 (`--adaptive-rate`).
- **Registro estructurado**: Salida de registro JSON opcional para análisis avanzado (`STRUCTURED_LOGGING`).
- **Saneamiento de entrada**: Toda la entrada del usuario se sane para prevenir inyección de comandos.
- **Modo de prueba**: Previsualiza lo que se ejecutaría sin ejecutar comandos (`--dry-run`).
- **Modo paralelo**: Ejecuta funciones independientes en paralelo para escaneos más rápidos (`--parallel`, desactívelo con `--no-parallel`).
- **Arquitectura modular**: El código se divide en 8 módulos enfocados para facilitar el mantenimiento.
- **Gestión de secretos**: Variables de entorno, `secrets.cfg` y secretos de runtime de Docker (consulte [SECURITY.md](https://github.com/six2dez/reconftw/blob/main/SECURITY.md)).
- **Interruptor de circuito**: Omite automáticamente herramientas tras fallos repetidos para evitar que el escaneo se cuelgue.
- **Sistema de puntos de control**: Reanuda escaneos interrumpidos desde la última fase exitosa.
- **Soporte nativo de macOS**: Compatibilidad total con macOS (coreutils BSD, Homebrew Bash 4+).
---
## 🏗️ Arquitectura
reconFTW usa una arquitectura modular. El punto de entrada principal (`reconftw.sh`) maneja el análisis de argumentos y carga 8 módulos especializados del directorio `modules/`.
### Estructura de directorios```
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
```
### Referencia de Módulos
| Módulo | Líneas | Propósito |
|--------|------:|---------|
| `core.sh` | 1024 | Gestión del ciclo de vida, registro, notificaciones, trampas de limpieza |
| `modes.sh` | 902 | Definiciones de modos de escaneo, análisis de argumentos, salida de ayuda |
| `subdomains.sh` | 1938 | Todas las funciones de enumeración de subdominios |
| `web.sh` | 1712 | Análisis web, fuzzing, análisis de JS, detección de CMS |
| `vulns.sh` | 926 | Escaneo de vulnerabilidades (XSS, SQLi, SSRF, etc.) |
| `osint.sh` | 500 | Funciones OSINT (WHOIS, correos electrónicos, dorks, metadatos) |
| `utils.sh` | 508 | Utilidades compartidas, saneamiento de entrada, validación |
| `axiom.sh` | 143 | Gestión de flota distribuida Ax/Axiom |
La bandera `--source-only` permite cargar `reconftw.sh` sin ejecutar la lógica principal, lo que habilita pruebas unitarias de funciones individuales.
---
## 💿 Instalación
reconFTW admite múltiples métodos de instalación para adaptarse a diferentes entornos. Asegúrate de tener suficiente espacio en disco (se recomienda al menos 10 GB) y una conexión a internet estable.
### Inicio rápido
1) Clonar e instalar```yaml
git clone https://github.com/six2dez/reconftw
cd reconftw
./install.sh --verbose
```
2) Ejecutar un escaneo (completo + reanudar)```bash
./reconftw.sh -d example.com -r
```
3) Ejecución mínima (huella solo pasiva)```bash
./reconftw.sh -d example.com -p
```
> Consejo: vuelve a ejecutar `./install.sh --tools` más tarde para actualizar el conjunto de herramientas sin reinstalar los paquetes del sistema.
### Instalación local (PC/VPS/VM)
1. **Requisitos previos**:
- **Golang**: Última versión (`install_golang` habilitado por defecto en `reconftw.cfg`).
- **Permisos del sistema**: Si no se ejecuta como root, configura sudo para evitar solicitudes de contraseña:
```bash
sudo echo "${USERNAME} ALL=(ALL:ALL) NOPASSWD: ALL" | sudo tee -a /etc/sudoers.d/reconFTW
```
2. **Pasos**: ```bash
git clone https://github.com/six2dez/reconftw
cd reconftw
./install.sh
./reconftw.sh -d target.com -r
```
3. **Notas**:
- El script `install.sh` instala dependencias, herramientas y configura rutas (`GOROOT`, `GOPATH`, `PATH`).
- Establece `install_golang=false` en `reconftw.cfg` si Golang ya está configurado.
- Para instalaciones existentes, ejecuta `./install.sh --tools` para actualizar los binarios de Go, paquetes pipx y repositorios sin tocar los paquetes del sistema.
- Consulta la [Guía de instalación](https://github.com/six2dez/reconftw/wiki/0.-Installation-Guide) para instrucciones detalladas.
### Docker
1. **Descargar la imagen**: ```bash
docker pull six2dez/reconftw:main
```
2. **Ejecuta el contenedor**: ```bash
docker run -it --rm \
-v "${PWD}/OutputFolder/:/reconftw/Recon/" \
six2dez/reconftw:main -d example.com -r
```
Para una lista de objetivos, vincula el archivo de lista al contenedor y referencia la ruta dentro del contenedor: ```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. **Ver resultados**:
- Los resultados se guardan en el directorio `OutputFolder` del host (no dentro del contenedor).
4. **Personalización**:
- Modifica la imagen de Docker o crea la tuya propia; consulta la [Guía de Docker](https://github.com/six2dez/reconftw/wiki/4.-Docker).
- Para omitir las herramientas de Ax en compilaciones personalizadas, pasa `--build-arg INSTALL_AXIOM=false`.
- Monta tu configuración de notify en `~/.config/notify/provider-config.yaml` dentro del contenedor si usas notificaciones.
5. **Secretos en tiempo de ejecución**:
Pasa las claves de API y los secretos mediante variables de entorno; nunca los integres en la imagen: ```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
```
Vea [SECURITY.md](https://github.com/six2dez/reconftw/blob/main/SECURITY.md) para obtener la guía completa sobre la gestión de secretos.
6. **Verificación de salud**:
La imagen de Docker incluye un `HEALTHCHECK` integrado que ejecuta `./reconftw.sh --health-check` cada 60 segundos. También puede ejecutarlo manualmente: ```bash
docker exec <container-id> ./reconftw.sh --health-check
```
### Terraform + Ansible
- Despliega reconFTW en AWS usando Terraform y Ansible.
- Sigue la guía en [Terraform/README.md](https://github.com/six2dez/reconftw/blob/main/Terraform/README.md) para las instrucciones de configuración.
---
## Probando la versión beta v2 (reescritura en Go)
reconFTW se está reescribiendo en Go. La reescritura se distribuye como una **pre-versión opcional**: está
listada en la [página de versiones](https://github.com/six2dez/reconftw/releases), y GitHub
nunca apunta `releases/latest` a una pre-versión — así que **si no haces nada, sigues recibiendo
la versión bash.** Eso es deliberado.
El binario de Go es `reconftw`; el punto de entrada de bash es `reconftw.sh`. No se sobrescriben
entre sí, por lo que puedes mantener ambos y volver a cualquiera en cualquier momento.
La beta actual es **`v5.0.0-beta.1`**. No se sirve mediante `releases/latest`, por lo que debes
especificar la etiqueta explícitamente:```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
```
Selecciona el binario que coincida con tu plataforma desde la
[página de lanzamientos](https://github.com/six2dez/reconftw/releases/tag/v5.0.0-beta.1) — se publican compilaciones para `Darwin`
y `arm64`, una compilación estática con musl, y paquetes `.deb`/`.rpm`.
- [**Qué es la beta y qué no es**](https://github.com/six2dez/reconftw/blob/main/docs/V2-BETA-ANNOUNCEMENT.md) — incluye tres
cosas que explícitamente aún no están terminadas.
- [**Reportar algo**](https://github.com/six2dez/reconftw/issues/new?template=v2-beta-feedback.md)
— la plantilla de comentarios de la beta v2. Los errores en la versión bash siguen yendo al informe de errores normal.
## 🛠️ Solución de problemas
- Bash 4+ en macOS: Los scripts se relanzan automáticamente con Homebrew Bash. Si ves un mensaje sobre Bash < 4, ejecuta `brew install bash`, abre una nueva terminal y vuelve a ejecutar `./install.sh`.
- timeout en macOS: macOS proporciona `gtimeout` mediante `brew install coreutils`. Los scripts ahora lo detectan y lo usan automáticamente.
- Problemas de red: Los instaladores ocultan la mayor parte de la salida de los comandos. Si algo falla, vuelve a ejecutar con `upgrade_tools=true` en `reconftw.cfg`, ejecuta `./install.sh --tools`, o instala manualmente la herramienta que falta (el error la nombrará).
- Binarios GOPATH: Los binarios se copian a `/usr/local/bin`. Si prefieres no hacerlo, asegúrate de que `~/go/bin` esté en tu `PATH`.
- Plantillas de Nuclei: Si las plantillas no se clonaron, elimina `~/nuclei-templates` y vuelve a ejecutar `./install.sh`.
## 🔑 Lista de verificación de API (Opcional)
- `subfinder`: `~/.config/subfinder/provider-config.yaml`
- Tokens de GitHub: `~/Tools/.github_tokens` (uno por línea)
- Tokens de GitLab: `~/Tools/.gitlab_tokens` (uno por línea)
- WHOISXML: establece `WHOISXML_API` en `reconftw.cfg` o como variable de entorno
- Enumeración ASN (`asnmap`): establece `PDCP_API_KEY` en entorno/config (`ASN_ENUM` se omite si no está definido)
- Slack/Discord/Telegram: configura `notify` en `~/.config/notify/provider-config.yaml`
- Servidor SSRF: establece `COLLAB_SERVER` en entorno/cfg si se usa
- Servidor Blind XSS: establece `XSS_SERVER` en entorno/cfg si se usa
## 💾 Requisitos
- Disco: 10–20 GB libres recomendados (toolchain + datos)
- Red: conexión estable durante la instalación y las actualizaciones
- SO: Linux/macOS con Bash ≥ 4
```
---
[Read more](https://github.com/six2dez/reconftw)