Aller au contenu

Tunnels nommés

Afficher au format Markdown Modifier sur GitHub Documentation de 1675df8

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 si vous n’en avez pas.

2. Créer un tunnel dans Zero Trust

  1. Accédez à Cloudflare Zero Trust
  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

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

Ou utilisez des variables d’environnement :

Shell
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 :

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

Ou :

Shell
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