nullhypothesis/exitmapTor 출구 릴레이를 위한 빠르고 모듈식 스캐너입니다. 정식 저장소(이슈 트래커 포함)는 https://gitlab.torproject.org/tpo/network-health/exitmap 에 있습니다.
이 저장소는 유지보수되지 않습니다. Tor 프로젝트의 포크를 참조하세요.
Exitmap은 Tor 종료 릴레이를 위한 빠르고 모듈식의 Python 기반 스캐너입니다. Exitmap 모듈은 (일부 또는 모든) 종료 릴레이를 통해 실행되는 작업을 구현합니다. 함수형 프로그래밍 배경이 있다면, exitmap을 Tor 종료 릴레이를 위한 map() 인터페이스로 생각할 수 있습니다. 모듈은 웹 페이지 가져오기, 파일 업로드, SSH 서버 연결, IRC 채널 참여 등 모든 TCP 기반 네트워킹 작업을 수행할 수 있습니다.
실제로 exitmap은 종료 릴레이의 신뢰성과 신뢰도를 모니터링하는 데 유용합니다. Tor 프로젝트는 exitmap을 사용하여 Tor 프로젝트의 check 서비스에서 거짓 음성을 확인하고 악성 종료 릴레이를 찾습니다. exitmap을 위한 새 모듈을 개발하는 것은 쉽습니다. doc/ 디렉토리의 HACKING 파일을 참조하거나 기존 모듈 중 하나를 확인해보세요.
Exitmap은 Stem을 사용하여 주어진 모든 종료 릴레이에 회로를 생성합니다. Tor가 설정된 회로를 exitmap에 알릴 때마다 새로 설정된 회로에 대해 모듈이 호출됩니다. 모듈은 순수 Python 스크립트 또는 실행 파일일 수 있습니다. 실행 파일의 경우 torsocks가 필요합니다.
마지막으로, exitmap은 네트워크 측정 도구이며 일반 Tor 사용자에게는 거의 유용하지 않습니다. Tor 프로젝트는 이미 이 도구를 정기적으로 실행하고 있습니다. 더 많은 exitmap 스캔은 불필요한 네트워크 부하만 초래할 뿐입니다. exitmap이 공개적으로 제공되는 유일한 이유는 소스 코드와 설계가 일부 사람들에게 관심을 가질 수 있기 때문입니다.
Exitmap은 Stem 라이브러리를 사용하여 Tor와 통신합니다. Stem을 설치하는 방법은 여러 가지가 있습니다. 가장 쉬운 방법은 제공된 requirements.txt 파일과 함께 pip를 사용하는 것입니다:
$ pip install -r requirements.txt
exitmap이 요구하는 유일한 인수는 모듈 이름입니다. 예를 들어, checktest 모듈로 exitmap을 실행하려면 다음을 실행합니다:
$ ./bin/exitmap checktest
그러면 명령줄 출력에 Tor가 부트스트랩되는 과정, checktest 모듈의 출력, 그리고 스캔 요약이 표시됩니다. 세 홉이 필요 없고 정적 첫 번째 홉과 함께 두 홉을 선호한다면 다음을 실행합니다:
$ ./bin/exitmap --first-hop 1234567890ABCDEF1234567890ABCDEF12345678 checktest
동일한 테스트를 독일 종료 릴레이에 대해서만 실행하려면 다음을 실행합니다:
$ ./bin/exitmap --country DE --first-hop 1234567890ABCDEF1234567890ABCDEF12345678 checktest
회로 생성 사이에 5초 동안 일시 중지하여 Tor 네트워크와 스캔 대상의 부하를 줄이려면 다음을 실행합니다:
$ ./bin/exitmap --build-delay 5 checktest
1234567890ABCDEF1234567890ABCDEF12345678은 자신이 제어하는 종료 릴레이로 대체해야 하는 가상의 지문입니다.
exitmap의 모든 옵션에 대해 자세히 알아보려면 다음을 실행합니다:
$ ./bin/exitmap --help
Exitmap은 기본 모듈을 포함하여 제공되며, 다음과 같은 모듈이 있습니다:
기본적으로 exitmap은 홈 디렉토리의 .exitmaprc 파일을 읽으려고 시도합니다. 이 파일은 모든 명령줄 옵션을 허용하지만, 하이픈을 밑줄로 대체해야 합니다. 예는 다음과 같습니다:
[Defaults]
first_hop = 1234567890ABCDEF1234567890ABCDEF12345678
verbosity = debug
build_delay = 1
analysis_dir = /path/to/exitmap_scans
exitmap이 마음에 들지 않나요? 그렇다면 tortunnel, SoaT, torscanner, DetecTor, 또는 SelekTOR를 확인해보세요.
풀 리퀘스트를 제출하기 전에 모든 단위 테스트가 통과하는지 확인하려면 다음을 실행합니다:
$ pip install -r requirements-dev.txt
$ py.test --cov-report term-missing --cov-config .coveragerc --cov=src test
연락처: Philipp Winter [email protected]
OpenPGP 지문: B369 E7A2 18FE CEAD EB96 8C73 CF70 89E3 D7FD C0D0