OnionHop V3

OnionHop V3 é um aplicativo moderno multiplataforma (Windows, macOS e Linux) que roteia seu tráfego através da Tor. Pode executar a Tor como um proxy SOCKS local ou como um túnel de sistema completo, escolher automaticamente uma estratégia de conexão funcional para sua rede com Smart Connect, escanear e aplicar pontes funcionais para redes censuradas em todos os transportes, e até permitir que você seja voluntário como proxy Snowflake.

Aviso Legal O OnionHop é fornecido "como está". O uso da Tor pode ser ilegal ou restrito em algumas jurisdições. Você é responsável por cumprir as leis e regulamentações locais.

Novidades na V3 (desde a v2.7)

A V3 é uma reconstrução completa em uma nova pilha de interface multiplataforma, com um mecanismo de conexão muito mais inteligente e um conjunto muito mais amplo de transportes resistentes à censura.

• Agora multiplataforma — versões nativas para desktop Windows, macOS (aplicativo universal assinado e notarizado) e Linux (AppImage). Mesmo aplicativo, aparência nativa em cada SO.
• Interface redesenhada — aparência Fluente/nativa (FluentAvalonia), temas claro/escuro/seguir-sistema, um seletor de cores, uma barra de título integrada sem bordas no Windows e janela nativa no macOS, e 8 idiomas (Inglês, Alemão, Francês, Chinês, Russo, Persa, Azerbaijano e Curdo Sorani).
• Smart Connect — um "cérebro" de censura offline que escolhe automaticamente a melhor estratégia de conexão para sua rede e país: sabe onde a Tor está bloqueada, prefere transportes que sobrevivem lá, testa previamente a acessibilidade das pontes, executa estratégias em paralelo, falha rapidamente em caminhos mortos e lembra o que funcionou em cada rede, para que a próxima conexão seja instantânea.
• Três mecanismos Tor — Classic (tor.exe, controle total: pontes, fixação de país/entrada/saída, Nova Identidade pela porta de controle), Arti (a implementação Tor em Rust com configuração nativa de ponte/PT) e ArtiHop (circuitos encurtados de 2 saltos Guarda→Saída para menor latência).
• Mais transportes resistentes à censura — obfs4, snowflake (com opção de fronting AMP-cache), webtunnel, conjure, meek, e dnstt (um túnel DNS que atravessa a Tor quando apenas DNS é permitido).
• Scanner de Pontes — busque e teste a acessibilidade de pontes de todos os transportes, veja latência colorida e aplique com um clique as que realmente funcionam na sua rede.
• Mais fontes de pontes — o serviço oficial de pontes da Tor, o Coletor de Pontes OnionHop resistente à censura (derivado do Delta-Kronecker/Tor-Bridges-Collector), pontes comunitárias integradas e um pequeno complemento para que uma busca ao vivo seja automaticamente complementada por pontes empacotadas.
• Navegador de Relés — pesquise a lista ao vivo de relés Tor por apelido, país, função, flags e largura de banda, e fixe uma entrada/intermediário/saída preferida.
• Interface de linha de comando — um TUI completo (OnionHopV3.Cli) com painel de status ao vivo, comandos connect/scan/bridges/snowflake/relays e persistência de configurações. Pacotes para Windows, Linux e macOS são gerados pela CI.
• Proteção contra vazamentos mais forte — opcional DNS completo via Tor, um kill switch, bloqueio de UDP no modo TUN e um aviso de privacidade WebRTC/UDP no aplicativo.
• Seja voluntário como proxy Snowflake — ajude usuários censurados a alcançar a Tor, diretamente das Configurações.
• Qualidade de vida — alternância desacoplada do proxy de sistema (desligue-o enquanto a Tor permanece conectada), um helper admin persistente opcional para pular repetidos prompts UAC no modo TUN (desligado por padrão), um changelog no aplicativo e doações em Bitcoin.

Baixar

Pegue a versão mais recente para sua plataforma em Releases:

O .dmg do macOS é publicado a partir do repositório dedicado e assinado de código rana-gmbh/onionhopMac.

Primeiros passos

1. Instale a versão para seu SO (acima). O instalador do Windows e os pacotes do macOS/Linux são autocontidos — o runtime .NET 9 está incluso.

2. Escolha um modo

   • Modo Proxy (recomendado, sem administrador): executa a Tor localmente e aponta o proxy de sistema para o endpoint SOCKS5 da Tor. Melhor compatibilidade para aplicativos que reconhecem proxy.
   • Modo TUN/VPN (administrador): roteamento de sistema via sing-box (Wintun no Windows, TUN do sistema no macOS/Linux); necessário para aplicativos que ignoram configurações de proxy. Resistente a vazamentos (DNS via Tor, UDP bloqueado).

3. Conecte

   • Deixe o Smart Connect ligado para que o OnionHop escolha automaticamente a melhor estratégia, ou escolha você mesmo um mecanismo Tor / Localização de Saída / Pontes.
   • Em uma rede censurada, ative as Pontes ou abra o Scanner para encontrar pontes que funcionam em sua região.
   • Clique em Conectar.

Notas

• Sites .onion requerem um cliente que reconheça Tor (navegador Tor recomendado) ou DNS remoto SOCKS (ex.: Firefox "Proxy DNS ao usar SOCKS v5").
• A fixação de país/relé e a Nova Identidade pela porta de controle exigem o mecanismo Classic. Arti e ArtiHop suportam configuração de ponte/PT do OnionHop, mas o Classic continua sendo a escolha mais completa para controle manual de circuito.

Mecanismos Tor

Use Classic quando precisar de fixação de país, fixação de relé ou Nova Identidade pela porta de controle. Use Arti ou ArtiHop quando quiser o runtime Rust e não precisar desses controles exclusivos do Classic.

Modos explicados

Modo Proxy (recomendado)

Executa a Tor localmente e define o proxy do sistema para o endpoint SOCKS5 da Tor. Não requer administrador. Você pode desligar o proxy de sistema sem desconectar a Tor.

Modo TUN/VPN (administrador)

Executa a Tor + sing-box e roteia o tráfego no nível do SO (Wintun no Windows, TUN do sistema no macOS/Linux). Requer Administrador. Mais resistente a vazamentos.

Híbrido (split tunneling)

Apenas no Modo TUN/VPN — roteie aplicativos selecionados através da Tor enquanto outros permanecem diretos.

Permissões

• Acesso à rede — verificações de IP, dados de relés/países do Onionoo, metadados de versões do GitHub, fontes de pontes e downloads de dependências.
• Administrador / root — apenas para funcionalidades que alteram a rede do sistema: Modo TUN/VPN, kill switch ou alterações de DNS/proxy do sistema.
• Acesso a pastas — armazenar configurações, logs, dados de runtime, binários baixados da Tor/transportes, cache de pontes e qualquer local de exportação de logs que você escolher.

Configurações e dados de runtime ficam nas pastas de dados de aplicativo do SO, ex.: %AppData%\OnionHop\settings.json (Windows) ou ~/Library/Application Support/OnionHop/ (macOS).

Compilando (Dev)

Pré-requisitos:

• .NET SDK 9
• Inno Setup 6 (instalador Windows)
• (opcional) toolchain Rust para compilar o mecanismo ArtiHop, e Go para compilar os clientes Snowflake proxy / webtunnel / dnstt — estes são obtidos/compilados pelos scripts de dependência; se uma toolchain estiver faltando, esse mecanismo/funcionalidade é simplesmente ignorado.

Buscar dependências de runtime (Tor, transportes plugáveis, sing-box, Wintun, ArtiHop, Snowflake proxy):

# Windows
powershell -NoProfile -ExecutionPolicy Bypass -File download-deps.ps1

# Linux
./download-deps.sh

Compilar e executar:

# Instalador Windows (autocontido, x64) -> installer/output/OnionHop-Setup-v3.exe
powershell -NoProfile -ExecutionPolicy Bypass -File installer/build-installer-v3.ps1

# Executar a partir do código-fonte
dotnet run --project OnionHop/src/OnionHopV3.App -c Release

O mecanismo ArtiHop de 2 saltos é compilado a partir de seu próprio repositório público, center2055/ArtiHop — apenas o binário compilado é empacotado; seu código-fonte não é incluído.