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)، واختبار الدلائل، وفحص المنافذ، والتقاط لقطات الشاشة. تتكامل مع أحدث الأدوات وواجهات برمجة التطبيقات (APIs) لتعظيم التغطية والدقة، مما يضمن بقاءك في المقدمة في جهود الاستطلاع.
**الميزات الرئيسية:**
- تعداد شامل للنطاقات الفرعية (سلبي، قوة غاشمة، تبديلات، شفافية الشهادات، إلخ)
- فحص الثغرات الأمنية لـ XSS وSSRF وSQLi وLFI وSSTI والمزيد
- جمع المعلومات مفتوحة المصدر (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-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)).
- **تسريبات واجهات برمجة التطبيقات (APIs)**: اكتشاف واجهات برمجة التطبيقات المكشوفة في المصادر العامة ([porch-pirate](https://github.com/MandConsultingGroup/porch-pirate)، [SwaggerSpy](https://github.com/UndeadSec/SwaggerSpy) و[postleaksNg](https://github.com/six2dez/postleaksNG)).
- **بحث Google المتقدم (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 (اختياري)**: تدقيق القطع الأثرية لسير العمل والتعرض في CI/CD باستخدام [gato](https://github.com/praetorian-inc/gato).
- **سوء تكوين الأطراف الثالثة**: تحديد خدمات الأطراف الثالثة ذات التكوين الخاطئ ([misconfig-mapper](https://github.com/intigriti/misconfig-mapper)).
- **صحة البريد**: مراجعة تكوين SPF/DMARC لتحديد مشكلات الانتحال أو قابلية التسليم.
- **تعداد التخزين السحابي**: مسح الحاويات (Buckets) عبر المزودين الرئيسيين بحثًا عن التعرض ([cloud_enum](https://github.com/initstring/cloud_enum)).
- **النطاقات القابلة للانتحال**: التحقق من النطاقات المعرضة للانتحال ([spoofcheck](https://github.com/MattKeeley/Spoofy)).
### النطاقات الفرعية
- **التعداد السلبي**: استخدام واجهات برمجة التطبيقات والمصادر العامة لاكتشاف النطاقات الفرعية ([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) وقوائم كلمات مخصصة).
- **التبديلات**: توليد تبديلات النطاقات الفرعية باستخدام الذكاء الاصطناعي والتعبيرات النمطية والأدوات ([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 ([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)).
- **ملاحظة التغطية السحابية**: لم تعد فحوصات الحاويات السحابية تشمل تغطية Alibaba OSS بعد استبدال CloudHunter بـ cloud_enum.
- **ترحيل المخرجات السحابية**: تمت إزالة القطع الأثرية القديمة للحاويات `cloudhunter_*`؛ استخدم `subdomains/cloud_enum_buckets_trufflehog.txt` بدلاً من ذلك.
- **بحث IP العكسي**: اكتشاف النطاقات الفرعية عبر نطاقات IP ([hakip2host](https://github.com/hakluke/hakip2host)).
### المضيفون
- **معلومات IP**: استرجاع بيانات الموقع الجغرافي وWHOIS ([ipinfo](https://www.ipinfo.io/)).
- **اكتشاف CDN**: تحديد عناوين IP خلف شبكات توصيل المحتوى (CDNs) ([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).
- **ثغرات الخدمات (اختياري)**: يمكن لملف تعريف فحص المنافذ العميق إثراء النتائج بمطابقة CVEs عبر [vulners](https://github.com/vulnersCom/nmap-vulners).
- **رش كلمات المرور**: محاولة رش كلمات المرور على الخدمات المحددة مع اختيار المحرك ([brutespray](https://github.com/x90skysn3k/brutespray) أو [brutus](https://github.com/praetorian-inc/brutus)).
- **الموقع الجغرافي**: ربط عناوين IP بالمواقع الجغرافية ([ipinfo](https://www.ipinfo.io/)).
- **اكتشاف IPv6**: تعداد وفحص أهداف IPv6 المكتشفة اختياريًا عند تمكين `IPV6_SCAN`.
### تحليل الويب
- **اختبار الويب**: اكتشاف خوادم الويب المباشرة على المنافذ القياسية وغير الشائعة ([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)).
- **استطلاع تقنيات Favicon**: تحديد التقنيات من تجزئات الأيقونات المفضلة ([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**: اكتشاف نقاط نهاية GraphQL باستخدام nuclei واختياريًا تنفيذ فحص داخلي متعمق ([GQLSpection](https://github.com/doyensec/GQLSpection)).
- **اكتشاف المعاملات**: القوة الغاشمة للمعاملات المخفية على نقاط النهاية ([arjun](https://github.com/s0md3v/Arjun)).
- **تدقيق WebSocket**: التحقق من مصافحات الترقية ومعالجة الأصل على نقاط نهاية `ws://` و`wss://`.
- **انعكاس gRPC**: فحص منافذ gRPC الشائعة بحثًا عن انعكاس الخدمة المكشوف ([grpcurl](https://github.com/fullstorydev/grpcurl)).
- **بصمة خدمات LLM (اختياري)**: فحص نقاط نهاية الويب/API المكتشفة بحثًا عن خدمات LLM المكشوفة باستخدام [julius](https://github.com/praetorian-inc/julius).
- **الاختبار (Fuzzing)**: تنفيذ اختبار الدلائل والمعاملات ([ffuf](https://github.com/ffuf/ffuf)).
- **فرز امتدادات الملفات**: تنظيم عناوين URL حسب امتدادات الملفات.
- **توليد قوائم الكلمات**: إنشاء قوائم كلمات مخصصة للاختبار.
- **قاموس كلمات المرور**: توليد قواميس كلمات المرور من المحتوى المباشر ([cewler](https://github.com/roys/cewler)).
- **فحص الأسماء القصيرة IIS**: اكتشاف ثغرات الأسماء القصيرة في IIS ([shortscan](https://github.com/bitquark/shortscan)).
### فحوصات الثغرات الأمنية
- **CVEs**: التحقق من CVEs والثغرات الشائعة [nuclei](https://github.com/projectdiscovery/nuclei)
- **Nuclei DAST**: تشغيل قوالب `nuclei -dast` على عناوين URL المجمعة ومرشحات GF لتغطية 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 مخصصة**: يولّد محلّلات DNS ([dnsvalidator](https://github.com/vortexau/dnsvalidator)).
- **دعم Docker**: صورة Docker رسمية على [DockerHub](https://hub.docker.com/r/six2dez/reconftw).
- **النشر على 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)).
- **ضغط النتائج**: يضغط النتائج ويرسلها.
- **تكامل Faraday**: يصدّر النتائج إلى [Faraday](https://github.com/infobyte/faraday) لإعداد التقارير.
- **توليد تقارير بالذكاء الاصطناعي**: يولّد تقارير باستخدام نماذج ذكاء اصطناعي محلية ([reconftw_ai](https://github.com/six2dez/reconftw_ai)).
- **وضع إعادة الفحص السريع**: يتخطى المراحل الثقيلة تلقائيًا عند عدم اكتشاف أصول جديدة (`--quick-rescan` / `QUICK_RESCAN`).
- **منشئ القائمة الساخنة**: يقيّم ويسلط الضوء على الأصول الأكثر خطورة (`hotlist.txt`) بناءً على الاكتشافات الجديدة.
- **تتبع الأوامر**: فعّل `SHOW_COMMANDS` لتسجيل كل أمر منفّذ في سجلات الهدف لأغراض التصحيح.
- **مخزن الأصول**: يضيف الاكتشافات إلى `assets.jsonl` للأتمتة اللاحقة عند تفعيل `ASSET_STORE`.
- **تقرير موحّد**: يولّد تلقائيًا `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 الأساسية، Homebrew Bash 4+).
---
## 🏗️ المعمارية
يستخدم reconFTW معمارية معيارية. نقطة الدخول الرئيسية (`reconftw.sh`) تتعامل مع تحليل الوسائط وتستدعي 8 وحدات متخصصة من دليل `modules/`.
### هيكل الدليل```
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 | تحليل الويب، الفازينغ، تحليل JavaScript، اكتشاف أنظمة إدارة المحتوى |
| `vulns.sh` | 926 | فحص الثغرات (XSS، SQLi، SSRF، وغيرها) |
| `osint.sh` | 500 | دوال الاستخبارات مفتوحة المصدر (WHOIS، البريد الإلكتروني، الدوركس، البيانات الوصفية) |
| `utils.sh` | 508 | الأدوات المشتركة، تنقية المدخلات، التحقق |
| `axiom.sh` | 143 | إدارة أسطول Ax/Axiom الموزع |
يتيح العلم `--source-only` استيراد `reconftw.sh` دون تنفيذ المنطق الرئيسي، مما يسمح باختبار الوحدات الفردية.
---
## 💿 التثبيت
يدعم reconFTW طرق تثبيت متعددة لتناسب البيئات المختلفة. تأكد من توفر مساحة قرص كافية (10 جيجابايت على الأقل موصى بها) واتصال إنترنت مستقر.
### البدء السريع
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**: أحدث إصدار (`install_golang` مفعّل افتراضيًا في `reconftw.cfg`).
- **صلاحيات النظام**: إذا لم تكن تعمل كجذر، قم بتكوين 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`).
- اضبط `install_golang=false` في `reconftw.cfg` إذا كان Golang مُهيأ بالفعل.
- للإعدادات الحالية، شغّل `./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
```
للحصول على قائمة بالأهداف، اربط ملف القائمة داخل الحاوية وأشر إلى المسار داخل الحاوية: ```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. **التخصيص**:
---
[Read more](https://github.com/six2dez/reconftw)