Μετάβαση στο περιεχόμενο

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

Προβολή ως Markdown Επεξεργασία στο GitHub Τεκμηρίωση στο 1675df8

"spawn tmux ENOENT"

Το tmux δεν είναι εγκατεστημένο ή δεν βρίσκεται στο PATH σας. Το Termbridge εμφανίζει αυτό το σφάλμα, αλλά προς το παρόν συνεχίζει να εκτελείται χωρίς να διαθέτει τερματικό (#4)· πατήστε Ctrl+C, εγκαταστήστε το tmux και εκκινήστε το ξανά.

Κέλυφος
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

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

Κέλυφος
# macOS
brew install cloudflared

Για το Linux, κάντε λήψη από το cloudflare.com/downloads.

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

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

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

Αν το tunnel δεν ξεκινήσει, το Termbridge εμφανίζει το σφάλμα, σταματά τον διακομιστή του και τερματίζεται με κατάσταση 1. Δεν μεταβαίνει σε λειτουργία μόνο τοπικής πρόσβασης, και ο διακομιστής ακούει μόνο στη διεύθυνση 127.0.0.1 από προεπιλογή, επομένως οι άλλες συσκευές στο δίκτυό σας δεν μπορούν να συνδεθούν σε αυτόν. Οι συνεδρίες tmux που δημιουργήθηκαν για αυτήν την εκτέλεση παραμένουν ενεργές (#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 μπορεί να μην εκτελείται:

Κέλυφος
# Check if sessions exist
tmux ls

Αν εμφανίζονται συνεδρίες αλλά το τερματικό είναι κενό, δοκιμάστε:

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

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

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

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

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

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

Κέλυφος
chmod +x node_modules/node-pty/prebuilds/**/spawn-helper

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

Ανοίξτε ένα issue στο github.com/inline0/termbridge με τα εξής:

  • Το λειτουργικό σας σύστημα και την έκδοση Node.js
  • Το μήνυμα σφάλματος
  • Τα βήματα αναπαραγωγής