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 构建 — 仅捆绑编译后的二进制文件；其源代码未随附。

许可证

本程序是自由软件：你可以根据自由软件基金会发布的 GNU 通用公共许可证条款（许可证第 3 版或（由你选择）任何更新版本）重新分发和/或修改它。

本程序的分发是希望它有用，但不提供任何担保；甚至不提供适销性或特定用途适用性的默示担保。有关更多详细信息，请参阅 GNU 通用公共许可证。

完整许可证文本见 LICENSE。

OnionHop

最受欢迎