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

Αντιμετωπίζετε προβλήματα με το FreeGuard CLI; Αυτός ο οδηγός καλύπτει τα πιο συνηθισμένα προβλήματα και τις λύσεις τους. Για κάθε πρόβλημα, δοκιμάστε πρώτα να εκτελέσετε freeguard doctor — εντοπίζει αυτόματα τα περισσότερα προβλήματα διαμόρφωσης και περιβάλλοντος.

Προβλήματα εγκατάστασης

Άρνηση πρόσβασης κατά την εγκατάσταση

Σύμπτωμα: Το σενάριο εγκατάστασης αποτυγχάνει με Permission denied ή EACCES.

Λύση: Σε macOS/Linux, το πρόγραμμα εγκατάστασης χρειάζεται δικαιώματα εγγραφής στο /usr/local/bin. Εκτελέστε με αυξημένα δικαιώματα:

curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sudo sh

Στα Windows, βεβαιωθείτε ότι ανοίγετε το PowerShell ως Διαχειριστής πριν εκτελέσετε την εντολή εγκατάστασης.

Η εντολή δεν βρέθηκε μετά την εγκατάσταση

Σύμπτωμα: Η εκτέλεση freeguard επιστρέφει command not found ή not recognized.

Έξοδος Doctor:

✗ CLI binary:     Not in PATH

Λύση: Το εκτελέσιμο αρχείο μπορεί να μην βρίσκεται στο PATH του κελύφους σας. Προσθέστε το χειροκίνητα:

# macOS/Linux — add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="$HOME/.freeguard/bin:$PATH"

# Then reload your shell
source ~/.zshrc  # or ~/.bashrc

Στα Windows, προσθέστε %USERPROFILE%\.freeguard\bin στη μεταβλητή περιβάλλοντος PATH του συστήματός σας και επανεκκινήστε το τερματικό.

Αποτυχία curl ή λήξη χρονικού ορίου λήψης

Σύμπτωμα: Το σενάριο εγκατάστασης δεν μπορεί να κατεβάσει το εκτελέσιμο αρχείο.

Λύση: Αν βρίσκεστε πίσω από εταιρικό firewall ή σε περιορισμένο δίκτυο, κατεβάστε το εκτελέσιμο χειροκίνητα από τη σελίδα εκδόσεων στο GitHub και τοποθετήστε το στο ~/.freeguard/bin/. Στη συνέχεια, κάντε το εκτελέσιμο:

chmod +x ~/.freeguard/bin/freeguard

Προβλήματα σύνδεσης

Δεν ελήφθη κωδικός επαλήθευσης

Σύμπτωμα: Μετά την εκτέλεση freeguard login --email [email protected] --send-code, δεν φτάνει κανένα email.

Λύση:

Ελέγξτε τον φάκελο ανεπιθύμητης αλληλογραφίας — τα email επαλήθευσης μερικές φορές φιλτράρονται.
Περιμένετε 2 λεπτά πριν ζητήσετε ξανά. Υπάρχει όριο ρυθμού αποστολής κωδικών.
Επαληθεύστε ότι η διεύθυνση email είναι σωστή:

freeguard login --email [email protected] --send-code

Δοκιμάστε διαφορετικό πάροχο email αν το πρόβλημα επιμένει.

Το token έληξε

Σύμπτωμα: Οι εντολές αποτυγχάνουν με Authentication expired ή Token invalid.

Έξοδος Doctor:

✗ Credentials:     Token expired (last refresh: 2026-03-01)

Λύση: Συνδεθείτε ξανά για να ανανεώσετε τα διαπιστευτήριά σας:

freeguard logout
freeguard login --email [email protected] --send-code

Λάθος email — δεν βρέθηκε συνδρομή

Σύμπτωμα: Η σύνδεση επιτυγχάνει αλλά το freeguard connect λέει No active subscription.

Έξοδος Doctor:

✓ Credentials:     Logged in (email: u***@example.com)
✗ Subscription:    No active subscription found

Λύση: Βεβαιωθείτε ότι συνδέεστε με το ίδιο email που χρησιμοποιήσατε για να αγοράσετε τη συνδρομή σας. Αν χρησιμοποιήσατε διαφορετικό email:

freeguard logout
freeguard login --email [email protected] --send-code

Προβλήματα σύνδεσης δικτύου

Λήξη χρονικού ορίου σύνδεσης

Σύμπτωμα: Το freeguard connect κολλάει ή επιστρέφει Connection timed out.

Έξοδος Doctor:

✗ Network:         Internet not reachable

Λύση:

Ελέγξτε τη βασική σύνδεσή σας στο διαδίκτυο (αποσυνδέστε πρώτα το VPN):

freeguard disconnect
ping 8.8.8.8

Δοκιμάστε διαφορετικό κόμβο ή χώρα:

freeguard connect --country SG

Δοκιμάστε διαφορετικό πρωτόκολλο που μπορεί να λειτουργεί καλύτερα στο δίκτυό σας:

freeguard connect --protocol hysteria2

Η θύρα 7890 χρησιμοποιείται ήδη

Σύμπτωμα: Το freeguard connect αποτυγχάνει με Port 7890 is already in use.

Έξοδος Doctor:

✗ Port 7890:       In use by another process (PID: 12345)

Λύση: Μια άλλη εφαρμογή proxy χρησιμοποιεί την προεπιλεγμένη θύρα. Είτε σταματήστε την άλλη εφαρμογή, είτε αλλάξτε τη θύρα proxy του FreeGuard:

freeguard config set proxy.port 8080
freeguard connect

Εντοπίστηκε διαρροή DNS

Σύμπτωμα: Τα ερωτήματα DNS παρακάμπτουν τη σήραγγα VPN.

Λύση: Μεταβείτε σε ασφαλή διαμόρφωση DNS:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Μπορείτε να επαληθεύσετε ότι το DNS δρομολογείται μέσω του VPN:

freeguard doctor

Αναζητήστε τον έλεγχο DNS στην έξοδο για να επιβεβαιώσετε ότι λειτουργεί σωστά.

Προβλήματα δικαιωμάτων

Η λειτουργία TUN απαιτεί sudo

Σύμπτωμα: Το freeguard connect --tun αποτυγχάνει με Permission denied: TUN device.

Έξοδος Doctor:

✗ TUN permission:  Not available (run with sudo for TUN mode)

Λύση: Η λειτουργία TUN δημιουργεί μια εικονική διεπαφή δικτύου, η οποία απαιτεί αυξημένα δικαιώματα:

# macOS/Linux
sudo freeguard connect --tun

# Windows — run PowerShell as Administrator
freeguard connect --tun

Αν δεν χρειάζεστε κάλυψη VPN σε επίπεδο συστήματος, χρησιμοποιήστε την προεπιλεγμένη λειτουργία proxy συστήματος (δεν απαιτείται sudo):

freeguard connect

Θύρα κάτω από 1024 απαιτεί αυξημένα δικαιώματα

Σύμπτωμα: Ο ορισμός θύρας proxy κάτω από 1024 αποτυγχάνει με Permission denied.

Λύση: Οι θύρες κάτω από 1024 είναι περιορισμένες στα περισσότερα λειτουργικά συστήματα. Χρησιμοποιήστε θύρα πάνω από 1024:

freeguard config set proxy.port 7890

Ή εκτελέστε με αυξημένα δικαιώματα αν χρειάζεστε συγκεκριμένα χαμηλή θύρα:

sudo freeguard connect

Εξακολουθείτε να έχετε πρόβλημα;

Αν το freeguard doctor και οι παραπάνω λύσεις δεν επιλύσουν το πρόβλημά σας, αφήστε την AI να το διαγνώσει αυτόματα.

Επισκεφτείτε τη σελίδα FreeGuard CLI Agent και περιγράψτε το πρόβλημά σας. Ο πράκτορας μπορεί να διαβάσει την έξοδο freeguard doctor --json και να σας καθοδηγήσει βήμα βήμα στην επίλυση.

Μπορείτε επίσης να εκτελέσετε τον διαδραστικό οδηγό αντιμετώπισης προβλημάτων:

freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat

Συχνές ερωτήσεις

Γιατί το FreeGuard CLI λέει “connection refused”;

Αυτό συνήθως σημαίνει ότι ο VPN server είναι προσωρινά μη διαθέσιμος. Δοκιμάστε freeguard connect --server auto για αυτόματη επιλογή του καλύτερου διαθέσιμου server, ή ελέγξτε τις ρυθμίσεις firewall.

Πώς μπορώ να ελέγξω αν η σύνδεση VPN λειτουργεί;

Εκτελέστε freeguard status για να δείτε την κατάσταση σύνδεσης, τον τρέχοντα server και το πρωτόκολλο. Μπορείτε επίσης να εκτελέσετε curl ifconfig.me για να επαληθεύσετε ότι η IP σας έχει αλλάξει.

Το FreeGuard CLI δεν ξεκινά μετά από ενημέρωση συστήματος. Τι πρέπει να κάνω;

Εκτελέστε freeguard update για να λάβετε την τελευταία έκδοση. Αν αποτύχει, επανεγκαταστήστε με το σενάριο εγκατάστασης: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Πώς αναφέρω ένα σφάλμα ή λαμβάνω βοήθεια;

Εκτελέστε freeguard debug για να συλλέξετε διαγνωστικές πληροφορίες και στη συνέχεια επικοινωνήστε με την υποστήριξη μέσω της ιστοσελίδας ή email. Συμπεριλάβετε την έξοδο debug για ταχύτερη επίλυση.

Τελευταία ενημέρωση: Μάρτιος 2026