# Sorun giderme

## "spawn tmux ENOENT"

tmux yüklenmemiş veya PATH içinde değil. Termbridge bu hatayı yazdırır ancak terminal sunmadan çalışmaya devam eder ([#4](https://github.com/inline0/termbridge/issues/4)); `Ctrl+C` tuşuna basın, tmux yükleyin ve yeniden başlatın.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

## "spawn cloudflared ENOENT"

Cloudflare tünel istemcisi yüklenmemiş veya PATH içinde değil. Bu yalnızca tünel modu için gereklidir; `--no-tunnel` ve Daytona doğrudan modda cloudflared gerekmez.

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

Linux için [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/) adresinden indirin.

## Tünel başlatılamıyor

Kontrol edebileceğiniz birkaç şey (doğrudan sandbox modunu kullanıyorsanız bu adımı atlayın):

1. cloudflared komutunun çalıştığını doğrulayın: `cloudflared --version`
2. `https://trycloudflare.com` adresine erişebildiğinizden emin olun
3. Güvenlik duvarının giden bağlantıları engelleyip engellemediğini kontrol edin

Tünel başlatılamazsa Termbridge hatayı yazdırır, sunucusunu durdurur ve 1 durum koduyla çıkar. Yalnızca yerel moda geri dönmez; varsayılan olarak sunucu yalnızca `127.0.0.1` üzerinde dinleme yapar, bu nedenle ağınızdaki diğer cihazlar da sunucuya erişemez. Bu çalıştırma için oluşturulan tmux oturumları çalışır durumda kalır ([#4](https://github.com/inline0/termbridge/issues/4)).

Termbridge komutunu Cloudflare tüneli olmadan kullanmak için kendi ters vekil sunucunuzun veya tünelinizin arkasında `--no-tunnel --public-url <url>` ile çalıştırın.

## trycloudflare kaynaklı "429 Çok Fazla İstek"

Cloudflare, hesapsız tüneller için hız sınırı uygular. `429 Too Many Requests` gibi hatalar görürseniz şunları deneyin:

1. Birkaç dakika bekleyip yeniden deneyin
2. Eski `cloudflared` süreçlerinin çalışmaya devam etmediğinden emin olun
3. Sık kullanım için önerilen, adlandırılmış bir tünel belirteci kullanın

## Boş ekran veya "Terminaller yüklenemiyor"

Bu genellikle tarayıcıda geçerli bir oturum çerezi olmadığı anlamına gelir. Örneğin, paylaşım bağlantısı kullanılmadan sayfa açılmış veya tünel URL değişmiş olabilir:

1. Yerel sunucunun hâlâ çalışıp çalışmadığını kontrol edin
2. Tarayıcı konsolunda 401/403 hatalarına bakın
3. Yeni bir URL ve QR kodu almak için Termbridge uygulamasını yeniden başlatın

## Terminalde çıktı yok

tmux oturumu çalışmıyor olabilir:

```bash
# Check if sessions exist
tmux ls
```

Oturumlar görünüyor ama terminal boşsa şunları deneyin:
- Sayfayı yeniden yükleyin
- Kabuk programınızın `TERM=xterm-256color` desteklediğini kontrol edin

## QR kodu taranıyor ancak sayfa boş

QR kodu tek kullanımlık bir belirteç içerir. Yalnızca bir kez ve Termbridge başladıktan sonraki 90 saniye içinde çalışır. Kullanılmış veya süresi dolmuş bir bağlantı `invalid token` döndürür.

Çözüm: Yeni bir QR kodu oluşturmak için Termbridge uygulamasını yeniden başlatın ve kodu hemen tarayın.

## node-pty spawn-helper ile ilgili hatalar

Termbridge bu sorunu otomatik olarak düzeltmeye çalışır ancak izin hataları görürseniz:

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

## Sorun hâlâ çözülmedi mi?

Şunları içeren bir sorun kaydını [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues) adresinde açın:
- İşletim sisteminiz ve Node.js sürümü
- Hata mesajı
- Sorunu yeniden oluşturma adımları