Como configurar uma bridge Tor com obfs4 em um VPS
Configure uma bridge Tor com obfs4 em um VPS barato: veja diretivas do torrc, porta, firewall, logs de validação e como usuários obtêm sua bridge.
O que é uma bridge Tor e por que ela existe
Uma bridge Tor é um ponto de entrada na rede Tor cujo endereço não é publicado na lista pública de relays. Essa lista, chamada de consenso, é um documento assinado que qualquer pessoa pode baixar, inclusive um censor. Bloquear o Tor a partir dela leva uma tarde: baixe o consenso e bloqueie todos os endereços nele contidos na fronteira da rede. As bridges existem porque a lista publicada é o ponto fraco. Os endereços das bridges são distribuídos em pequenas quantidades, para que nenhuma solicitação entregue o conjunto completo.
Um endereço não listado resolve apenas metade do problema. A inspeção profunda de pacotes (DPI), que classifica o tráfego pelo conteúdo em vez do endereço, reconhece uma conexão Tor pelo formato do handshake TLS (segurança da camada de transporte). Um censor sem a lista ainda pode identificar que “isso parece Tor” e bloquear a conexão. Um transporte plugável remove esse sinal. No lado do cliente, ele encapsula o fluxo Tor em outro protocolo, e a sua bridge remove esse encapsulamento.
obfs4 é o transporte executado pela maioria das bridges. Ele transforma o fluxo em bytes sem cabeçalho e sem handshake fixo, para que a DPI não tenha um padrão para identificar. Ele também autentica o cliente. O valor cert= dentro de uma linha de bridge é uma chave que o cliente precisa provar que possui antes de a bridge responder. Isso impede sondagens ativas: um censor que se conecta ao seu endereço para testar se ele fala Tor não recebe resposta e não obtém nenhuma informação.
Que transporte conectável deve executar?
- obfs4 precisa de 1 VPS, 2 portas TCP e não precisa de um nome de domínio. É a opção útil mais fácil de executar e é o tema deste guia.
- WebTunnel oculta a ligação dentro de tráfego HTTPS normal destinado a um site real. O Tor Project lista como requisitos um endereço IPv4 estático, quando possível, um domínio que controla, um servidor Web funcional, como NGINX ou Apache, um certificado TLS válido e pelo menos 1 GB de RAM, com 4 GB recomendados. É adequado para redes onde o tráfego com aparência aleatória é suspeito por si só, porque um país que permite pouco além da navegação Web continua a permitir HTTPS.
- Snowflake é uma contribuição diferente. Os voluntários executam proxies WebRTC de curta duração. Por isso, os pontos de entrada mudam constantemente e não existe um endereço estável que um censor possa bloquear. Não opera uma bridge para este transporte. Executa um proxy, que não precisa de um endereço fixo.
Comece com obfs4. Pode adicionar uma bridge WebTunnel mais tarde, num segundo endereço. Executar ambos no mesmo IP significa que um único endereço bloqueado desativa os dois.
Quanto custa operar uma bridge?
Os dados por trás deste gráfico
[
{
"label": "Bridge, minimum",
"min_upstream_mbit": 1
},
{
"label": "Guard or middle relay, minimum",
"min_upstream_mbit": 10
},
{
"label": "Guard or middle relay, recommended",
"min_upstream_mbit": 16
}
]Em outubro de 2026, o Tor Project exige que uma bridge tenha pelo menos 1 Mbit/s de largura de banda de upstream e downstream. Para um relay guard ou middle, o requisito é de 10 Mbit/s, com 16 Mbit/s recomendados. Estes são requisitos publicados, não medições. Uma bridge nova normalmente fica muito abaixo do seu próprio mínimo durante semanas. A mesma página de requisitos pede pelo menos 100 GByte de tráfego de saída por mês a um relay, volume que os planos mais pequenos já cobrem. Por isso, leia quanto custa realmente uma VPS pequena por mês antes de escolher um plano maior.
A superfície de abuso é pequena, e é aqui que muitas pessoas se enganam. Uma bridge é o primeiro salto. O tráfego que sai do seu servidor vai para outro relay Tor, nunca para um site escolhido pelo utilizador. O seu endereço IP nunca aparece num log web de terceiros como origem de um pedido. Por isso, as mensagens de reclamação tratadas pelos operadores de relays de saída não chegam aqui. Consulte ainda a política de utilização aceitável do seu fornecedor, porque alguns hosts tratam qualquer serviço Tor como um caso especial. Uma bridge e um serviço onion são imagens opostas neste aspeto: uma bridge só é útil porque o seu endereço é acessível e acaba por ser distribuído, enquanto um serviço onion v3 numa VPS do mesmo tipo pode manter o seu IP público completamente oculto.
Há uma coisa que não deve fazer: converter um relay público existente numa bridge no mesmo endereço. A recomendação do Tor Project para esse caso é alterar o "IP address, name and fingerprint", porque o endereço antigo já está no consenso que os censores descarregam. Uma bridge que foi um relay público na semana passada já está numa lista de bloqueio.
A disponibilidade é mais importante do que a velocidade. Os requisitos dos relays dizem que "if your relay is not running for more than 2 hours a day its usefulness is limited". Neste aspeto, uma bridge está em pior situação do que um relay, porque o cliente só conhece as bridge lines que recebeu. O Tor Browser aceita várias, uma por linha, mas quando todas deixam de responder o utilizador tem de pedir novas bridge lines. Um reinício remove todos os utilizadores da sua bridge. Configure uma verificação de porta TCP no Uptime Kuma para a porta obfs4, para saber no próprio dia quando ela deixar de responder.
Instale o Tor a partir do repositório do Tor Project
Os pacotes da distribuição ficam desatualizados, e uma bridge é software de segurança que deve estar atualizada. Adicione primeiro o repositório do próprio projeto.
sudo apt update
sudo apt install -y apt-transport-https gnupg wget lsb-release
wget -qO- https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --dearmor | sudo tee /usr/share/keyrings/deb.torproject.org-keyring.gpg >/dev/nullAgora escreva o ficheiro de origem. A linha Suites: deve conter o codename da sua release. Leia-o do sistema em vez de o introduzir de memória.
sudo tee /etc/apt/sources.list.d/tor.sources >/dev/null <<EOF
Types: deb deb-src
URIs: https://deb.torproject.org/torproject.org/
Suites: $(lsb_release -cs)
Components: main
Signed-By: /usr/share/keyrings/deb.torproject.org-keyring.gpg
EOF
sudo apt update
sudo apt install -y tor deb.torproject.org-keyring obfs4proxySe apt update indicar que o repositório não tem um ficheiro Release para o seu codename, o Tor Project não disponibiliza pacotes para essa release. Apague /etc/apt/sources.list.d/tor.sources, execute sudo apt update novamente e instale o pacote tor disponibilizado pela sua distribuição. Tudo o que se segue é idêntico.
O pacote obfs4proxy é disponibilizado pelo próprio Debian e Ubuntu (versão 0.0.14 no Debian 13, em outubro de 2026). Confirme onde o binário foi instalado, porque o caminho será usado na configuração:
command -v obfs4proxy || command -v lyrebirdO projeto upstream mudou o nome para lyrebird, por isso um pacote mais recente pode instalar /usr/bin/lyrebird. Use o caminho apresentado por esse comando.
Configure a bridge em /etc/tor/torrc
BridgeRelay 1
ORPort 8443
ServerTransportPlugin obfs4 exec /usr/bin/obfs4proxy
ServerTransportListenAddr obfs4 0.0.0.0:9443
ExtORPort auto
ContactInfo you@example.com
Nickname PickANickname
BridgeDistribution anyCada uma dessas linhas está associada a uma possível falha, por isso analise-as uma de cada vez.
BridgeRelay 1 indica ao tor que deve enviar o seu descritor para a bridge authority em vez de o publicar no consenso público. Esta única linha é o que torna o relay não listado.
ORPort é a porta Tor real. Tem de ser acessível a partir da internet, porque o tor testa essa porta e recusa publicar um descritor até o teste passar.
ServerTransportPlugin fornece ao tor o comando a executar. O tor inicia o obfs4proxy como processo filho e comunica com ele através de um pipe, por isso o obfs4proxy não tem uma unit própria. Ainda aparece em systemctl status tor@default, listado no CGroup dessa unit junto do próprio tor.
ServerTransportListenAddr fixa a porta em que o obfs4proxy escuta. Se omitir esta linha, o obfs4proxy escolhe uma porta livre ao iniciar. Na maioria dos reinícios, escolhe outra porta. Assim, cada bridge line que já distribuiu aponta para uma porta onde nada está a escutar. Esses clientes recebem uma ligação recusada e deixam de tentar.
ExtORPort auto abre a ORPort estendida, um canal de loopback que o obfs4proxy usa para devolver ao tor as ligações concluídas juntamente com o endereço do cliente. O guia de configuração do Tor Project inclui esta linha em todas as bridges, porque sem ela o transporte não consegue comunicar esse endereço ao tor.
ContactInfo e Nickname são ambos públicos. Use um endereço que consulte regularmente, porque é através dele que o Tor Project o contacta sobre uma bridge com problemas. Escolha também um nickname que não o identifique, se preferir não chamar atenção.
BridgeDistribution escolhe qual distribuidor fornece o seu endereço aos utilizadores. Os valores aceites são https, email, telegram, settings, none e any. Use any para a primeira bridge e deixe o sistema decidir. Use none para uma bridge privada que distribuirá por conta própria. Assim, o endereço fica completamente fora da distribuição pública.
Por que a escolha da porta é importante
Evite usar 9001 para ambas as portas. O Tor Project afirma isso diretamente, porque 9001 é a ORPort tradicional e os censores fazem varreduras à internet à procura dela. As duas portas também têm de ser diferentes, porque o tor e o obfs4proxy fazem bind nos respetivos listeners.
A porta obfs4 mais forte é 443. O tráfego de saída para 443 está permitido em quase todas as redes restritas. Assim, um filtro que permita pouco mais do que portas web continuará a permitir esta porta. A porta não disfarça o protocolo: o tráfego obfs4 continua a parecer dados aleatórios, não HTTPS. Fazer uma ligação parecer acesso a um site é a função do WebTunnel. Fazer bind numa porta inferior a 1024 requer um passo adicional, porque o obfs4proxy não é executado como root:
sudo setcap cap_net_bind_service=+ep /usr/bin/obfs4proxy
sudo systemctl edit tor@.service tor@default.serviceAdicione estas duas linhas em cada editor que abrir:
[Service]
NoNewPrivileges=noA capability, por si só, não é suficiente. O NoNewPrivileges do systemd impede que um processo obtenha privilégios que o processo pai não tinha. Uma file capability é exatamente isso. Por isso, o obfs4proxy falha ao fazer bind na porta 443 enquanto essa configuração estiver ativa.
Se preferir não executar esse passo, escolha uma porta alta e pouco habitual e anote-a. Seja qual for a sua escolha, não altere a porta obfs4 mais tarde. Uma bridge line associa o endereço, a porta, o fingerprint e o certificado. Por isso, todas as cópias já presentes no browser de um utilizador deixam de funcionar no momento em que a porta muda.
Abra as portas nas duas firewalls
sudo ufw allow 8443/tcp
sudo ufw allow 9443/tcp
sudo ufw statusAs duas portas precisam de estar abertas, e a maioria dos fornecedores executa uma segunda firewall no painel de controlo, que o ufw desconhece. Uma regra que existe no servidor, mas não no painel, cria uma bridge que nunca fica acessível e nunca publica um descritor. Se alguma destas partes for nova para si, as regras do ufw necessárias num VPS novo e o que uma porta em escuta realmente é no Linux explicam o assunto. Aproveite também para proteger o SSH com chaves e uma configuração reforçada do sshd. Uma bridge não listada num servidor com SSH por palavra-passe continua a ser um servidor com SSH por palavra-passe.
Inicie-o e leia o log
sudo systemctl enable --now tor.service
sudo systemctl restart tor.service
sudo journalctl -e -u tor@defaultDebian e Ubuntu fornecem duas unidades. tor.service é um wrapper pequeno e tor@default.service é o processo que executa o trabalho. Por isso, journalctl -u tor parece quase vazio, enquanto o log pretendido está em tor@default.
Duas linhas confirmam que funcionou:
Self-testing indicates your ORPort is reachable from the outside. Excellent. Publishing server descriptor.
Registered server transport 'obfs4' at '0.0.0.0:9443'A primeira indica que o teste de acessibilidade foi concluído com êxito e que o descritor foi enviado à autoridade bridge. Se essa linha nunca aparecer, algo entre a Internet e o servidor está a descartar tráfego destinado à ORPort. A segunda linha deve mostrar a porta configurada. Se indicar outra porta, tor não aplicou ServerTransportListenAddr. A causa habitual é um nome de transporte diferente: deve aparecer como obfs4 em ambas as diretivas.
Confirme que os dois listeners existem:
sudo ss -lntp | grep -E 'tor|obfs4|lyrebird'Onde está a minha linha de bridge?
O obfs4proxy escreve um modelo no diretório de dados do tor:
sudo cat /var/lib/tor/pt_state/obfs4_bridgeline.txtEsse diretório pertence ao utilizador tor e tem o modo 700. Sem sudo, é apresentada a mensagem Permission denied. O ficheiro contém uma linha neste formato:
Bridge obfs4 <IP ADDRESS>:<PORT> <FINGERPRINT> cert=<CERTIFICATE> iat-mode=0Substitua <IP ADDRESS> pelo endereço público do seu servidor, <PORT> pela porta do obfs4, e não pela ORPort, e <FINGERPRINT> pela impressão digital da identidade que o tor escreveu no diretório de dados:
sudo cat /var/lib/tor/fingerprint
sudo cat /var/lib/tor/hashed-fingerprintO primeiro ficheiro contém o seu nickname e a impressão digital da identidade que devem aparecer numa linha de bridge. O segundo contém a impressão digital com hash. É esse valor que deve colar no Relay Search para verificar se o seu bridge está em execução e obter uma estimativa do número de clientes que o alcançam. Os dois valores não são intercambiáveis. Uma linha de bridge que contenha o valor com hash não corresponde à chave de identidade apresentada pelo seu bridge. Por isso, o cliente rejeita a ligação que acabou de abrir.
Como uma bridge chega efetivamente aos utilizadores?
Não entregue a linha da sua bridge a qualquer pessoa. Depois de o descritor chegar à autoridade de bridges, o sistema de distribuição (rdsys, o sucessor do BridgeDB) atribui a sua bridge a um distribuidor, e os utilizadores pedem bridges a esse distribuidor. Em outubro de 2026, as opções são estas:
- O site de bridges em bridges.torproject.org/options, onde "Just give me bridges!" devolve imediatamente linhas obfs4. Não existe captcha: o Tor Project removeu-o quando o rdsys substituiu o BridgeDB, numa alteração anunciada em dezembro de 2024.
- Enviar um email para bridges@torproject.org a partir de um endereço Gmail ou Riseup. O serviço responde com linhas de bridges. A restrição aos fornecedores existe porque contas gratuitas ilimitadas permitiriam que um censor enumerasse todas as bridges.
- O bot do Telegram @GetBridgesBot. Envie
/starte, depois,/obfs4ou/webtunnel. - O próprio Tor Browser, em Settings e depois Connection, onde "Request bridges" as obtém através do canal moat.
Uma bridge nova aparece no Relay Search cerca de três horas depois da configuração. Os utilizadores demoram muito mais tempo: a formulação do próprio Tor Project é que "It can take several days or weeks until you see a consistent set of users." É normal não haver atividade significativa durante as primeiras duas semanas. Isso não indica uma falha.
Definir BridgeDistribution none exclui a bridge de todos estes mecanismos. Nesse caso, cabe-lhe enviar a linha da bridge às pessoas que precisam dela, através de um canal que o censor não esteja a monitorizar.
Quando algo não funciona
Não há uma linha de autoteste no log. A ORPort não está acessível. Teste-a a partir de outra máquina com nc -vz your.ip 8443. Se a ligação ficar bloqueada, os pacotes estão a ser descartados; verifique o ufw e o painel do fornecedor. Se houver recusa, o tor não está a escutar; verifique ss -lntp e procure no log um erro de configuração.
O transporte registado mostra uma porta que não escolheu. O tor ignorou ServerTransportListenAddr. O nome do transporte tem de corresponder exatamente ao nome em ServerTransportPlugin, e ambos têm de estar definidos como obfs4.
O obfs4proxy não consegue associar-se à porta 443. Confirme a capacidade com getcap /usr/bin/obfs4proxy e, em seguida, confirme se a substituição chegou à unidade com systemctl show tor@default -p NoNewPrivileges. Se esse comando imprimir NoNewPrivileges=yes, o seu drop-in foi aplicado a uma unidade que não está em execução.
Nada dentro de /var/lib/tor/pt_state/. O tor nunca iniciou o transporte, o que significa que o caminho em ServerTransportPlugin está incorreto. Compare-o com a saída de command -v obfs4proxy.
Os clientes deixaram de se ligar depois de uma alteração. Qualquer alteração ao endereço ou à porta obfs4 invalida todas as linhas de bridge já distribuídas. Verifique também se o IP público do servidor mudou, o que acontece durante uma reconstrução com alguns fornecedores.
O tor não inicia de todo. Execute sudo -u debian-tor tor --verify-config -f /etc/tor/torrc. O comando analisa o ficheiro, mostra a linha que causou o erro e deixa o serviço em execução inalterado.
FAQ
O meu fornecedor de VPS vai reclamar de uma bridge Tor?
Uma bridge é um ponto de entrada, por isso o tráfego que sai do servidor vai para outros relays Tor e nunca para um site escolhido pelo utilizador. O seu endereço IP não aparece no log web de ninguém como origem de um pedido. É isso que gera as reclamações com que os operadores de relays de saída lidam. As regras de alojamento continuam a variar, e alguns fornecedores tratam qualquer serviço Tor como um caso especial. Por isso, leia a política de utilização aceitável antes de começar e coloque um endereço que tenha consultado em ContactInfo.
Quanta largura de banda usa uma bridge Tor?
O mínimo publicado é de 1 Mbit/s de entrada e de saída, face a 10 Mbit/s para um relay guard ou middle. O uso real começa perto de zero, porque a sua bridge só transporta tráfego dos utilizadores que um distribuidor lhe encaminha. Se quiser definir um limite máximo, configure RelayBandwidthRate e RelayBandwidthBurst em torrc.
Porque é que ninguém se ligou à minha bridge nova?
Uma bridge demora cerca de três horas a aparecer no Relay Search, e as orientações do Tor Project indicam que um conjunto consistente de utilizadores demora vários dias ou semanas a formar-se. Verifique se o descritor foi publicado, o que corresponde à linha de autoteste em journalctl -u tor@default, procure a sua impressão digital com hash no Relay Search e confirme que BridgeDistribution não está definido como none.
Devo executar obfs4 ou WebTunnel?
Execute obfs4 se esta for a sua primeira bridge: uma VPS, duas portas, sem domínio e sem certificado. Use WebTunnel quando o tráfego com aparência aleatória também estiver bloqueado, pois precisa de um domínio que controle, de um servidor web real, de um certificado TLS válido e de pelo menos 1 GB de RAM. Coloque-os em endereços separados se executar ambos, porque, caso contrário, um único IP bloqueado removeria duas bridges de uma só vez.
O que acontece se eu alterar a porta obfs4 mais tarde?
Todas as linhas de bridge já distribuídas deixam de funcionar. Uma linha de bridge associa o endereço, a porta, a impressão digital e o certificado. Assim, um cliente que tenha a linha antiga abre uma ligação para uma porta onde nada está à escuta e desiste. O mesmo se aplica quando o IP público do servidor muda. Escolha a porta durante a configuração e não a altere.