dedsecinside/torbotتزحف إلى مواقع .onion عبر Tor لجمع عناوين الصفحات وأسماء المضيفين وعلاقات الروابط، وتُصدّر أشجار JSON وتمثيلات مرئية لتحقيقات OSINT على الويب المظلم.
████████╗ ██████╗ ██████╗ ██████╗ ██████╗ ████████╗
╚══██╔══╝██╔═══██╗██╔══██╗ ██╔══██╗██╔═████╗╚══██╔══╝
██║ ██║ ██║██████╔╝ ██████╔╝██║██╔██║ ██║
██║ ██║ ██║██╔══██╗ ██╔══██╗████╔╝██║ ██║
██║ ╚██████╔╝██║ ██║ ██████╔╝╚██████╔╝ ██║
╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝
أداة استخبارات المصادر المفتوحة للويب المظلم
--version و--update دون الحاجة إلى URL.torbot app عند تثبيتها كنسخة مجاورة....(سيتم تحديثه)
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements.txt
python -m pip install -e .
python main.py --help
python main.py --version
python main.py -u https://example.com --depth 2 --visualize table
# Gather basic site information
python main.py -u https://example.com --info
# Save the crawl tree as JSON
python main.py -u https://example.com --depth 2 --save json
# Disable SOCKS5 if you are not using Tor locally
python main.py -u https://example.com --disable-socks5 --visualize tree
# Launch the optional desktop app when TorBotApp is installed
torbot app
احفظ نتيجة زحف مُصدَّرة بإصدار وحوّلها إلى حزمة تحقيق موثّقة بالمراجع:
torbot --url https://example.com --disable-socks5 \
--save result --result-file crawl-result.json
torbot analyze crawl-result.json --provider ollama --model qwen3 \
--output investigation/
يعود المحلل افتراضيًا إلى نقطة نهاية Ollama محلية. تتطلب موفرو الخدمات
البعيدون المتوافقون مع OpenAI علامة --allow-remote الصريحة. يجب أن يستشهد كل
نتيجة مدعومة بالأدلة المُلتقطة، ولا يمنع انقطاع مزوّد الخدمة أبدًا من كتابة
حزمة الأدلة الحتمية. راجع
TorBot Analyst للاطلاع على البدء السريع دون اتصال، وصيغ
الإخراج، وحدود الخصوصية، والمخططات.
usage: Gather and analyze data from Tor sites.
optional arguments:
-u URL, --url URL Specify a website link to crawl
--depth DEPTH Specify max depth of crawler (default 1)
-h, --help Show this help message and exit
--host Set IP address for SOCKS5 proxy (defaults to 127.0.0.1)
--port Set port for SOCKS5 proxy (defaults to 9050)
-v Displays DEBUG level logging, default is INFO
--version Show the current version of TorBot.
--update Update TorBot to the latest stable version
--app Run optional TorBot desktop app
--app-dir APP_DIR Path to a TorBotApp checkout
-q, --quiet Prevents display of header and IP address
--save FORMAT Save results in a file. (tree, JSON)
--visualize FORMAT Visualizes tree of data gathered. (tree, JSON, table)
-i, --info Info displays basic info of the scanned site
--disable-socks5 Executes HTTP requests without using SOCKS5 proxy
-u/--urlمطلوب للأوامر المتعلقة بالزحف مثل--infoو--saveو--visualize.
إذا كنت تستخدم Tor محليًا، فأبقِ وكيل SOCKS5 مُفعّلًا. وإذا لم تكن تستخدم Tor، فأضف --disable-socks5 لتجنّب أخطاء الاتصال بالوكيل.
اقرأ المزيد عن torrc هنا: Torrc
يبقى TorBot أداة Python تعتمد على سطر الأوامر أولًا. توجد واجهة سطح المكتب في مشروع TorBotApp الإلكتروني المنفصل، لذا لا يُشترط توفر Node و Electron لمستخدمي سطر الأوامر.
لتشغيله من سطر الأوامر هذا، ثبّت TorBotApp كنسخة مستخرجة مجاورة:
code/
+-- TorBot/
+-- TorBotApp/
ثم شغّل:
torbot app
إذا كان TorBotApp في مكان آخر، فاستخدم إما:
TORBOT_APP_DIR=/path/to/TorBotApp torbot app
torbot --app --app-dir /path/to/TorBotApp
راجع معمارية تطبيق سطح المكتب لمعرفة كيفية ترابط واجهة سطر الأوامر (CLI) والواجهة الاختيارية وخدمات الواجهة الخلفية.
إذا واجهت أي مشكلات في المشروع، فيرجى إبلاغنا بإنشاء مشكلة جديدة هنا.
نرحّب بالمساهمات في هذا المشروع! فيما يلي بعض الإرشادات التي يجب اتباعها:
pytest قبل إرسال طلب سحب (pull request) إلى فرع dev.