
Tor를 통해 .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 .
OTinstaller는 torbot PyPI 릴리스를 자체 virtualenv에 설치하는 서드파티 도구 관리자입니다. TorBot 팀이 유지 관리하는 도구가 아니므로, 이와 관련된 문제는 OTinstaller 트래커에 보고해 주세요.
pipx install otinstaller
otinstaller init
otinstaller install torbot
# url:... is passed to TorBot as -u; the other flags go through unchanged
otinstaller run torbot -- url:https://example.com --depth 2 --visualize table
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를 실행하여 코드가 모든 테스트를 통과하는지 확인하세요.