dedsecinside/torbotTor를 통해 .onion 사이트를 크롤링하여 페이지 제목, 호스트 이름, 링크 관계를 수집하고, 다크 웹 OSINT 조사를 위한 JSON 트리와 시각화를 내보냅니다.
████████╗ ██████╗ ██████╗ ██████╗ ██████╗ ████████╗
╚══██╔══╝██╔═══██╗██╔══██╗ ██╔══██╗██╔═████╗╚══██╔══╝
██║ ██║ ██║██████╔╝ ██████╔╝██║██╔██║ ██║
██║ ██║ ██║██╔══██╗ ██╔══██╗████╔╝██║ ██║
██║ ╚██████╔╝██║ ██║ ██████╔╝╚██████╔╝ ██║
╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝
다크 웹을 위한 오픈 소스 정보 수집 도구
--version 및 --update를 실행할 수 있습니다.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/
Analyst는 기본적으로 로컬 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은 CLI 우선 Python 도구로 유지됩니다. 데스크톱 UI는 별도의 TorBotApp Electron 프로젝트에 있으므로 CLI 사용자에게는 Node와 Electron이 필요하지 않습니다.
이 CLI에서 실행하려면 TorBotApp을 형제 체크아웃으로 설치하세요:
code/
+-- TorBot/
+-- TorBotApp/
그런 다음 실행합니다:
torbot app
TorBotApp이 다른 위치에 있다면 다음 중 하나를 사용하세요:
TORBOT_APP_DIR=/path/to/TorBotApp torbot app
torbot --app --app-dir /path/to/TorBotApp
CLI, 선택적 UI, 백엔드 서비스가 어떻게 함께 구성되는지는 Desktop App Architecture를 참조하세요.
프로젝트에서 문제가 발생하면 여기에서 새 이슈를 생성하여 알려주세요.
이 프로젝트에 대한 기여를 환영합니다! 다음은 따라야 할 몇 가지 가이드라인입니다:
dev 브랜치로 풀 리퀘스트를 제출하기 전에 pytest를 실행하여 코드가 모든 테스트를 통과하는지 확인하세요.