Lewati ke konten

Tunnel Bernama

Lihat sebagai Markdown Edit di GitHub Dokumentasi di 1675df8

Secara default, Termbridge menggunakan Quick Tunnel tanpa akun milik Cloudflare (trycloudflare.com). Tunnel ini praktis, tetapi penggunaannya yang berat dapat terkena batas laju.

Jika Anda sering menggunakan Termbridge, siapkan tunnel bernama dengan akun Cloudflare Anda.

Mengapa menggunakan tunnel bernama?

  • Tanpa batas laju: Quick Tunnel dapat menghasilkan error 429 saat digunakan secara intensif
  • URL yang konsisten: Dapatkan subdomain tetap, bukan string acak
  • Domain khusus: Gunakan domain Anda sendiri seperti term.example.com
  • Keandalan lebih baik: Tunnel bernama lebih stabil untuk sesi yang panjang

Penyiapan

1. Buat akun Cloudflare

Daftar di cloudflare.com jika Anda belum memilikinya.

2. Buat tunnel di Zero Trust

  1. Buka Cloudflare Zero Trust
  2. Buka Networks → Tunnels
  3. Klik Create a tunnel
  4. Pilih Cloudflared sebagai konektor
  5. Beri nama tunnel Anda (mis., e.g, termbridge)
  6. Salin token tunnel

3. Tambahkan hostname publik

  1. Di pengaturan tunnel, buka Public Hostname
  2. Tambahkan hostname yang mengarah ke http://localhost:8080 (atau port pilihan Anda)
  3. Gunakan subdomain seperti term.example.com

4. Jalankan Termbridge dengan token Anda

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

Atau gunakan variabel lingkungan:

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

termbridge --port 8080

Catatan Flag --port wajib digunakan dengan tunnel bernama karena hostname dikonfigurasi agar mengarah ke port tertentu.

Opsi konfigurasi

Flag Variabel Lingkungan Deskripsi
--port <port> - Port lokal (wajib untuk tunnel bernama)
--tunnel-token <token> TERMBRIDGE_TUNNEL_TOKEN Token tunnel Anda
--tunnel-url <url> TERMBRIDGE_TUNNEL_URL Hostname publik Anda URL

Menonaktifkan tunnel sepenuhnya

Jika Anda memiliki reverse proxy sendiri atau URL publik:

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

Atau:

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

termbridge

Termbridge akan melewati proses memulai tunnel dan menggunakan URL yang Anda berikan untuk kode QR.

Pemecahan masalah

"429 Too Many Requests"

Artinya Quick Tunnel terkena batas laju. Solusi:

  1. Tunggu beberapa menit lalu coba lagi
  2. Hentikan proses cloudflared yang tidak aktif: pkill cloudflared
  3. Beralih ke tunnel bernama (disarankan)

Tunnel dimulai, tetapi URL tidak berfungsi

  • Pastikan hostname di Cloudflare cocok dengan --tunnel-url
  • Periksa apakah port di Cloudflare cocok dengan --port
  • Pastikan cloudflared sudah diperbarui: cloudflared update

Tunnel bernama tidak dapat tersambung

  • Pastikan token Anda benar
  • Periksa dasbor Cloudflare Zero Trust untuk melihat error
  • Coba jalankan cloudflared tunnel run <TOKEN> secara langsung untuk melihat pesan error