Treci la conținut

Tuneluri cu nume

Vizualizați ca Markdown Editați pe GitHub Documentație la 1675df8

În mod implicit, Termbridge folosește Quick Tunnels fără cont ale Cloudflare (trycloudflare.com). Sunt convenabile, dar utilizarea intensă poate duce la limitarea numărului de solicitări.

Dacă folosiți frecvent Termbridge, configurați un tunel cu nume folosind contul dvs. Cloudflare.

De ce să folosiți un tunel cu nume?

  • Fără limite de solicitări: În cazul utilizării intense, Quick Tunnels pot returna erori 429
  • URL consecvent: Obțineți un subdomeniu stabil în locul unor șiruri aleatorii
  • Domeniu personalizat: Folosiți propriul domeniu, precum term.example.com
  • Fiabilitate mai bună: Tunelurile cu nume sunt mai stabile pentru sesiunile lungi

Configurare

1. Creați un cont Cloudflare

Înregistrați-vă la cloudflare.com dacă nu aveți deja un cont.

2. Creați un tunel în Zero Trust

  1. Accesați Cloudflare Zero Trust
  2. Navigați la Networks → Tunnels
  3. Faceți clic pe Create a tunnel
  4. Alegeți Cloudflared ca conector
  5. Dați un nume tunelului (de ex. e.g, termbridge)
  6. Copiați tokenul tunelului

3. Adăugați un nume de gazdă public

  1. În setările tunelului, accesați Public Hostname
  2. Adăugați un nume de gazdă care să indice către http://localhost:8080 (sau portul ales)
  3. Folosiți un subdomeniu precum term.example.com

4. Rulați Termbridge cu tokenul dvs.

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

Sau folosiți variabile de mediu:

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

termbridge --port 8080

Notă Indicatorul --port este obligatoriu pentru tunelurile cu nume, deoarece numele de gazdă este configurat să indice către un anumit port.

Opțiuni de configurare

Indicator Variabilă de mediu Descriere
--port <port> - Port local (obligatoriu pentru tunelurile cu nume)
--tunnel-token <token> TERMBRIDGE_TUNNEL_TOKEN Tokenul tunelului dvs.
--tunnel-url <url> TERMBRIDGE_TUNNEL_URL Numele dvs. de gazdă public URL

Dezactivarea completă a tunelului

Dacă aveți propriul proxy invers sau propriul URL public:

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

Sau:

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

termbridge

Termbridge va omite pornirea unui tunel și va folosi propriul URL pentru codul QR.

Depanare

„429 Prea multe solicitări”

Aceasta înseamnă că Quick Tunnels au limite de solicitări. Soluții:

  1. Așteptați câteva minute și încercați din nou
  2. Opriți procesele cloudflared rămase active: pkill cloudflared
  3. Treceți la un tunel cu nume (recomandat)

Tunelul pornește, dar URL nu funcționează

  • Verificați dacă numele gazdei din Cloudflare corespunde cu --tunnel-url
  • Verificați dacă portul din Cloudflare corespunde cu --port
  • Asigurați-vă că cloudflared este actualizat: cloudflared update

Tunelul cu nume nu se conectează

  • Verificați dacă tokenul este corect
  • Verificați dacă există erori în tabloul de bord Cloudflare Zero Trust
  • Încercați să rulați direct cloudflared tunnel run <TOKEN> pentru a vedea mesajele de eroare