Preskočiť na obsah

Pomenované tunely

Zobraziť ako Markdown Upraviť na GitHub Dokumentácia na 1675df8

Predvolene Termbridge používa rýchle tunely Cloudflare bez účtu (trycloudflare.com). Sú praktické, no pri intenzívnom používaní môžu podliehať obmedzeniam počtu požiadaviek.

Ak Termbridge používate často, nastavte si pomenovaný tunel pomocou svojho účtu Cloudflare.

Prečo používať pomenovaný tunel?

  • Bez obmedzení počtu požiadaviek: Rýchle tunely môžu pri intenzívnom používaní vracať chyby 429
  • Stála adresa URL: Získajte stabilnú subdoménu namiesto náhodných reťazcov
  • Vlastná doména: Použite vlastnú doménu, napríklad term.example.com
  • Vyššia spoľahlivosť: Pomenované tunely sú stabilnejšie pri dlhých reláciách

Nastavenie

1. Vytvorte si účet Cloudflare

Zaregistrujte sa na cloudflare.com, ak ešte účet nemáte.

2. Vytvorte tunel v službe Zero Trust

  1. Prejdite na Cloudflare Zero Trust
  2. Prejdite do sekcie Networks → Tunnels
  3. Kliknite na Create a tunnel
  4. Ako konektor vyberte Cloudflared
  5. Pomenujte tunel (napr. e.g., termbridge)
  6. Skopírujte token tunela

3. Pridajte verejný názov hostiteľa

  1. V nastaveniach tunela prejdite na Public Hostname
  2. Pridajte názov hostiteľa, ktorý smeruje na http://localhost:8080 (alebo na zvolený port)
  3. Použite subdoménu, napríklad term.example.com

4. Spustite Termbridge pomocou tokenu

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

Alebo použite premenné prostredia:

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

termbridge --port 8080

Poznámka Pri pomenovaných tuneloch je príznak --port povinný, pretože názov hostiteľa je nastavený tak, aby smeroval na konkrétny port.

Možnosti konfigurácie

Príznak Premenná prostredia Opis
--port <port> - Lokálny port (povinný pri pomenovaných tuneloch)
--tunnel-token <token> TERMBRIDGE_TUNNEL_TOKEN Token vášho tunela
--tunnel-url <url> TERMBRIDGE_TUNNEL_URL Váš verejný názov hostiteľa URL

Úplné vypnutie tunela

Ak máte vlastný reverzný proxy server alebo verejný URL:

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

Alebo:

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

termbridge

Termbridge preskočí spustenie tunela a použije zadaný URL pre kód QR.

Riešenie problémov

„429 Too Many Requests“

Znamená to, že rýchle tunely podliehajú obmedzeniam počtu požiadaviek. Riešenia:

  1. Počkajte niekoľko minút a skúste to znova
  2. Ukončite všetky zastarané procesy cloudflared: pkill cloudflared
  3. Prejdite na pomenovaný tunel (odporúčané)

Tunel sa spustí, ale URL nefunguje

  • Overte, či sa názov hostiteľa v Cloudflare zhoduje s --tunnel-url
  • Skontrolujte, či sa port v Cloudflare zhoduje s --port
  • Uistite sa, že cloudflared je aktuálny: cloudflared update

Pomenovaný tunel sa nepripojí

  • Overte, či je váš token správny
  • Skontrolujte, či sa na nástenke Cloudflare Zero Trust nezobrazujú chyby
  • Skúste spustiť cloudflared tunnel run <TOKEN> priamo a pozrite si chybové hlásenia