Ga naar de inhoud

Benoemde tunnels

Bekijken als Markdown Bewerken op GitHub Documentatie op 1675df8

Standaard gebruikt Termbridge de Quick Tunnels van Cloudflare zonder account (trycloudflare.com). Die zijn handig, maar bij intensief gebruik kunnen er snelheidslimieten gelden.

Als u Termbridge vaak gebruikt, stelt u een benoemde tunnel in met uw Cloudflare-account.

Waarom een benoemde tunnel gebruiken?

  • Geen snelheidslimieten: Quick Tunnels kunnen bij intensief gebruik 429-fouten geven
  • Consistente URL: krijg een stabiel subdomein in plaats van willekeurige tekenreeksen
  • Eigen domein: gebruik een eigen domein, zoals term.example.com
  • Betere betrouwbaarheid: benoemde tunnels zijn stabieler tijdens lange sessies

Instellen

1. Maak een Cloudflare-account aan

Meld u aan bij cloudflare.com als u nog geen account hebt.

2. Maak een tunnel aan in Zero Trust

  1. Ga naar Cloudflare Zero Trust
  2. Ga naar Networks → Tunnels
  3. Klik op Create a tunnel
  4. Kies Cloudflared als connector
  5. Geef uw tunnel een naam (e.g., termbridge)
  6. Kopieer het tunnel-token

3. Voeg een openbare hostnaam toe

  1. Ga in de tunnelinstellingen naar Public Hostname
  2. Voeg een hostnaam toe die verwijst naar http://localhost:8080 (of de poort van uw keuze)
  3. Gebruik een subdomein, zoals term.example.com

4. Voer Termbridge uit met uw token

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

Of gebruik omgevingsvariabelen:

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

termbridge --port 8080

Opmerking De vlag --port is vereist voor benoemde tunnels, omdat de hostnaam is ingesteld om naar een specifieke poort te verwijzen.

Configuratieopties

Vlag Omgevingsvariabele Beschrijving
--port <port> - Lokale poort (vereist voor benoemde tunnels)
--tunnel-token <token> TERMBRIDGE_TUNNEL_TOKEN Uw tunnel-token
--tunnel-url <url> TERMBRIDGE_TUNNEL_URL Uw openbare hostnaam URL

De tunnel volledig uitschakelen

Als u een eigen reverse proxy of openbare URL hebt:

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

Of:

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

termbridge

Termbridge slaat het starten van een tunnel over en gebruikt uw opgegeven URL voor de QR-code.

Problemen oplossen

"429 Too Many Requests"

Dit betekent dat er snelheidslimieten gelden voor Quick Tunnels. Mogelijke oplossingen:

  1. Wacht een paar minuten en probeer het opnieuw
  2. Beëindig achtergebleven cloudflared-processen: pkill cloudflared
  3. Schakel over op een benoemde tunnel (aanbevolen)

Tunnel start, maar URL werkt niet

  • Controleer of de hostnaam in Cloudflare overeenkomt met --tunnel-url
  • Controleer of de poort in Cloudflare overeenkomt met --port
  • Zorg dat cloudflared up-to-date is: cloudflared update

Benoemde tunnel maakt geen verbinding

  • Controleer of uw token klopt
  • Controleer het Cloudflare Zero Trust-dashboard op fouten
  • Probeer cloudflared tunnel run <TOKEN> rechtstreeks uit te voeren om foutmeldingen te zien