Preskoči na vsebino

Poimenovani tuneli

Prikaži kot Markdown Uredi na GitHub Dokumentacija za 1675df8

Privzeto Termbridge uporablja Cloudflare hitre tunele brez računa (trycloudflare.com). Ti so priročni, vendar je njihova uporaba lahko omejena pri intenzivni uporabi.

Če pogosto uporabljate Termbridge, nastavite poimenovani tunel z računom Cloudflare.

Zakaj uporabiti poimenovani tunel?

  • Brez omejitev hitrosti: Pri intenzivni uporabi lahko hitri tuneli Quick Tunnels vrnejo napake 429
  • Stalen URL: Pridobite stabilno poddomeno namesto naključnih nizov
  • Domena po meri: Uporabite svojo domeno, na primer term.example.com
  • Večja zanesljivost: Poimenovani tuneli so stabilnejši pri dolgotrajnih sejah

Nastavitev

1. Ustvarite račun Cloudflare

Če še nimate računa, se registrirajte na cloudflare.com.

2. Ustvarite tunel v Zero Trust

  1. Odprite Cloudflare Zero Trust
  2. Pomaknite se do Omrežja → Tuneli
  3. Kliknite Ustvari tunel
  4. Za povezovalnik izberite Cloudflared
  5. Poimenujte tunel (npr. e.g., termbridge)
  6. Kopirajte žeton tunela

3. Dodajte javno ime gostitelja

  1. V nastavitvah tunela odprite Javno ime gostitelja
  2. Dodajte ime gostitelja, ki kaže na http://localhost:8080 (ali izbrana vrata)
  3. Uporabite poddomeno, kot je term.example.com

4. Zaženite Termbridge s svojim žetonom

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

Lahko pa uporabite spremenljivke okolja:

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

termbridge --port 8080

Opomba Pri poimenovanih tunelih je zastavica --port obvezna, ker je ime gostitelja nastavljeno tako, da kaže na določena vrata.

Možnosti konfiguracije

Zastavica Spremenljivka okolja Opis
--port <port> - Lokalna vrata (obvezno pri poimenovanih tunelih)
--tunnel-token <token> TERMBRIDGE_TUNNEL_TOKEN Vaš žeton tunela
--tunnel-url <url> TERMBRIDGE_TUNNEL_URL Vaše javno ime gostitelja URL

Popoln izklop tunela

Če imate lasten povratni posredniški strežnik ali javni URL:

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

Ali pa:

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

termbridge

Termbridge ne bo zagnal tunela in bo uporabil vaš URL za kodo QR.

Odpravljanje težav

"429 Preveč zahtev"

To pomeni, da za hitre tunele Quick Tunnels veljajo omejitve hitrosti. Rešitve:

  1. Počakajte nekaj minut in poskusite znova
  2. Ustavite morebitne zastarele procese cloudflared: pkill cloudflared
  3. Preklopite na poimenovani tunel (priporočeno)

Predor se zažene, vendar URL ne deluje

  • Preverite, ali se ime gostitelja v Cloudflare ujema z --tunnel-url
  • Preverite, ali se vrata v Cloudflare ujemajo z --port
  • Prepričajte se, da je cloudflared posodobljen: cloudflared update

Povezava z imenovanim predorom ni mogoča

  • Preverite, ali je vaš žeton pravilen
  • Na nadzorni plošči Cloudflare Zero Trust preverite, ali so prikazane napake
  • Poskusite neposredno zagnati cloudflared tunnel run <TOKEN>, da preverite sporočila o napakah