Przejdź do treści

Nazwane tunele

Wyświetl jako Markdown Edytuj w GitHub Dokumentacja: 1675df8

Domyślnie Termbridge korzysta z szybkich tuneli Quick Tunnels Cloudflare, które nie wymagają konta (trycloudflare.com). Są wygodne, ale przy intensywnym użyciu mogą obowiązywać limity żądań.

Jeśli często korzystasz z Termbridge, skonfiguruj nazwany tunel na swoim koncie Cloudflare.

Dlaczego warto używać nazwanego tunelu?

  • Brak limitów żądań: Przy intensywnym użyciu Quick Tunnels mogą zwracać błędy 429
  • Stały adres URL: Uzyskaj stabilną subdomenę zamiast losowego ciągu znaków
  • Własna domena: Użyj własnej domeny, takiej jak term.example.com
  • Większa niezawodność: Nazwane tunele są stabilniejsze podczas długich sesji

Konfiguracja

1. Utwórz konto Cloudflare

Zarejestruj się na cloudflare.com, jeśli nie masz jeszcze konta.

2. Utwórz tunel w Zero Trust

  1. Przejdź do Cloudflare Zero Trust
  2. Przejdź do Networks → Tunnels
  3. Kliknij Create a tunnel
  4. Wybierz Cloudflared jako łącznik
  5. Nadaj nazwę tunelowi (np. e.g., termbridge)
  6. Skopiuj token tunelu

3. Dodaj publiczną nazwę hosta

  1. W ustawieniach tunelu przejdź do Public Hostname
  2. Dodaj nazwę hosta kierującą do http://localhost:8080 (lub wybranego portu)
  3. Użyj subdomeny, takiej jak term.example.com

4. Uruchom Termbridge z tokenem

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

Możesz też użyć zmiennych środowiskowych:

Powłoka
export TERMBRIDGE_TUNNEL_TOKEN=<TOKEN>
export TERMBRIDGE_TUNNEL_URL=https://term.example.com

termbridge --port 8080

Uwaga Flaga --port jest wymagana w przypadku nazwanych tuneli, ponieważ nazwa hosta jest skonfigurowana dla konkretnego portu.

Opcje konfiguracji

Flaga Zmienna środowiskowa Opis
--port <port> - Lokalny port (wymagany dla nazwanych tuneli)
--tunnel-token <token> TERMBRIDGE_TUNNEL_TOKEN Token tunelu
--tunnel-url <url> TERMBRIDGE_TUNNEL_URL Publiczna nazwa hosta URL

Całkowite wyłączenie tunelu

Jeśli masz własny reverse proxy lub publiczny adres URL:

Powłoka
termbridge --no-tunnel --public-url https://your-server.com

Lub:

Powłoka
export TERMBRIDGE_TUNNEL=none
export TERMBRIDGE_PUBLIC_URL=https://your-server.com

termbridge

Termbridge pominie uruchamianie tunelu i użyje podanego URL dla kodu QR.

Rozwiązywanie problemów

„429 Too Many Requests”

Oznacza to, że obowiązują limity żądań dla Quick Tunnels. Możliwe rozwiązania:

  1. Odczekaj kilka minut i spróbuj ponownie
  2. Zakończ wszystkie nieaktualne procesy cloudflared: pkill cloudflared
  3. Przełącz się na nazwany tunel (zalecane)

Tunel się uruchamia, ale URL nie działa

  • Sprawdź, czy nazwa hosta w Cloudflare jest zgodna z --tunnel-url
  • Sprawdź, czy port w Cloudflare jest zgodny z --port
  • Upewnij się, że cloudflared jest aktualne: cloudflared update

Nie można połączyć się z nazwanym tunelem

  • Sprawdź, czy token jest prawidłowy
  • Sprawdź, czy na pulpicie nawigacyjnym Cloudflare Zero Trust są błędy
  • Uruchom bezpośrednio cloudflared tunnel run <TOKEN>, aby zobaczyć komunikaty o błędach