# Tunnels nommés

Par défaut, Termbridge utilise les tunnels rapides Quick Tunnels de Cloudflare, sans compte (`trycloudflare.com`). Ils sont pratiques, mais une utilisation intensive peut entraîner des limites de débit.

Si vous utilisez souvent Termbridge, configurez un tunnel nommé avec votre compte Cloudflare.

## Pourquoi utiliser un tunnel nommé ?

- **Pas de limites de débit** : une utilisation intensive des Quick Tunnels peut entraîner des erreurs 429
- **URL stable** : obtenez un sous-domaine stable plutôt qu’une chaîne aléatoire
- **Domaine personnalisé** : utilisez votre propre domaine, comme `term.example.com`
- **Meilleure fiabilité** : les tunnels nommés sont plus stables lors des longues sessions

## Configuration

### 1. Créer un compte Cloudflare

Inscrivez-vous sur [cloudflare.com](https://cloudflare.com) si vous n’en avez pas.

### 2. Créer un tunnel dans Zero Trust

1. Accédez à [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Accédez à **Networks** → **Tunnels**
3. Cliquez sur **Create a tunnel**
4. Choisissez **Cloudflared** comme connecteur
5. Nommez votre tunnel (e.g., `termbridge`)
6. Copiez le jeton du tunnel

### 3. Ajouter un nom d’hôte public

1. Dans les paramètres du tunnel, accédez à **Public Hostname**
2. Ajoutez un nom d’hôte pointant vers `http://localhost:8080` (ou le port de votre choix)
3. Utilisez un sous-domaine comme `term.example.com`

### 4. Lancer Termbridge avec votre jeton

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

Ou utilisez des variables d’environnement :

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

termbridge --port 8080
```

> **Remarque**
> L’option `--port` est obligatoire avec les tunnels nommés, car le nom d’hôte est configuré pour pointer vers un port précis.


## Options de configuration

| Option | Variable d’environnement | Description |
|------|---------------------|-------------|
| `--port <port>` | - | Port local (obligatoire avec les tunnels nommés) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Votre jeton de tunnel |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Votre nom d’hôte public URL |

## Désactiver complètement le tunnel

Si vous disposez de votre propre proxy inverse ou d’une adresse URL publique :

```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 ignore le démarrage d’un tunnel et utilise votre URL fourni pour le code QR.

## Dépannage

### « 429 Too Many Requests »

Cela signifie que les Quick Tunnels sont soumis à des limites de débit. Solutions :

1. Attendez quelques minutes, puis réessayez
2. Arrêtez tout processus `cloudflared` obsolète : `pkill cloudflared`
3. Passez à un tunnel nommé (recommandé)

### Le tunnel démarre, mais URL ne fonctionne pas

- Vérifiez que le nom d’hôte dans Cloudflare correspond à `--tunnel-url`
- Vérifiez que le port dans Cloudflare correspond à `--port`
- Vérifiez que cloudflared est à jour : `cloudflared update`

### Le tunnel nommé ne se connecte pas

- Vérifiez que votre jeton est correct
- Vérifiez si le tableau de bord Cloudflare Zero Trust signale des erreurs
- Essayez d’exécuter directement `cloudflared tunnel run <TOKEN>` pour afficher les messages d’erreur