İçeriğe geç

Adlandırılmış Tüneller

Markdown olarak görüntüle GitHub üzerinde düzenle Dokümantasyon: 1675df8

Varsayılan olarak Termbridge, Cloudflare hesabı gerektirmeyen Quick Tunnels'ı (trycloudflare.com) kullanır. Bunlar kullanışlıdır ancak yoğun kullanımda hız sınırına takılabilir.

Termbridge'ı sık kullanıyorsanız, Cloudflare hesabınızla adlandırılmış bir tünel kurun.

Adlandırılmış tünel neden kullanılır?

  • Hız sınırı yok: Yoğun kullanımda Quick Tunnels 429 hataları döndürebilir
  • Tutarlı URL: Rastgele dizeler yerine sabit bir alt alan adı edinin
  • Özel alan adı: term.example.com gibi kendi alan adınızı kullanın
  • Daha yüksek güvenilirlik: Adlandırılmış tüneller uzun oturumlarda daha kararlıdır

Kurulum

1. Bir Cloudflare hesabı oluşturun

Hesabınız yoksa cloudflare.com adresinden kaydolun.

2. Zero Trust'ta tünel oluşturun

  1. Cloudflare Zero Trust adresine gidin
  2. Networks → Tunnels bölümüne gidin
  3. Create a tunnel düğmesine tıklayın
  4. Bağlayıcı olarak Cloudflared öğesini seçin
  5. Tünelinizi adlandırın (e.g., termbridge)
  6. Tünel belirtecini kopyalayın

3. Genel ana makine adı ekleyin

  1. Tünel ayarlarında Public Hostname bölümüne gidin
  2. http://localhost:8080 adresine (veya seçtiğiniz bağlantı noktasına) yönlenen bir ana makine adı ekleyin
  3. term.example.com gibi bir alt alan adı kullanın

4. Termbridge öğesini belirtecinizle çalıştırın

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

Ya da ortam değişkenlerini kullanın:

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

termbridge --port 8080

Not Ana makine adı belirli bir bağlantı noktasına yönlenecek şekilde yapılandırıldığından, adlandırılmış tünellerde --port bayrağı gereklidir.

Yapılandırma seçenekleri

Bayrak Ortam Değişkeni Açıklama
--port <port> - Yerel bağlantı noktası (adlandırılmış tünellerde gereklidir)
--tunnel-token <token> TERMBRIDGE_TUNNEL_TOKEN Tünel belirteciniz
--tunnel-url <url> TERMBRIDGE_TUNNEL_URL Genel ana makine adınız URL

Tüneli tamamen devre dışı bırakma

Kendi ters proxy'niz veya genel URL adresiniz varsa:

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

Ya da:

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

termbridge

Termbridge bir tünel başlatmayı atlar ve QR kodu için sağladığınız URL değerini kullanır.

Sorun giderme

"429 Too Many Requests"

Bu, Quick Tunnels'ın hız sınırına takıldığı anlamına gelir. Çözümler:

  1. Birkaç dakika bekleyip yeniden deneyin
  2. Eski cloudflared süreçlerini sonlandırın: pkill cloudflared
  3. Adlandırılmış bir tünele geçin (önerilir)

Tünel başlıyor ama URL çalışmıyor

  • Cloudflare içindeki ana makine adının --tunnel-url ile eşleştiğini doğrulayın
  • Cloudflare içindeki bağlantı noktasının --port ile eşleştiğini kontrol edin
  • cloudflared değerinin güncel olduğundan emin olun: cloudflared update

Adlandırılmış tünel bağlanmıyor

  • Belirtecinizin doğru olduğunu doğrulayın
  • Hatalar için Cloudflare Zero Trust panosunu kontrol edin
  • Hata mesajlarını görmek için cloudflared tunnel run <TOKEN> öğesini doğrudan çalıştırmayı deneyin