Lewati ke konten

Pemecahan masalah

Lihat sebagai Markdown Edit di GitHub Dokumentasi di 1675df8

"spawn tmux ENOENT"

tmux belum terinstal atau tidak ada di PATH Anda. Termbridge menampilkan kesalahan ini, tetapi saat ini tetap berjalan tanpa menyediakan terminal (#4); tekan Ctrl+C, instal tmux, lalu mulai lagi.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

Klien tunnel Cloudflare belum terinstal atau tidak ada di PATH Anda. Klien ini hanya diperlukan untuk mode tunnel; mode langsung --no-tunnel dan Daytona tidak memerlukan cloudflared.

Shell
# macOS
brew install cloudflared

Untuk Linux, unduh dari cloudflare.com/downloads.

Tunnel tidak dapat dimulai

Beberapa hal yang perlu diperiksa (lewati bagian ini jika Anda menggunakan mode sandbox langsung):

  1. Pastikan cloudflared berfungsi: cloudflared --version
  2. Pastikan Anda dapat menjangkau https://trycloudflare.com
  3. Periksa apakah firewall memblokir koneksi keluar

Jika tunnel gagal dimulai, Termbridge menampilkan kesalahan, menghentikan servernya, lalu keluar dengan status 1. Aplikasi ini tidak beralih ke mode lokal saja, dan server secara bawaan hanya mendengarkan di 127.0.0.1, sehingga perangkat lain di jaringan Anda juga tidak dapat menjangkaunya. Sesi tmux yang dibuat untuk proses tersebut tetap berjalan (#4).

Untuk menggunakan Termbridge tanpa tunnel Cloudflare, jalankan dengan --no-tunnel --public-url <url> di balik reverse proxy atau tunnel Anda sendiri.

"429 Terlalu Banyak Permintaan" dari trycloudflare

Cloudflare membatasi laju tunnel tanpa akun. Jika Anda melihat kesalahan seperti 429 Too Many Requests, coba:

  1. Tunggu beberapa menit lalu coba lagi
  2. Pastikan tidak ada proses cloudflared lama yang masih berjalan
  3. Gunakan token tunnel bernama (disarankan untuk penggunaan rutin)

Layar kosong atau "Terminal tidak dapat dimuat"

Biasanya ini berarti browser tidak memiliki cookie sesi yang valid, misalnya karena halaman dibuka tanpa menukarkan tautan berbagi, atau URL tunnel berubah:

  1. Periksa apakah server lokal masih berjalan
  2. Lihat konsol browser untuk mengetahui kesalahan 401/403
  3. Mulai ulang Termbridge untuk mendapatkan kode URL dan QR yang baru

Tidak ada keluaran di terminal

Sesi tmux mungkin tidak berjalan:

Shell
# Check if sessions exist
tmux ls

Jika sesi terlihat tetapi terminal kosong, coba:

  • Muat ulang halaman
  • Pastikan shell Anda mendukung TERM=xterm-256color

Kode QR berhasil dipindai, tetapi halaman kosong

Kode QR berisi token sekali pakai. Kode ini hanya dapat digunakan sekali dan hanya dalam 90 detik sejak Termbridge dimulai. Tautan yang sudah digunakan atau kedaluwarsa akan menampilkan invalid token.

Solusi: Mulai ulang Termbridge untuk membuat kode QR baru, lalu segera pindai.

Kesalahan node-pty terkait spawn-helper

Termbridge mencoba memperbaikinya secara otomatis, tetapi jika Anda melihat kesalahan izin:

Shell
chmod +x node_modules/node-pty/prebuilds/**/spawn-helper

Masih mengalami masalah?

Buat laporan masalah di github.com/inline0/termbridge dengan menyertakan:

  • OS dan versi Node.js Anda
  • Pesan kesalahan
  • Langkah untuk mereproduksi masalah