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

## "spawn tmux ENOENT"

Το tmux δεν είναι εγκατεστημένο ή δεν βρίσκεται στο PATH σας. Το Termbridge εμφανίζει αυτό το σφάλμα, αλλά προς το παρόν συνεχίζει να εκτελείται χωρίς να διαθέτει τερματικό ([#4](https://github.com/inline0/termbridge/issues/4))· πατήστε `Ctrl+C`, εγκαταστήστε το tmux και εκκινήστε το ξανά.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

## "spawn cloudflared ENOENT"

Το πρόγραμμα-πελάτης tunnel του Cloudflare δεν είναι εγκατεστημένο ή δεν βρίσκεται στο PATH σας. Απαιτείται μόνο για τη λειτουργία tunnel· οι λειτουργίες `--no-tunnel` και Daytona άμεσης σύνδεσης δεν χρειάζονται το cloudflared.

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

Για το Linux, κάντε λήψη από το [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/).

## Το tunnel δεν ξεκινά

Μερικά πράγματα που μπορείτε να ελέγξετε (παραλείψτε αυτό το βήμα αν χρησιμοποιείτε άμεση λειτουργία sandbox):

1. Επιβεβαιώστε ότι το cloudflared λειτουργεί: `cloudflared --version`
2. Βεβαιωθείτε ότι έχετε πρόσβαση στο `https://trycloudflare.com`
3. Ελέγξτε αν κάποιο τείχος προστασίας αποκλείει τις εξερχόμενες συνδέσεις

Αν το tunnel δεν ξεκινήσει, το Termbridge εμφανίζει το σφάλμα, σταματά τον διακομιστή του και τερματίζεται με κατάσταση 1. Δεν μεταβαίνει σε λειτουργία μόνο τοπικής πρόσβασης, και ο διακομιστής ακούει μόνο στη διεύθυνση `127.0.0.1` από προεπιλογή, επομένως οι άλλες συσκευές στο δίκτυό σας δεν μπορούν να συνδεθούν σε αυτόν. Οι συνεδρίες tmux που δημιουργήθηκαν για αυτήν την εκτέλεση παραμένουν ενεργές ([#4](https://github.com/inline0/termbridge/issues/4)).

Για να χρησιμοποιήσετε το Termbridge χωρίς το tunnel Cloudflare, εκτελέστε το με το `--no-tunnel --public-url <url>` πίσω από δικό σας αντίστροφο διακομιστή μεσολάβησης ή tunnel.

## «429 Πάρα πολλά αιτήματα» από το trycloudflare

Το Cloudflare επιβάλλει όρια ρυθμού στα tunnel χωρίς λογαριασμό. Αν δείτε σφάλματα όπως το `429 Too Many Requests`, δοκιμάστε:

1. Περιμένετε λίγα λεπτά και δοκιμάστε ξανά
2. Βεβαιωθείτε ότι δεν εκτελούνται ακόμα παλιές διεργασίες `cloudflared`
3. Χρησιμοποιήστε token ονομασμένου tunnel (συνιστάται για συχνή χρήση)

## Κενή οθόνη ή «Δεν ήταν δυνατή η φόρτωση των τερματικών»

Αυτό συνήθως σημαίνει ότι το πρόγραμμα περιήγησης δεν διαθέτει έγκυρο cookie συνεδρίας, για παράδειγμα επειδή ανοίχτηκε χωρίς εξαργύρωση συνδέσμου κοινής χρήσης ή επειδή άλλαξε το tunnel URL:

1. Ελέγξτε αν ο τοπικός διακομιστής εξακολουθεί να εκτελείται
2. Ελέγξτε την κονσόλα του προγράμματος περιήγησης για σφάλματα 401/403
3. Επανεκκινήστε το Termbridge για να λάβετε νέο κωδικό URL και QR

## Δεν εμφανίζεται έξοδος στο τερματικό

Η συνεδρία tmux μπορεί να μην εκτελείται:

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

Αν εμφανίζονται συνεδρίες αλλά το τερματικό είναι κενό, δοκιμάστε:
- Να φορτώσετε ξανά τη σελίδα
- Να ελέγξετε ότι το κέλυφός σας υποστηρίζει το `TERM=xterm-256color`

## Σαρώνεται ο κωδικός QR, αλλά η σελίδα είναι κενή

Ο κωδικός QR περιέχει ένα token μίας χρήσης. Λειτουργεί μία φορά και μόνο εντός 90 δευτερολέπτων από την εκκίνηση του Termbridge. Ένας σύνδεσμος που έχει χρησιμοποιηθεί ή έχει λήξει επιστρέφει `invalid token`.

Λύση: Επανεκκινήστε το Termbridge για να δημιουργήσετε νέο κωδικό QR και σαρώστε τον αμέσως.

## Σφάλματα του node-pty σχετικά με το spawn-helper

Το Termbridge προσπαθεί να το διορθώσει αυτόματα, αλλά αν εμφανιστούν σφάλματα δικαιωμάτων:

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

## Εξακολουθείτε να αντιμετωπίζετε πρόβλημα;

Ανοίξτε ένα issue στο [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues) με τα εξής:
- Το λειτουργικό σας σύστημα και την έκδοση Node.js
- Το μήνυμα σφάλματος
- Τα βήματα αναπαραγωγής