# Επώνυμα τούνελ

Από προεπιλογή, το Termbridge χρησιμοποιεί τα Quick Tunnels του Cloudflare χωρίς λογαριασμό (`trycloudflare.com`). Είναι βολικά, αλλά με εκτεταμένη χρήση ενδέχεται να υπόκεινται σε όρια ρυθμού.

Αν χρησιμοποιείτε συχνά το Termbridge, ρυθμίστε ένα επώνυμο τούνελ με τον λογαριασμό σας στο Cloudflare.

## Γιατί να χρησιμοποιήσετε επώνυμο τούνελ;

- **Χωρίς όρια ρυθμού**: Τα Quick Tunnels μπορεί να επιστρέψουν σφάλματα 429 με εκτεταμένη χρήση
- **Σταθερό URL**: Αποκτήστε σταθερό υποτομέα αντί για τυχαίες συμβολοσειρές
- **Προσαρμοσμένος τομέας**: Χρησιμοποιήστε τον δικό σας τομέα, όπως το `term.example.com`
- **Μεγαλύτερη αξιοπιστία**: Τα επώνυμα τούνελ είναι πιο σταθερά για μεγάλες συνεδρίες

## Ρύθμιση

### 1. Δημιουργήστε λογαριασμό Cloudflare

Εγγραφείτε στο [cloudflare.com](https://cloudflare.com) αν δεν έχετε ήδη λογαριασμό.

### 2. Δημιουργήστε τούνελ στο Zero Trust

1. Μεταβείτε στο [Cloudflare Zero Trust](https://one.dash.cloudflare.com/)
2. Μεταβείτε στις **Networks** → **Tunnels**
3. Κάντε κλικ στο **Create a tunnel**
4. Επιλέξτε το **Cloudflared** ως συνδετήρα
5. Ονομάστε το τούνελ σας (π.χ. e.g, `termbridge`)
6. Αντιγράψτε το διακριτικό του τούνελ

### 3. Προσθέστε δημόσιο όνομα κεντρικού υπολογιστή

1. Στις ρυθμίσεις του τούνελ, μεταβείτε στο **Public Hostname**
2. Προσθέστε όνομα κεντρικού υπολογιστή που δείχνει στο `http://localhost:8080` (ή στη θύρα που επιλέξατε)
3. Χρησιμοποιήστε έναν υποτομέα όπως το `term.example.com`

### 4. Εκτελέστε το Termbridge με το διακριτικό σας

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

Ή χρησιμοποιήστε μεταβλητές περιβάλλοντος:

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

termbridge --port 8080
```

> **Σημείωση**
> Η σημαία `--port` απαιτείται με τα επώνυμα τούνελ, επειδή το όνομα κεντρικού υπολογιστή έχει ρυθμιστεί να δείχνει σε συγκεκριμένη θύρα.


## Επιλογές διαμόρφωσης

| Σημαία | Μεταβλητή περιβάλλοντος | Περιγραφή |
|------|---------------------|-------------|
| `--port <port>` | - | Τοπική θύρα (απαιτείται με επώνυμα τούνελ) |
| `--tunnel-token <token>` | `TERMBRIDGE_TUNNEL_TOKEN` | Το διακριτικό του τούνελ σας |
| `--tunnel-url <url>` | `TERMBRIDGE_TUNNEL_URL` | Το δημόσιο όνομα κεντρικού υπολογιστή σας URL |

## Πλήρης απενεργοποίηση του τούνελ

Αν έχετε δικό σας αντίστροφο διακομιστή μεσολάβησης ή δημόσιο URL:

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

Ή:

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

termbridge
```

Το Termbridge θα παραλείψει την εκκίνηση τούνελ και θα χρησιμοποιήσει το URL που δώσατε για τον κωδικό QR.

## Αντιμετώπιση προβλημάτων

### «429 Too Many Requests»

Αυτό σημαίνει ότι ισχύει περιορισμός ρυθμού για τα Quick Tunnels. Λύσεις:

1. Περιμένετε λίγα λεπτά και δοκιμάστε ξανά
2. Τερματίστε τυχόν παλιές διεργασίες `cloudflared`: `pkill cloudflared`
3. Μεταβείτε σε επώνυμο τούνελ (συνιστάται)

### Το τούνελ ξεκινά, αλλά το URL δεν λειτουργεί

- Βεβαιωθείτε ότι το όνομα κεντρικού υπολογιστή στο Cloudflare ταιριάζει με το `--tunnel-url`
- Ελέγξτε ότι η θύρα στο Cloudflare ταιριάζει με το `--port`
- Βεβαιωθείτε ότι το cloudflared είναι ενημερωμένο: `cloudflared update`

### Δεν συνδέεται το επώνυμο τούνελ

- Βεβαιωθείτε ότι το διακριτικό σας είναι σωστό
- Ελέγξτε τον πίνακα ελέγχου Cloudflare Zero Trust για σφάλματα
- Δοκιμάστε να εκτελέσετε απευθείας το `cloudflared tunnel run <TOKEN>` για να δείτε τα μηνύματα σφάλματος