FreeGuard CLI Fehlerbehebung
Probleme mit FreeGuard CLI? Diese Anleitung behandelt die häufigsten Probleme und ihre Lösungen. Probieren Sie bei jedem Problem zuerst freeguard doctor aus — es erkennt automatisch die meisten Konfigurations- und Umgebungsprobleme.
Installationsprobleme
Zugriff verweigert bei der Installation
Symptom: Das Installationsskript schlägt mit Permission denied oder EACCES fehl.
Lösung: Unter macOS/Linux benötigt der Installer Schreibzugriff auf /usr/local/bin. Führen Sie es mit erhöhten Rechten aus:
curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sudo sh
Unter Windows stellen Sie sicher, dass Sie PowerShell als Administrator öffnen, bevor Sie den Installationsbefehl ausführen.
Befehl nach der Installation nicht gefunden
Symptom: Das Ausführen von freeguard gibt command not found oder not recognized zurück.
Doctor-Ausgabe:
✗ CLI binary: Not in PATH
Lösung: Die Binärdatei befindet sich möglicherweise nicht im PATH Ihrer Shell. Fügen Sie sie manuell hinzu:
# macOS/Linux — add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="$HOME/.freeguard/bin:$PATH"
# Then reload your shell
source ~/.zshrc # or ~/.bashrc
Unter Windows fügen Sie %USERPROFILE%\.freeguard\bin zu Ihrer System-PATH-Umgebungsvariable hinzu und starten Sie das Terminal neu.
curl schlägt fehl oder Download-Timeout
Symptom: Das Installationsskript kann die Binärdatei nicht herunterladen.
Lösung: Wenn Sie sich hinter einer Unternehmens-Firewall oder in einem eingeschränkten Netzwerk befinden, laden Sie die Binärdatei manuell von der GitHub-Releases-Seite herunter und legen Sie sie in ~/.freeguard/bin/ ab. Machen Sie sie dann ausführbar:
chmod +x ~/.freeguard/bin/freeguard
Anmeldeprobleme
Bestätigungscode nicht erhalten
Symptom: Nach dem Ausführen von freeguard login --email [email protected] --send-code kommt keine E-Mail an.
Lösung:
- Überprüfen Sie Ihren Spam-/Junk-Ordner — Bestätigungs-E-Mails werden manchmal gefiltert.
- Warten Sie 2 Minuten, bevor Sie erneut anfordern. Es gibt ein Ratenlimit für den Code-Versand.
- Überprüfen Sie, ob die E-Mail-Adresse korrekt ist:
freeguard login --email [email protected] --send-code
- Versuchen Sie einen anderen E-Mail-Anbieter, wenn das Problem weiterhin besteht.
Token abgelaufen
Symptom: Befehle schlagen mit Authentication expired oder Token invalid fehl.
Doctor-Ausgabe:
✗ Credentials: Token expired (last refresh: 2026-03-01)
Lösung: Melden Sie sich erneut an, um Ihre Anmeldedaten zu aktualisieren:
freeguard logout
freeguard login --email [email protected] --send-code
Falsche E-Mail — kein Abonnement gefunden
Symptom: Die Anmeldung ist erfolgreich, aber freeguard connect meldet No active subscription.
Doctor-Ausgabe:
✓ Credentials: Logged in (email: u***@example.com)
✗ Subscription: No active subscription found
Lösung: Stellen Sie sicher, dass Sie sich mit derselben E-Mail-Adresse anmelden, mit der Sie Ihr Abonnement erworben haben. Wenn Sie eine andere E-Mail verwendet haben:
freeguard logout
freeguard login --email [email protected] --send-code
Verbindungsprobleme
Verbindungs-Timeout
Symptom: freeguard connect hängt oder gibt Connection timed out zurück.
Doctor-Ausgabe:
✗ Network: Internet not reachable
Lösung:
- Überprüfen Sie Ihre grundlegende Internetverbindung (trennen Sie zuerst die VPN-Verbindung):
freeguard disconnect
ping 8.8.8.8
- Versuchen Sie einen anderen Knoten oder ein anderes Land:
freeguard connect --country SG
- Versuchen Sie ein anderes Protokoll, das in Ihrem Netzwerk möglicherweise besser funktioniert:
freeguard connect --protocol hysteria2
Port 7890 wird bereits verwendet
Symptom: freeguard connect schlägt mit Port 7890 is already in use fehl.
Doctor-Ausgabe:
✗ Port 7890: In use by another process (PID: 12345)
Lösung: Eine andere Proxy-Anwendung verwendet den Standardport. Stoppen Sie entweder die andere Anwendung oder ändern Sie den FreeGuard-Proxy-Port:
freeguard config set proxy.port 8080
freeguard connect
DNS-Leak erkannt
Symptom: DNS-Anfragen umgehen den VPN-Tunnel.
Lösung: Wechseln Sie zu einer sicheren DNS-Konfiguration:
freeguard config set dns.provider secure
freeguard disconnect
freeguard connect
Sie können überprüfen, ob DNS über das VPN geleitet wird:
freeguard doctor
Suchen Sie in der Ausgabe nach der DNS-Prüfung, um zu bestätigen, dass sie korrekt funktioniert.
Berechtigungsprobleme
TUN-Modus erfordert sudo
Symptom: freeguard connect --tun schlägt mit Permission denied: TUN device fehl.
Doctor-Ausgabe:
✗ TUN permission: Not available (run with sudo for TUN mode)
Lösung: Der TUN-Modus erstellt eine virtuelle Netzwerkschnittstelle, was erhöhte Rechte erfordert:
# macOS/Linux
sudo freeguard connect --tun
# Windows — run PowerShell as Administrator
freeguard connect --tun
Wenn Sie keine systemweite VPN-Abdeckung benötigen, verwenden Sie stattdessen den Standard-System-Proxy-Modus (kein sudo erforderlich):
freeguard connect
Port unter 1024 erfordert erhöhte Rechte
Symptom: Das Festlegen eines Proxy-Ports unter 1024 schlägt mit Permission denied fehl.
Lösung: Ports unter 1024 sind auf den meisten Betriebssystemen eingeschränkt. Verwenden Sie einen Port über 1024:
freeguard config set proxy.port 7890
Oder führen Sie mit erhöhten Rechten aus, wenn Sie speziell einen niedrigen Port benötigen:
sudo freeguard connect
Immer noch festgefahren?
Wenn freeguard doctor und die obigen Lösungen Ihr Problem nicht beheben, lassen Sie die KI es automatisch diagnostizieren.
Besuchen Sie die FreeGuard CLI Agent-Seite und beschreiben Sie Ihr Problem. Der Agent kann Ihre freeguard doctor --json-Ausgabe lesen und Sie Schritt für Schritt durch eine Lösung führen.
Sie können auch den interaktiven Fehlerbehebungsassistenten ausführen:
freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat
Häufig gestellte Fragen
Warum sagt FreeGuard CLI “connection refused”?
Das bedeutet normalerweise, dass der VPN-Server vorübergehend nicht verfügbar ist. Versuchen Sie freeguard connect --server auto, um automatisch den besten verfügbaren Server auszuwählen, oder überprüfen Sie Ihre Firewall-Einstellungen.
Wie überprüfe ich, ob meine VPN-Verbindung funktioniert?
Führen Sie freeguard status aus, um Ihren Verbindungsstatus, aktuellen Server und Protokoll zu sehen. Sie können auch curl ifconfig.me ausführen, um zu überprüfen, ob sich Ihre IP-Adresse geändert hat.
FreeGuard CLI startet nach einem Systemupdate nicht. Was soll ich tun?
Führen Sie freeguard update aus, um die neueste Version zu erhalten. Wenn das fehlschlägt, installieren Sie mit dem Installationsskript neu: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.
Wie melde ich einen Fehler oder erhalte Hilfe?
Führen Sie freeguard debug aus, um Diagnoseinformationen zu sammeln, und kontaktieren Sie dann den Support über die Website oder per E-Mail. Fügen Sie die Debug-Ausgabe für eine schnellere Lösung bei.
Zuletzt aktualisiert: März 2026