Pular para o conteúdo

Túneis nomeados

Ver como Markdown Editar no GitHub Documentação em 1675df8

Por padrão, Termbridge usa os Quick Tunnels sem conta de Cloudflare (trycloudflare.com). Eles são práticos, mas o uso intenso pode estar sujeito a limites de taxa.

Se você usa Termbridge com frequência, configure um túnel nomeado com sua conta Cloudflare.

Por que usar um túnel nomeado?

  • Sem limites de taxa: os Quick Tunnels podem retornar erros 429 com uso intenso
  • URL consistente: obtenha um subdomínio estável em vez de sequências aleatórias
  • Domínio personalizado: use seu próprio domínio, como term.example.com
  • Mais confiabilidade: túneis nomeados são mais estáveis em sessões longas

Configuração

1. Crie uma conta Cloudflare

Cadastre-se em cloudflare.com se ainda não tiver uma conta.

2. Crie um túnel no Zero Trust

  1. Acesse Cloudflare Zero Trust
  2. Navegue até Networks → Tunnels
  3. Clique em Create a tunnel
  4. Escolha Cloudflared como conector
  5. Dê um nome ao túnel (por exemplo, e.g., termbridge)
  6. Copie o token do túnel

3. Adicione um nome de host público

  1. Nas configurações do túnel, acesse Public Hostname
  2. Adicione um nome de host que aponte para http://localhost:8080 (ou para a porta escolhida)
  3. Use um subdomínio como term.example.com

4. Execute Termbridge com seu token

Shell
termbridge --port 8080 --tunnel-token <TOKEN> --tunnel-url https://term.example.com

Ou use variáveis de ambiente:

Shell
export TERMBRIDGE_TUNNEL_TOKEN=<TOKEN>
export TERMBRIDGE_TUNNEL_URL=https://term.example.com

termbridge --port 8080

Observação A opção --port é obrigatória com túneis nomeados, pois o nome de host está configurado para apontar para uma porta específica.

Opções de configuração

Opção Variável de ambiente Descrição
--port <port> - Porta local (obrigatória com túneis nomeados)
--tunnel-token <token> TERMBRIDGE_TUNNEL_TOKEN Seu token de túnel
--tunnel-url <url> TERMBRIDGE_TUNNEL_URL Seu nome de host público URL

Desativar completamente o túnel

Se você tiver seu próprio proxy reverso ou URL público:

Shell
termbridge --no-tunnel --public-url https://your-server.com

Ou:

Shell
export TERMBRIDGE_TUNNEL=none
export TERMBRIDGE_PUBLIC_URL=https://your-server.com

termbridge

Termbridge não iniciará um túnel e usará o URL fornecido para o código QR.

Solução de problemas

"429 Too Many Requests"

Isso significa que os Quick Tunnels estão sujeitos a limites de taxa. Soluções:

  1. Aguarde alguns minutos e tente novamente
  2. Encerre quaisquer processos cloudflared obsoletos: pkill cloudflared
  3. Mude para um túnel nomeado (recomendado)

O túnel inicia, mas URL não funciona

  • Verifique se o nome de host em Cloudflare corresponde a --tunnel-url
  • Confira se a porta em Cloudflare corresponde a --port
  • Certifique-se de que cloudflared esteja atualizado: cloudflared update

O túnel nomeado não conecta

  • Verifique se o token está correto
  • Confira se há erros no painel de Cloudflare Zero Trust
  • Tente executar cloudflared tunnel run <TOKEN> diretamente para ver as mensagens de erro