
OnionHop v3.7.6
隐私优先的桌面应用,通过Tor路由你的流量 - 匿名浏览变得简单
OnionHop V3
OnionHop V3 是一款现代化的跨平台桌面应用(Windows、macOS 和 Linux),可将你的流量通过 Tor 进行路由。它可以将 Tor 作为本地 SOCKS 代理或系统级隧道运行,通过 Smart Connect 自动为你的网络选择可用的连接策略,扫描并应用适用于受审查网络的各种传输方式的有效网桥,甚至还能让你自愿成为 Snowflake 代理。
免责声明 OnionHop 按“原样”提供。在某些司法管辖区,使用 Tor 可能违法或受到限制。你有责任遵守当地的法律法规。
V3 的新特性(自 v2.7 起)
V3 基于全新的跨平台 UI 技术栈从零重建,拥有更智能的连接引擎和更广泛的抗审查传输方式。
- 现已跨平台 — 为 Windows、macOS(已签名并公证的通用应用)和 Linux(AppImage)提供原生桌面构建。同一个应用,在每个操作系统上都有原生外观。
- 重新设计的 UI — Fluent/原生外观(FluentAvalonia)、浅色/深色/跟随系统主题、强调色选择器、Windows 上集成的无边框标题栏和 macOS 上的原生窗口边框,以及 8 种语言(英语、德语、法语、中文、俄语、波斯语、阿塞拜疆语和索拉尼库尔德语)。
- Smart Connect — 一个离线的审查“大脑”,可自动为你的网络和国家选择最佳连接策略:它知道 Tor 在哪里被封锁,优先选择能在那里存活的传输方式,预先测试网桥可达性,并行竞速多种策略,快速淘汰失效路径,并记住每个网络上有效的方案,使下次连接瞬间完成。
- 三种 Tor 引擎 — Classic(
tor.exe,完全控制:网桥、国家/入口/出口固定、控制端口 New Identity)、Arti(Rust 版 Tor 实现,支持原生网桥/PT 配置)和 ArtiHop(缩短的 2 跳 Guard→Exit 电路,降低延迟)。 - 更多抗审查传输方式 — obfs4、snowflake(可选 AMP 缓存前置)、webtunnel、conjure、meek 和 dnstt(一种 DNS 隧道,在仅允许 DNS 的情况下也能让 Tor 通过)。
- 网桥扫描器 — 获取并测试各种传输方式网桥的可达性,查看带颜色标记的延迟,一键应用在你网络上真正有效的网桥。
- 更多网桥来源 — 官方 Tor 网桥服务、抗审查的 OnionHop Bridges Collector(源自 Delta-Kronecker/Tor-Bridges-Collector)、内置社区网桥,以及薄集补充,使少量实时获取的网桥自动由捆绑网桥作为后备。
- 中继浏览器 — 按昵称、国家、角色、标志和带宽搜索实时 Tor 中继列表,并固定首选的入口/中间/出口节点。
- 命令行界面 — 功能齐全的 TUI(
OnionHopV3.Cli),带有实时状态仪表盘、connect/scan/bridges/snowflake/relays 命令和设置持久化。Windows、Linux 和 macOS 软件包由 CI 构建。 - 更强的泄漏防护 — 可选的完整 DNS-over-Tor、终止开关、TUN 模式下的 UDP 阻断,以及应用内的 WebRTC/UDP 隐私提示。
- 自愿成为 Snowflake 代理 — 直接从设置中帮助受审查用户访问 Tor。
- 体验优化 — 解耦的系统代理开关(可在 Tor 保持连接时关闭它)、可选的持久管理员助手以在 TUN 模式下跳过重复的 UAC 提示(默认关闭)、应用内更新日志,以及比特币捐赠。
下载
从 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 | 终端界面 |
| 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 运行时。
-
选择模式
- 代理模式(推荐,无需管理员): 在本地运行 Tor,并将操作系统系统代理指向 Tor 的本地 SOCKS5 端点。对支持代理的应用兼容性最佳。
- TUN/VPN 模式(管理员): 通过 sing-box 进行系统级路由(Windows 上为 Wintun,macOS/Linux 上为系统 TUN);适用于忽略代理设置的应用。抗泄漏(DNS 经 Tor,UDP 被阻断)。
-
连接
- 保持 Smart Connect 开启,让 OnionHop 自动选择最佳策略,或自行选择 Tor 引擎 / 出口位置 / 网桥。
- 在受审查网络中,启用 网桥 或打开 扫描器 以查找在你所在地区有效的网桥。
- 点击 连接。
注意事项
.onion站点需要支持 Tor 的客户端(推荐 Tor Browser)或 SOCKS 远程 DNS(例如 Firefox 的“使用 SOCKS v5 时代理 DNS”)。- 国家/中继固定和控制端口 New Identity 需要 Classic 引擎。Arti 和 ArtiHop 支持 OnionHop 网桥/PT 配置,但 Classic 仍是手动电路控制最完整的选择。
Tor 引擎
| 引擎 | 跳数 | 管理员 | 网桥 / 固定 / 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 的情况下关闭系统代理。
TUN/VPN 模式(管理员)
运行 Tor + sing-box,并在操作系统层面路由流量(Windows 上为 Wintun,macOS/Linux 上为系统 TUN)。需要管理员权限。抗泄漏能力最强。
混合模式(分流)
仅在 TUN/VPN 模式下可用 — 将选定的应用通过 Tor 路由,而其他应用保持直连。
权限
- 网络访问 — IP 检查、Onionoo 中继/国家数据、GitHub 发布元数据、网桥来源和依赖下载。
- 管理员 / root — 仅用于更改系统网络的功能:TUN/VPN 模式、终止开关或系统 DNS/代理更改。
- 文件夹访问 — 存储设置、日志、运行时数据、下载的 Tor/传输二进制文件、网桥缓存,以及你选择的任何日志导出位置。
设置和运行时数据位于操作系统的应用数据文件夹中,例如 %AppData%\OnionHop\settings.json(Windows)或 ~/Library/Application Support/OnionHop/(macOS)。
构建(开发)
前置条件:
- .NET SDK 9
- Inno Setup 6(Windows 安装程序)
- (可选) 用于构建 ArtiHop 引擎的 Rust 工具链,以及用于构建 Snowflake 代理 / webtunnel / dnstt 客户端的 Go — 这些由依赖脚本获取/构建;如果缺少某个工具链,该引擎/功能将被直接跳过。
获取运行时依赖(Tor、可插拔传输、sing-box、Wintun、ArtiHop、Snowflake 代理):
# Windows
powershell -NoProfile -ExecutionPolicy Bypass -File download-deps.ps1
# Linux
./download-deps.sh
构建并运行:
# Windows installer (self-contained, x64) -> installer/output/OnionHop-Setup-v3.exe
powershell -NoProfile -ExecutionPolicy Bypass -File installer/build-installer-v3.ps1
# Run from source
dotnet run --project OnionHop/src/OnionHopV3.App -c Release
ArtiHop 2 跳引擎从其独立的公开仓库 center2055/ArtiHop 构建 — 仅捆绑编译后的二进制文件;其源代码未随附。
许可证
Copyright (C) 2025 OnionHop Authors
本程序是自由软件:你可以根据自由软件基金会发布的 GNU 通用公共许可证条款(许可证第 3 版或(由你选择)任何更新版本)重新分发和/或修改它。
本程序的分发是希望它有用,但不提供任何担保;甚至不提供适销性或特定用途适用性的默示担保。有关更多详细信息,请参阅 GNU 通用公共许可证。
完整许可证文本见 LICENSE。
