antitree/private-tor

Docker上的私有Tor网络

镜像概述

这是一个在Docker容器中运行的隔离私有Tor网络镜像，旨在为Tor协议研究、开发测试和流量分析提供封闭环境。该镜像不应用于替代公共Tor网络，仅用于研究目的。

核心功能

• 支持多种节点角色：目录权威节点（DA）、中继节点（RELAY）、出口节点（EXIT）、客户端（CLIENT）和洋葱服务（HS）
• 通过环境变量灵活配置节点参数（如端口、目录路径、控制密码等）
• 支持Docker Stack和Docker Compose快速部署
• 提供工具脚本（如get_consensus.py）用于网络监控和调试
• 可集成洋葱服务，转发流量到指定服务

使用场景

1. Tor协议研究：了解Tor节点间的交互机制，修改配置并观察效果，无需影响真实用户。
2. Tor开发：测试复杂补丁，验证其在Tor网络中的运行效果。
3. 流量分析：在私有环境中模拟***场景，研究Tor网络的防御机制。

配置说明

快速部署

使用Docker Stack部署整个网络：

bash
docker stack deploy --compose-file docker-compose.yml torstack

运行单个角色

手动运行不同角色的节点：

• 目录权威节点（DA）：

  bash
  docker run -e ROLE=DA antitree/private-tor
  

• 中继节点（RELAY）：

  bash
  docker run -e ROLE=RELAY antitree/private-tor
  

• 客户端（CLIENT）：

  bash
  docker run -e ROLE=CLIENT antitree/private-tor
  

洋葱服务配置

通过环境变量配置洋葱服务，转发流量到指定服务（如Nginx）：

yaml
hs:
  image: antitree/private-tor
  expose:
    - "80"
  environment:
    ROLE: HS
    TOR_HS_PORT: "80"
    TOR_HS_ADDR: "web"
  volumes:
    - ./tor:/tor
  depends_on:
    - da1
    - da2
    - da3
  links:
    - web
web:
  image: nginx
  expose:
    - "80"

环境变量

常用环境变量：

• TOR_ORPORT：默认7000（节点间通信端口）
• TOR_DIRPORT：默认9030（目录服务端口）
• TOR_DIR：容器内Tor数据目录，默认/tor
• TOR_CONTROL_PWD：控制端口密码，默认"password"
• TOR_HS_PORT：洋葱服务监听端口
• TOR_HS_ADDR：洋葱服务转发目标地址

调试与监控

• 查看节点日志：docker service logs -f {stackname}_da_1
• 使用Arm工具监控客户端：安装tor-arm后运行arm，输入密码"password"
• 获取网络共识：python util/get_consensus.py

免责声明

本项目与Tor Project或其开发者无关。建议通过运行中继节点、***或贡献代码等方式支持Tor项目。

参考资源

• https://github.com/andrewmichaelsmith/private-tor-network-kube
• https://github.com/chriswayg/tor-server
• [***]