# Solução de problemas

## "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](https://github.com/inline0/termbridge/issues/4)); pressione `Ctrl+C`, instale tmux e inicie novamente.

```bash
# 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.

```bash
# macOS
brew install cloudflared
```

Para Linux, baixe em [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/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](https://github.com/inline0/termbridge/issues/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:

```bash
# 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:

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

## Ainda está com problemas?

Abra uma issue em [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues) com:
- Seu sistema operacional e a versão do Node.js
- A mensagem de erro
- As etapas para reproduzir o problema