Pular para o conteúdo

Solução de problemas

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

"spawn tmux ENOENT"

tmux não está instalado ou não está no seu PATH. Termbridge exibe esse erro, mas continua em execução sem disponibilizar um terminal (#4); pressione Ctrl+C, instale tmux e inicie novamente.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

O cliente de túnel de Cloudflare não está instalado ou não está no seu PATH. Ele só é necessário para o modo de túnel; --no-tunnel e Daytona no modo direto não precisam de cloudflared.

Shell
# macOS
brew install cloudflared

Para Linux, baixe em cloudflare.com/downloads.

O túnel não inicia

Confira alguns pontos (ignore esta etapa se estiver usando o modo direto de sandbox):

  1. Verifique se cloudflared funciona: cloudflared --version
  2. Verifique se você consegue acessar https://trycloudflare.com
  3. Confira se um firewall está bloqueando conexões de saída

Se o túnel não iniciar, Termbridge exibe o erro, interrompe o servidor e sai com o status 1. Ele não muda para o modo somente local, e o servidor escuta apenas em 127.0.0.1 por padrão, portanto outros dispositivos na sua rede também não conseguem acessá-lo. As sessões tmux criadas nessa execução continuam em execução (#4).

Para usar Termbridge sem o túnel Cloudflare, execute-o com --no-tunnel --public-url <url> atrás do seu próprio proxy reverso ou túnel.

"429 Muitas solicitações" do trycloudflare

Cloudflare limita a taxa de túneis sem conta. Se você vir erros como 429 Too Many Requests, tente:

  1. Aguarde alguns minutos e tente novamente
  2. Verifique se não há processos antigos de cloudflared ainda em execução
  3. Use um token de túnel nomeado (recomendado para uso frequente)

Tela em branco ou "Não foi possível carregar os terminais"

Isso geralmente significa que o navegador não tem um cookie de sessão válido, por exemplo, porque foi aberto sem resgatar um link de compartilhamento ou porque o URL do túnel mudou:

  1. Verifique se o servidor local ainda está em execução
  2. Procure erros de 401/403 no console do navegador
  3. Reinicie Termbridge para obter um novo código de URL e QR

Nenhuma saída no terminal

A sessão tmux pode não estar em execução:

Shell
# Check if sessions exist
tmux ls

Se as sessões aparecerem, mas o terminal estiver em branco, tente:

  • Recarregar a página
  • Verificar se seu shell é compatível com TERM=xterm-256color

O código QR é lido, mas a página fica em branco

O código QR contém um token de uso único. Ele funciona uma vez e somente nos 90 segundos após Termbridge iniciar. Um link usado ou expirado retorna invalid token.

Solução: reinicie Termbridge para gerar um novo código de QR e leia-o imediatamente.

Erros de node-pty sobre spawn-helper

Termbridge tenta corrigir isso automaticamente, mas, se você vir erros de permissão:

Shell
chmod +x node_modules/node-pty/prebuilds/**/spawn-helper

Ainda está com problemas?

Abra uma issue em github.com/inline0/termbridge com:

  • Seu sistema operacional e a versão do Node.js
  • A mensagem de erro
  • As etapas para reproduzir o problema