# Túneis nomeados

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](https://cloudflare.com) se ainda não tiver uma conta.

### 2. Crie um túnel no Zero Trust

1. Acesse [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
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

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

Ou use variáveis de ambiente:

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

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

Ou:

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