OnionHop V2

OnionHop V2 is a modern Windows app that routes your traffic through Tor using either:

• Proxy Mode (recommended): sets the Windows proxy to Tor's local SOCKS5 endpoint.
• TUN/VPN Mode (Admin): starts a system-wide tunnel via sing-box + Wintun.

V2 adds a redesigned UI and stronger routing controls (including per-app split tunneling in Hybrid mode).

Disclaimer OnionHop is provided "as-is". Tor usage can be illegal or restricted in some jurisdictions. You are responsible for complying with local laws and regulations.

---

Getting Started (User)

1. Install

   • Download the latest release from Releases.
   • Run the Windows installer (OnionHop-Setup-<version>.exe).

2. Choose a mode

   • Proxy Mode (no admin): Best compatibility for proxy-aware apps.
   • TUN/VPN Mode (admin): System-wide routing via sing-box + Wintun; needed for apps that ignore proxy settings.

3. Connect

   • Optionally choose an Exit Location (and optional Entry Node in Advanced settings).
   • Enable Bridges if your network blocks Tor (snowflake/obfs4/meek/webtunnel/custom).
   • Click Connect.

Notes

• Kill Switch works only in strict TUN (Hybrid off) and needs admin rights to add/remove firewall rules.
• .onion sites require a Tor-aware client (Tor Browser recommended) or SOCKS remote DNS (e.g., Firefox "Proxy DNS when using SOCKS v5").

---

Features (Core)

• Tor routing (SOCKS5)
• System proxy mode (no admin required)
• TUN/VPN mode via sing-box + Wintun (admin required)
• Hybrid routing + split tunneling (Hybrid mode)
• Tor bridges / pluggable transports (automatic, obfs4, snowflake, conjure, meek-azure, webtunnel, custom)
• Kill Switch (strict TUN only)
• Start with Windows (optional) + start minimized
• Minimize-to-tray option on close
• Auto-update checks via GitHub releases
• Logs (App + DNS) and diagnostics
• Optional Discord status + launch-page automation

---

Modes explained

1) Proxy Mode (Recommended)

• Starts Tor locally.
• Sets Windows proxy to socks=127.0.0.1:9050.
• No admin required.

2) TUN/VPN Mode (Admin)

• Starts Tor + sing-box + Wintun.
• Routes traffic at OS level.
• Requires Administrator.

Hybrid (Split tunneling)

• Only applies in TUN/VPN Mode.
• Lets you route selected apps through Tor while keeping others direct.

---

Settings storage

OnionHop stores settings here:

• %AppData%\\OnionHop\\settings.json

---

Repository layout

• OnionHop/ - OnionHop V2 (Avalonia UI)
• OnionHop/src/OnionHopV2.Cli - OnionHop V2 command-line interface

---

Building (Dev)

Build the V2 installer (Windows)

Prereqs:

• .NET SDK 9
• Inno Setup 6

Build:

powershell -NoProfile -ExecutionPolicy Bypass -File installer/build-installer-v2.ps1

Output:

• installer/output/OnionHop-Setup-<version>.exe

Build the V2 portable ZIP (Windows)

Build:

powershell -NoProfile -ExecutionPolicy Bypass -File installer/build-portable-v2.ps1

Output:

• installer/output/OnionHopV2-Portable-<version>-win-x64.zip

Build the CLI installer (Windows)

Build:

powershell -NoProfile -ExecutionPolicy Bypass -File installer/build-installer-cli.ps1

Output:

• installer/output/OnionHop-CLI-Setup-<version>.exe

Build the CLI portable ZIP (Windows)

Build:

powershell -NoProfile -ExecutionPolicy Bypass -File installer/build-portable-cli.ps1

Output:

• installer/output/OnionHopCLI-Portable-<version>-win-x64.zip

Run CLI (Dev)

dotnet run --project "OnionHop/src/OnionHopV2.Cli" -c Release