# Namngivna tunnlar

Som standard använder Termbridge Cloudflares Quick Tunnels, som inte kräver något konto (`trycloudflare.com`). De är smidiga, men kan hastighetsbegränsas vid hög användning.

Om du använder Termbridge ofta kan du konfigurera en namngiven tunnel med ditt Cloudflare-konto.

## Varför använda en namngiven tunnel?

- **Inga hastighetsbegränsningar**: Quick Tunnels kan ge fel av typen 429 vid hög användning
- **Stadig URL**: Få en stabil underdomän i stället för slumpmässiga strängar
- **Egen domän**: Använd en egen domän, till exempel `term.example.com`
- **Bättre tillförlitlighet**: Namngivna tunnlar är stabilare under långa sessioner

## Konfiguration

### 1. Skapa ett konto hos Cloudflare

Registrera dig på [cloudflare.com](https://cloudflare.com) om du inte redan har ett konto.

### 2. Skapa en tunnel i Zero Trust

1. Gå till [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Gå till **Nätverk** → **Tunnlar**
3. Klicka på **Skapa en tunnel**
4. Välj **Cloudflared** som anslutningsprogram
5. Namnge tunneln (t.ex. e.g, `termbridge`)
6. Kopiera tunnelns token

### 3. Lägg till ett offentligt värdnamn

1. Gå till **Offentligt värdnamn** i tunnelinställningarna
2. Lägg till ett värdnamn som pekar på `http://localhost:8080` (eller den port du valt)
3. Använd en underdomän, till exempel `term.example.com`

### 4. Kör Termbridge med din token

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

Eller använd miljövariabler:

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

termbridge --port 8080
```

> **Obs!**
> Flaggan `--port` krävs för namngivna tunnlar eftersom värdnamnet är konfigurerat att peka på en specifik port.


## Konfigurationsalternativ

| Flagga | Miljövariabel | Beskrivning |
|------|---------------------|-------------|
| `--port <port>` | - | Lokal port (krävs för namngivna tunnlar) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Din tunneltoken |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Ditt offentliga värdnamn URL |

## Inaktivera tunneln helt

Om du har en egen omvänd proxy eller offentlig URL:

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

Eller:

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

termbridge
```

Termbridge hoppar över att starta en tunnel och använder den URL som du angett för QR-koden.

## Felsökning

### "429 För många förfrågningar"

Det här betyder att Quick Tunnels hastighetsbegränsas. Lösningar:

1. Vänta några minuter och försök igen
2. Avsluta eventuella inaktuella `cloudflared`-processer: `pkill cloudflared`
3. Byt till en namngiven tunnel (rekommenderas)

### Tunnel startar men URL fungerar inte

- Kontrollera att värdnamnet i Cloudflare matchar `--tunnel-url`
- Kontrollera att porten i Cloudflare matchar `--port`
- Se till att cloudflared är uppdaterat: `cloudflared update`

### Namngiven tunnel ansluter inte

- Kontrollera att din token är korrekt
- Kontrollera om det finns fel i Cloudflare Zero Trust-instrumentpanelen
- Prova att köra `cloudflared tunnel run <TOKEN>` direkt för att se felmeddelanden