Přejít k obsahu

Pojmenované tunely

Zobrazit jako Markdown Upravit na GitHub Dokumentace na 1675df8

Ve výchozím nastavení používá Termbridge rychlé tunely Cloudflare bez účtu (trycloudflare.com). Jsou praktické, ale při intenzivním používání mohou podléhat limitům požadavků.

Pokud Termbridge používáte často, nastavte si pojmenovaný tunel pomocí účtu Cloudflare.

Proč používat pojmenovaný tunel?

  • Bez limitů požadavků: Rychlé tunely mohou při intenzivním používání vracet chyby 429
  • Stálé URL: Získejte stabilní subdoménu místo náhodných řetězců
  • Vlastní doména: Použijte vlastní doménu, například term.example.com
  • Vyšší spolehlivost: Pojmenované tunely jsou stabilnější při dlouhých relacích

Nastavení

1. Vytvoření účtu Cloudflare

Pokud účet ještě nemáte, zaregistrujte se na cloudflare.com

2. Vytvoření tunelu v Zero Trust

  1. Přejděte na Cloudflare Zero Trust
  2. Přejděte na Networks → Tunnels
  3. Klikněte na Create a tunnel
  4. Jako konektor vyberte Cloudflared
  5. Pojmenujte tunel (e.g., termbridge)
  6. Zkopírujte token tunelu

3. Přidání veřejného názvu hostitele

  1. V nastavení tunelu přejděte na Public Hostname
  2. Přidejte název hostitele, který odkazuje na http://localhost:8080 (nebo na zvolený port)
  3. Použijte subdoménu, například term.example.com

4. Spuštění Termbridge s tokenem

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

Nebo použijte proměnné prostředí:

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

termbridge --port 8080

Poznámka Při použití pojmenovaných tunelů je příznak --port povinný, protože název hostitele je nastaven tak, aby odkazoval na konkrétní port.

Možnosti konfigurace

Příznak Proměnná prostředí Popis
--port <port> - Místní port (povinný u pojmenovaných tunelů)
--tunnel-token <token> TERMBRIDGE_TUNNEL_TOKEN Token vašeho tunelu
--tunnel-url <url> TERMBRIDGE_TUNNEL_URL Váš veřejný název hostitele URL

Úplné vypnutí tunelu

Pokud máte vlastní reverzní proxy nebo veřejné URL:

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

Nebo:

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

termbridge

Termbridge přeskočí spuštění tunelu a pro kód QR použije zadané URL.

Řešení problémů

„429 Too Many Requests“

To znamená, že rychlé tunely podléhají limitům požadavků. Řešení:

  1. Počkejte několik minut a zkuste to znovu
  2. Ukončete všechny zastaralé procesy cloudflared: pkill cloudflared
  3. Přejděte na pojmenovaný tunel (doporučeno)

Tunel se spustí, ale URL nefunguje

  • Ověřte, že název hostitele v Cloudflare odpovídá --tunnel-url
  • Zkontrolujte, zda port v Cloudflare odpovídá --port
  • Ujistěte se, že cloudflared je aktuální: cloudflared update

Pojmenovaný tunel se nepřipojí

  • Ověřte, že je váš token správný
  • Zkontrolujte, zda se na řídicím panelu Cloudflare Zero Trust nezobrazují chyby
  • Zkuste spustit cloudflared tunnel run <TOKEN> přímo a podívejte se na chybová hlášení