OnionHop V3

OnionHop V3 是一款现代化的跨平台桌面应用（支持 Windows、macOS 和 Linux），它能够通过 Tor 路由你的网络流量。它可以作为本地 SOCKS 代理或系统级隧道运行 Tor，通过 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，完全控制：网桥、国家/入口/出口固定、控制端口新身份）、Arti（Rust 实现的 Tor，支持原生网桥/PT 配置）和 ArtiHop（缩短为两跳 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），包含实时状态面板、连接/扫描/网桥/snowflake/中继命令以及设置持久化。Windows、Linux 和 macOS 包由 CI 自动构建。
• 更强的泄漏防护 — 可选的完全 DNS-over-Tor、终止开关、TUN 模式下的 UDP 拦截，以及应用内 WebRTC/UDP 隐私提示。
• 志愿成为 Snowflake 代理 — 在设置中直接帮助受审查用户连接 Tor。
• 便利功能 — 解耦系统代理开关（可在 Tor 保持连接时关闭代理）、可选的持久化管理员助手以跳过 TUN 模式下重复的 UAC 提示（默认关闭）、应用内更新日志以及比特币捐赠。

下载

从 Releases 获取你平台的最新构建：

macOS .dmg 从专门的签名仓库 rana-gmbh/onionhopMac 发布。

快速入门

1. 安装 适用于你操作系统的构建包（见上方）。Windows 安装程序以及 macOS/Linux 包均为独立运行 — 已捆绑 .NET 9 运行时。

2. 选择模式

   • 代理模式（推荐，无需管理员权限）： 本地运行 Tor，并将操作系统系统代理指向 Tor 的本地 SOCKS5 端点。对支持代理的应用兼容性最佳。
   • TUN/VPN 模式（需管理员权限）： 通过 sing-box 进行系统级路由（Windows 使用 Wintun，macOS/Linux 使用系统 TUN）；适用于忽略代理设置的应用。具有防泄漏功能（DNS 通过 Tor，UDP 被拦截）。

3. 连接

   • 保持 Smart Connect 开启，让 OnionHop 自动选择最佳策略，或者 自行选择 Tor 引擎 / 出口位置 / 网桥。
   • 在受限网络中，启用 网桥 或打开 扫描器 查找在你所在地区可用的网桥。
   • 点击 连接。

注意事项

• .onion 站点需要支持 Tor 的客户端（推荐 Tor 浏览器）或 SOCKS 远程 DNS（例如 Firefox 中的“通过 SOCKS v5 代理 DNS”）。
• 国家/中继固定和控制端口新身份需要 Classic 引擎。Arti 和 ArtiHop 支持 OnionHop 网桥/PT 配置，但 Classic 仍是手动电路控制最全面的选择。

Tor 引擎

当需要国家固定、中继固定或控制端口新身份时，请使用 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 安装程序（独立运行，x64）-> installer/output/OnionHop-Setup-v3.exe
powershell -NoProfile -ExecutionPolicy Bypass -File installer/build-installer-v3.ps1

# 从源码运行
dotnet run --project OnionHop/src/OnionHopV3.App -c Release

ArtiHop 两跳引擎从它自己的公共仓库 center2055/ArtiHop 构建 — 仅捆绑编译后的二进制文件；其源代码未包含在内。