# Adlandırılmış Tüneller

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](https://cloudflare.com) adresinden kaydolun.

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

1. [Cloudflare Zero Trust](https://one.dash.cloudflare.com/) 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

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

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

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

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

Ya da:

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