# Túneles con nombre

De forma predeterminada, Termbridge usa los Quick Tunnels sin cuenta de Cloudflare (`trycloudflare.com`). Son prácticos, pero pueden tener límites de frecuencia si se usan mucho.

Si usas Termbridge con frecuencia, configura un túnel con nombre con tu cuenta de Cloudflare.

## ¿Por qué usar un túnel con nombre?

- **Sin límites de frecuencia**: con un uso intenso, los Quick Tunnels pueden devolver errores 429
- **URL coherente**: obtén un subdominio estable en lugar de cadenas aleatorias
- **Dominio personalizado**: usa tu propio dominio, como `term.example.com`
- **Mayor fiabilidad**: los túneles con nombre son más estables en sesiones largas

## Configuración

### 1. Crea una cuenta de Cloudflare

Regístrate en [cloudflare.com](https://cloudflare.com) si aún no tienes una.

### 2. Crea un túnel en Zero Trust

1. Ve a [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Ve a **Networks** → **Tunnels**
3. Haz clic en **Create a tunnel**
4. Elige **Cloudflared** como conector
5. Asigna un nombre al túnel (e.g, `termbridge`)
6. Copia el token del túnel

### 3. Añade un nombre de host público

1. En la configuración del túnel, ve a **Public Hostname**
2. Añade un nombre de host que apunte a `http://localhost:8080` (o al puerto que elijas)
3. Usa un subdominio como `term.example.com`

### 4. Ejecuta Termbridge con tu token

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

O usa variables de entorno:

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

termbridge --port 8080
```

> **Nota**
> La opción `--port` es obligatoria con túneles con nombre porque el nombre de host está configurado para apuntar a un puerto específico.


## Opciones de configuración

| Opción | Variable de entorno | Descripción |
|------|---------------------|-------------|
| `--port <port>` | - | Puerto local (obligatorio con túneles con nombre) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Tu token del túnel |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Tu nombre de host público URL |

## Desactivar completamente el túnel

Si tienes tu propio proxy inverso o URL público:

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

O bien:

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

termbridge
```

Termbridge omitirá el inicio de un túnel y usará el URL que proporciones para el código QR.

## Solución de problemas

### «429 Too Many Requests»

Esto significa que los Quick Tunnels tienen un límite de frecuencia. Soluciones:

1. Espera unos minutos y vuelve a intentarlo
2. Finaliza los procesos obsoletos de `cloudflared`: `pkill cloudflared`
3. Cambia a un túnel con nombre (recomendado)

### El túnel se inicia, pero URL no funciona

- Comprueba que el nombre de host en Cloudflare coincida con `--tunnel-url`
- Comprueba que el puerto en Cloudflare coincida con `--port`
- Asegúrate de que cloudflared esté actualizado: `cloudflared update`

### El túnel con nombre no conecta

- Comprueba que el token sea correcto
- Revisa si hay errores en el panel de Cloudflare Zero Trust
- Prueba a ejecutar `cloudflared tunnel run <TOKEN>` directamente para ver los mensajes de error