# Benoemde tunnels

Standaard gebruikt Termbridge de Quick Tunnels van Cloudflare zonder account (`trycloudflare.com`). Die zijn handig, maar bij intensief gebruik kunnen er snelheidslimieten gelden.

Als u Termbridge vaak gebruikt, stelt u een benoemde tunnel in met uw Cloudflare-account.

## Waarom een benoemde tunnel gebruiken?

- **Geen snelheidslimieten**: Quick Tunnels kunnen bij intensief gebruik 429-fouten geven
- **Consistente URL**: krijg een stabiel subdomein in plaats van willekeurige tekenreeksen
- **Eigen domein**: gebruik een eigen domein, zoals `term.example.com`
- **Betere betrouwbaarheid**: benoemde tunnels zijn stabieler tijdens lange sessies

## Instellen

### 1. Maak een Cloudflare-account aan

Meld u aan bij [cloudflare.com](https://cloudflare.com) als u nog geen account hebt.

### 2. Maak een tunnel aan in Zero Trust

1. Ga naar [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Ga naar **Networks** → **Tunnels**
3. Klik op **Create a tunnel**
4. Kies **Cloudflared** als connector
5. Geef uw tunnel een naam (e.g., `termbridge`)
6. Kopieer het tunnel-token

### 3. Voeg een openbare hostnaam toe

1. Ga in de tunnelinstellingen naar **Public Hostname**
2. Voeg een hostnaam toe die verwijst naar `http://localhost:8080` (of de poort van uw keuze)
3. Gebruik een subdomein, zoals `term.example.com`

### 4. Voer Termbridge uit met uw token

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

Of gebruik omgevingsvariabelen:

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

termbridge --port 8080
```

> **Opmerking**
> De vlag `--port` is vereist voor benoemde tunnels, omdat de hostnaam is ingesteld om naar een specifieke poort te verwijzen.


## Configuratieopties

| Vlag | Omgevingsvariabele | Beschrijving |
|------|---------------------|-------------|
| `--port <port>` | - | Lokale poort (vereist voor benoemde tunnels) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Uw tunnel-token |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Uw openbare hostnaam URL |

## De tunnel volledig uitschakelen

Als u een eigen reverse proxy of openbare URL hebt:

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

Of:

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

termbridge
```

Termbridge slaat het starten van een tunnel over en gebruikt uw opgegeven URL voor de QR-code.

## Problemen oplossen

### "429 Too Many Requests"

Dit betekent dat er snelheidslimieten gelden voor Quick Tunnels. Mogelijke oplossingen:

1. Wacht een paar minuten en probeer het opnieuw
2. Beëindig achtergebleven `cloudflared`-processen: `pkill cloudflared`
3. Schakel over op een benoemde tunnel (aanbevolen)

### Tunnel start, maar URL werkt niet

- Controleer of de hostnaam in Cloudflare overeenkomt met `--tunnel-url`
- Controleer of de poort in Cloudflare overeenkomt met `--port`
- Zorg dat cloudflared up-to-date is: `cloudflared update`

### Benoemde tunnel maakt geen verbinding

- Controleer of uw token klopt
- Controleer het Cloudflare Zero Trust-dashboard op fouten
- Probeer `cloudflared tunnel run <TOKEN>` rechtstreeks uit te voeren om foutmeldingen te zien