OnionHop V3 是一款现代化的跨平台桌面应用（支持 Windows、macOS 和 Linux），可将你的流量通过 Tor 进行路由。它可以将 Tor 作为本地 SOCKS 代理运行，或作为系统级隧道运行；通过 Smart Connect 自动为你的网络选择可用的连接策略；扫描并应用适用于受审查网络的可用网桥（覆盖所有传输方式）；甚至还可以让你自愿充当 Snowflake 代理。
免责声明 OnionHop 按“原样”提供。在某些司法管辖区，使用 Tor 可能违法或受到限制。你有责任遵守当地的法律法规。
V3 基于全新的跨平台 UI 技术栈从零重建，配备了更智能的连接引擎，以及更丰富的抗审查传输方式。
tor.exe，完全控制：网桥、国家/入口/出口固定、控制端口 New Identity）、Arti（Rust 实现的 Tor，支持原生网桥/PT 配置）和 ArtiHop（缩短的 2 跳 Guard→Exit 电路，降低延迟）。OnionHopV3.Cli），带有实时状态仪表盘、connect/scan/bridges/snowflake/relays 命令和设置持久化。Windows、Linux 和 macOS 包由 CI 构建。从 Releases 获取你平台的最新构建：
| 平台 | 文件 | 说明 |
|---|---|---|
| Windows | OnionHop-Setup-v3.exe | 安装程序（自包含，捆绑 .NET 运行时） |
| Windows | OnionHopV3-Portable-…win-x64.zip | 便携版，无需安装 |
| Linux | OnionHop-x86_64.AppImage | chmod +x 后运行 |
| macOS | OnionHop-3.x-macOS.dmg | 已签名并公证；通用（Apple Silicon + Intel）— 来自 macOS 仓库 |
| Windows CLI | OnionHop-CLI-Setup-3.x.exe / 便携 ZIP | 终端界面 |
| Linux CLI | OnionHopCLI-…linux-x64.tar.gz | 终端界面 |
| Linux CLI (ARM) | OnionHopCLI-…linux-arm64.tar.gz（64 位）/ …linux-arm.tar.gz（32 位 ARMv7） | Raspberry Pi 及其他 ARM 板；参见 无头使用 |
| macOS CLI | OnionHopCLI-…macos-arm64.tar.gz（Apple Silicon）/ …macos-x64.tar.gz（Intel） | 终端界面；已签名并公证 — 与 DMG 一样来自 macOS 仓库 |
macOS 的
.dmg由专门的代码签名仓库 rana-gmbh/onionhopMac 发布。
安装适用于你操作系统的构建版本（见上文）。Windows 安装程序以及 macOS/Linux 捆绑包均为自包含——已内置 .NET 9 运行时。
选择模式
连接
注意事项
.onion 站点需要支持 Tor 的客户端（推荐 Tor Browser）或 SOCKS 远程 DNS（例如 Firefox 的“使用 SOCKS v5 时代理 DNS”）。| 引擎 | 跳数 | 管理员权限 | 网桥 / 固定 / NEWNYM | 说明 |
|---|---|---|---|---|
Classic (tor.exe) | 3 | 否（代理） | 网桥、固定、NEWNYM | 功能最全；推荐用于抗审查 + 手动电路控制 |
| Arti | 3 | 否 | 网桥/PT | Rust 版 Tor 实现（SOCKS 运行时） |
| ArtiHop | 2（Guard→Exit） | 否 | 网桥/PT | 延迟更低，匿名性较弱 |
当你需要国家固定、中继固定或控制端口 New Identity 时，请使用 Classic。当你希望使用 Rust 运行时且不需要这些 Classic 专属控制项时，请使用 Arti 或 ArtiHop。
在本地运行 Tor，并将操作系统代理设置为 Tor 的 SOCKS5 端点。无需管理员权限。你可以在不断开 Tor 的情况下关闭系统代理。
运行 Tor + sing-box，并在操作系统层面路由流量（Windows 上使用 Wintun，macOS/Linux 上使用系统 TUN）。需要管理员权限。抗泄漏能力最强。
仅在 TUN/VPN 模式下可用——将选定的应用通过 Tor 路由，而其他应用保持直连。
CLI 无需桌面环境即可运行，例如在与你家庭网络共享 Tor 的 Raspberry Pi 上。在 64 位操作系统上使用 linux-arm64，在 32 位操作系统上使用 linux-arm（Pi 2 及更新型号）；dpkg --print-architecture 会输出 arm64 或 armhf。它需要 Debian 12/13 或类似发行版（glibc 2.35+、ca-certificates）。
sudo mkdir -p /opt/onionhop
sudo tar -xzf OnionHopCLI-<version>-linux-arm.tar.gz -C /opt/onionhop
/opt/onionhop/OnionHopV3.Cli connect --proxy-scope local --lan on
connect 会持续运行，直到被停止。Ctrl+C、SIGTERM（systemd、Docker、kill）和 SIGHUP（SSH 会话关闭）都会干净地断开连接并停止 Tor。--proxy-scope local 不修改系统代理，而无头机器本来就没有系统代理。--lan on 监听所有网络接口，而不是 127.0.0.1，并打印其他设备应使用的 SOCKS 和 HTTP 地址。任何能访问这些端口的人都可以使用它们，因此在路由器上应在面向互联网的接口上阻止这些端口。要在启动时运行它，请创建 /etc/systemd/system/onionhop.service：
[Unit]
Description=OnionHop (Tor with Smart Connect)
Wants=network-online.target
After=network-online.target
[Service]
User=onionhop
ExecStart=/opt/onionhop/OnionHopV3.Cli connect --proxy-scope local --lan on
# Only the CLI gets SIGTERM, so it stops Tor itself before exiting.
KillMode=mixed
TimeoutStopSec=30
Restart=on-failure
RestartSec=30
[Install]
WantedBy=multi-user.target
sudo useradd --system --create-home --home-dir /var/lib/onionhop onionhop
sudo systemctl daemon-reload
sudo systemctl enable --now onionhop
journalctl -u onionhop -f
设置和 Smart Connect 对您网络的记忆保存在服务用户的 ~/.config/OnionHop 中，Tor 及其状态保存在 ~/.local/share/OnionHop 中。
设置和运行时数据位于操作系统的应用程序数据文件夹中，例如 %AppData%\OnionHop\settings.json（Windows）或 ~/Library/Application Support/OnionHop/（macOS）。
先决条件：
获取运行时依赖项（Tor、可插拔传输、sing-box、Wintun、ArtiHop、Snowflake 代理）：
# Windows
powershell -NoProfile -ExecutionPolicy Bypass -File download-deps.ps1
# Linux (this machine's architecture, or pass x64, arm64 or arm)
./download-deps.sh
对于 arm64 和 arm，Tor（包含 OpenSSL、libevent 和 zlib）以及传输工具均从源码构建，因为 Tor Project 不发布稳定的 Linux ARM 捆绑包。这需要 Go，以及在 x86_64 机器上构建时所需的交叉编译器（gcc-aarch64-linux-gnu 或 gcc-arm-linux-gnueabihf）。
构建并运行：