Gå til indhold

Navngivne tunneler

Vis som Markdown Rediger på GitHub Dokumentation hos 1675df8

Som standard bruger Termbridge Cloudflares Quick Tunnels uden konto (trycloudflare.com). De er praktiske, men kan blive hastighedsbegrænset ved intensiv brug.

Hvis du bruger Termbridge ofte, kan du oprette en navngiven tunnel med din Cloudflare-konto.

Hvorfor bruge en navngiven tunnel?

  • Ingen hastighedsbegrænsninger: Quick Tunnels kan returnere 429-fejl ved intensiv brug
  • Stabil URL: Få et fast underdomæne i stedet for tilfældige strenge
  • Brugerdefineret domæne: Brug dit eget domæne, f.eks. term.example.com
  • Bedre pålidelighed: Navngivne tunneler er mere stabile ved lange sessioner

Opsætning

1. Opret en Cloudflare-konto

Tilmeld dig på cloudflare.com, hvis du ikke allerede har en.

2. Opret en tunnel i Zero Trust

  1. Gå til Cloudflare Zero Trust
  2. Gå til Networks → Tunnels
  3. Klik på Create a tunnel
  4. Vælg Cloudflared som forbindelse
  5. Navngiv tunnelen (e.g., termbridge)
  6. Kopiér tunnelens token

3. Tilføj et offentligt værtsnavn

  1. Gå til Public Hostname i tunnelindstillingerne
  2. Tilføj et værtsnavn, der peger på http://localhost:8080 (eller den port, du har valgt)
  3. Brug et underdomæne som term.example.com

4. Kør Termbridge med dit token

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

Eller brug miljøvariabler:

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

termbridge --port 8080

Bemærk Flaget --port er påkrævet med navngivne tunneler, fordi værtsnavnet er konfigureret til at pege på en bestemt port.

Konfigurationsindstillinger

Flag Miljøvariabel Beskrivelse
--port <port> - Lokal port (påkrævet med navngivne tunneler)
--tunnel-token <token> TERMBRIDGE_TUNNEL_TOKEN Dit tunnel-token
--tunnel-url <url> TERMBRIDGE_TUNNEL_URL Dit offentlige værtsnavn URL

Deaktiver tunnelen helt

Hvis du har din egen reverse proxy eller offentlige 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 springer tunnelstart over og bruger din angivne URL til QR-koden.

Fejlfinding

"429 Too Many Requests"

Det betyder, at Quick Tunnels er hastighedsbegrænsede. Mulige løsninger:

  1. Vent et par minutter, og prøv igen
  2. Afslut eventuelle forældede cloudflared-processer: pkill cloudflared
  3. Skift til en navngiven tunnel (anbefales)

Tunnelen starter, men URL virker ikke

  • Kontrollér, at værtsnavnet i Cloudflare stemmer overens med --tunnel-url
  • Kontrollér, at porten i Cloudflare stemmer overens med --port
  • Sørg for, at cloudflared er opdateret: cloudflared update

Den navngivne tunnel kan ikke oprette forbindelse

  • Kontrollér, at dit token er korrekt
  • Se efter fejl i Cloudflare Zero Trust-dashboardet
  • Prøv at køre cloudflared tunnel run <TOKEN> direkte for at se fejlmeddelelser