🔍 فحص النطاقات الفرعية Knockpy الإصدار 9.0

✅ سريع وغير متزامن • 🔐 استطلاع + قوة عمياء • 🔧 سهل التوسيع

KnockPy هي أداة موديولية بلغة Python 3 لتعداد النطاقات الفرعية عبر الاستطلاع السلبي والقوة العمياء، الآن مع دعم async/await، وأداء محسن، ومعالجة حديثة لـ HTTP/TLS.

🚀 الميزات (الإصدار 9)

• ✅ المسح غير المتزامن مع httpx وحل DNS
• ✅ موديولي: إضافة مصادر سلبية جديدة بسهولة
• 🔍 يدعم الاستطلاع السلبي، القوة العمياء، أو كليهما
• 🎨 مخرجات طرفية منسقة مع Rich (جداول، تقدم، لوحات)
• 📜 التحقق من حالة HTTP/HTTPS، شهادة TLS، و IP
• ⚠️ كشف دعم TLS القديم (TLS 1.0/1.1) كتحذير في CLI/مفصل/تقرير HTML
• 🧾 فحص نقل المنطقة (AXFR) على النطاق الجذري أثناء مسح وضع النطاق
• 🔎 تشخيصات نطاق واحد باستخدام --verbose (DNS/TCP/TLS/سلاسل إعادة التوجيه/أخطاء الطلب + فحوصات أمنية)
• 💡 يدعم كشف DNS البدل
• 🧪 تقارير SQLite مع كتالوج تفاعلي (show/delete/export/search)
• 🔐 يدعم واجهة برمجة تطبيقات VirusTotal و Shodan
• 🚀 زمن تشغيل القوة العمياء المحسّن مع تخزين نقطة نهاية فحص TLS (لا حاجة لتغييرات المهلة)

📦 التثبيت

من مصدر GitHub (موصى به)

git clone https://github.com/guelfoweb/knockpy.git
cd knockpy
# recommended: install in a virtual environment
python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install -U pip
pip install .

# alternative: install for the current user (no venv)
# python3 -m pip install --user .

⚠️ إصدار Python الموصى به: 3.9+

🧱 هيكل المشروع

تم تنظيم قاعدة الكود حسب المسؤولية، مع واجهات مستقرة للتوافق مع الإصدارات السابقة:

knockpy/
  cli.py                   # CLI entrypoint (facade/orchestration)
  cli_parts/
    status.py              # runtime/status panel rendering
    setup.py               # interactive setup and persisted runtime defaults
    report.py              # interactive report mode
    scan_flow.py           # exclude rules, recon-test, wildcard helpers
  core.py                  # public core facade (compatibility)
  engine/
    runtime.py             # scanning engine implementation
  storage.py               # public storage facade (compatibility)
  storage_parts/
    db.py                  # SQLite persistence/settings
    export.py              # report export orchestration
    html_report.py         # HTML report rendering
  output.py                # terminal output rendering
  server_versions.py       # web-server versions catalog
  knockpy.py               # compatibility module exports

ملاحظة التوافق:

• الاستيرادات الخارجية المفضلة: import knockpy أو from knockpy import KNOCKPY.
• الوحدات الداخلية مقسمة إلى engine/ و cli_parts/ و storage_parts/.

باستخدام pip

فقط بعد إصدار النسخة المستقرة على GitHub

pip install knock-subdomains

🧪 الاستخدام

knockpy -d domain.com [options]

الخيارات

ضبط الأداء: --threads و --timeout

هذان الخياران لهما أكبر تأثير على وقت التشغيل للمسح الكبير.

• --threads يتحكم في التزامن (عدد الأهداف التي تتم معالجتها بالتوازي)
• --timeout يتحكم في المدة التي ينتظرها كل خطوة شبكة قبل الاستسلام

المقايضة:

• عدد threads أعلى = مسح أسرع، ولكن حمل أكبر على وحدة المعالجة/الشبكة/DNS وزيادة خطر حدود المعدل البعيد
• مهلة timeout أقل = مسح أسرع، ولكن خطر أكبر لفقدان أهداف بطيئة ولكن صالحة (سلبيات كاذبة)

الملفات الشخصية الموصى بها:

• مسح صغير/دقيق (نطاقات قليلة): --threads 50 --timeout 5
• مسح متوازن: --threads 150 --timeout 4
• مسح كبير (10 آلاف+ نطاق): ابدأ بـ --threads 250 --timeout 3

إذا كنت بحاجة إلى السرعة والاكتمال على قوائم كبيرة جدًا، استخدم استراتيجية المرورين:

1. مرور سريع: --threads 250 --timeout 3
2. مرور إعادة محاولة فقط على الأهداف المفقودة/غير المؤكدة: --threads 80 --timeout 5 (أو أعلى)

ملاحظات:

• قيم CLI تتجاوز دائمًا قيم الإعداد المحفوظة
• قيم الإعداد المحفوظة (--setup) تتجاوز القيم الافتراضية المضمنة
• القيم الافتراضية المضمنة الحالية هي threads=250, timeout=3

📌 أمثلة

🔎 استطلاع + قوة عمياء

knockpy -d example.com --recon --bruteforce

🧪 اختبار خدمات الاستطلاع

knockpy -d example.com --recon --test

🔄 تحديث كتالوج أحدث إصدارات خادم الويب

knockpy --update-versions

🆕 التحقق من تحديثات Knockpy

knockpy --check-update

⚙️ تكوين مصادر الاستطلاع (قابل للتعديل)

في التشغيل الأول، يقوم KnockPy بإنشاء:

~/.knockpy/recon_services.json

يمكنك إضافة/تعطيل المصادر عن طريق تعديل مصفوفة services. يمكنك أيضًا الإشارة إلى مسار ملف مخصص دون تغيير الكود:

export KNOCK_RECON_SERVICES=/path/to/recon_services.json

كل خدمة تدعم:

• name (الاسم)
• enabled (true/false) (مفعل)
• parser (المحلل)
• url_template (يدعم {domain}، {virustotal_key}، {shodan_key})
• requires_api (virustotal أو shodan، اختياري)

المحللون المدعومون:

• csv_first_column
• rapiddns_html_td
• json_list
• virustotal_subdomains
• shodan_subdomains

📥 نطاق من stdin

echo "example.com" | knockpy -d

🧠 مفاتيح API (اختياري)

export API_KEY_VIRUSTOTAL=your-virustotal-api-key
export API_KEY_SHODAN=your-shodan-api-key

يمكنك استخدام ملف .env:

API_KEY_VIRUSTOTAL=your-virustotal-api-key
API_KEY_SHODAN=your-shodan-api-key

💾 التقارير (SQLite + تصدير HTML تفاعلي)

knockpy -d example.com --recon --bruteforce
knockpy --report list
knockpy --report latest
knockpy --report

قائمة التقرير التفاعلية:

• 1 show (عرض)
• 2 delete (حذف)
• 3 export (تصدير)
• 4 search (بحث)
• 0 reset db (إعادة تعيين قاعدة البيانات) (يطلب تأكيدًا صريحًا)

الخروج من وضع التقرير:

• اضغط Enter عند موجه الإجراء الفارغ
• أو اضغط CTRL+C

🔍 تشخيصات نطاق واحد

knockpy -d forum.example.com --verbose

🧪 اختبار البدل فقط

knockpy -d example.com --wildcard

🧬 استخدام واجهة برمجة تطبيقات Python

يمكن استخدام KnockPy كوحدة Python:

import knockpy

result = knockpy.KNOCKPY("example.com", timeout=5.0, threads=20)
print(result["domain"], result["ip"])

أو:

from knockpy import KNOCKPY

domain = 'example.com'

results = KNOCKPY(
    domain,
    dns="8.8.8.8",
    useragent="Mozilla/5.0",
    timeout=5,
    threads=10,
    recon=True,
    bruteforce=True,
    wordlist=None,
    silent=False
)

for entry in results:
    print(entry['domain'], entry['ip'], entry['http'], entry['cert'])

📂 قائمة الكلمات

يتم تضمين قائمة كلمات افتراضية في knockpy/wordlist/wordlist.txt. يمكنك توفير قائمتك الخاصة باستخدام --wordlist.

الاختبار

python3 -m pytest

# (optional) smoke-run example script
python3 examples/poc.py

📖 الترخيص

مرخص بموجب ترخيص GPLv3.

Gianni Amato (@guelfoweb)