# Pemecahan masalah

## "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](https://github.com/inline0/termbridge/issues/4)); tekan `Ctrl+C`, instal tmux, lalu mulai lagi.

```bash
# 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.

```bash
# macOS
brew install cloudflared
```

Untuk Linux, unduh dari [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/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](https://github.com/inline0/termbridge/issues/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:

```bash
# 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:

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

## Masih mengalami masalah?

Buat laporan masalah di [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues) dengan menyertakan:
- OS dan versi Node.js Anda
- Pesan kesalahan
- Langkah untuk mereproduksi masalah