Hoppa till innehåll

Namngivna tunnlar

Visa som Markdown Redigera på GitHub Dokumentation på 1675df8

Som standard använder Termbridge Cloudflares Quick Tunnels, som inte kräver något konto (trycloudflare.com). De är smidiga, men kan hastighetsbegränsas vid hög användning.

Om du använder Termbridge ofta kan du konfigurera en namngiven tunnel med ditt Cloudflare-konto.

Varför använda en namngiven tunnel?

  • Inga hastighetsbegränsningar: Quick Tunnels kan ge fel av typen 429 vid hög användning
  • Stadig URL: Få en stabil underdomän i stället för slumpmässiga strängar
  • Egen domän: Använd en egen domän, till exempel term.example.com
  • Bättre tillförlitlighet: Namngivna tunnlar är stabilare under långa sessioner

Konfiguration

1. Skapa ett konto hos Cloudflare

Registrera dig på cloudflare.com om du inte redan har ett konto.

2. Skapa en tunnel i Zero Trust

  1. Gå till Cloudflare Zero Trust
  2. Gå till Nätverk → Tunnlar
  3. Klicka på Skapa en tunnel
  4. Välj Cloudflared som anslutningsprogram
  5. Namnge tunneln (t.ex. e.g, termbridge)
  6. Kopiera tunnelns token

3. Lägg till ett offentligt värdnamn

  1. Gå till Offentligt värdnamn i tunnelinställningarna
  2. Lägg till ett värdnamn som pekar på http://localhost:8080 (eller den port du valt)
  3. Använd en underdomän, till exempel term.example.com

4. Kör Termbridge med din token

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

Eller använd miljövariabler:

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

termbridge --port 8080

Obs! Flaggan --port krävs för namngivna tunnlar eftersom värdnamnet är konfigurerat att peka på en specifik port.

Konfigurationsalternativ

Flagga Miljövariabel Beskrivning
--port <port> - Lokal port (krävs för namngivna tunnlar)
--tunnel-token <token> TERMBRIDGE_TUNNEL_TOKEN Din tunneltoken
--tunnel-url <url> TERMBRIDGE_TUNNEL_URL Ditt offentliga värdnamn URL

Inaktivera tunneln helt

Om du har en egen omvänd proxy eller offentlig URL:

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

Eller:

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

termbridge

Termbridge hoppar över att starta en tunnel och använder den URL som du angett för QR-koden.

Felsökning

"429 För många förfrågningar"

Det här betyder att Quick Tunnels hastighetsbegränsas. Lösningar:

  1. Vänta några minuter och försök igen
  2. Avsluta eventuella inaktuella cloudflared-processer: pkill cloudflared
  3. Byt till en namngiven tunnel (rekommenderas)

Tunnel startar men URL fungerar inte

  • Kontrollera att värdnamnet i Cloudflare matchar --tunnel-url
  • Kontrollera att porten i Cloudflare matchar --port
  • Se till att cloudflared är uppdaterat: cloudflared update

Namngiven tunnel ansluter inte

  • Kontrollera att din token är korrekt
  • Kontrollera om det finns fel i Cloudflare Zero Trust-instrumentpanelen
  • Prova att köra cloudflared tunnel run <TOKEN> direkt för att se felmeddelanden