Dépannage de FreeGuard CLI

Vous rencontrez des problèmes avec FreeGuard CLI ? Ce guide couvre les problèmes les plus courants et leurs solutions. Pour chaque problème, essayez d’abord d’exécuter freeguard doctor — il détecte automatiquement la plupart des problèmes de configuration et d’environnement.

Problèmes d’installation

Permission refusée lors de l’installation

Symptôme : Le script d’installation échoue avec Permission denied ou EACCES.

Solution : Sur macOS/Linux, l’installateur a besoin d’un accès en écriture à /usr/local/bin. Exécutez avec des privilèges élevés :

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

Sur Windows, assurez-vous d’ouvrir PowerShell en tant qu’Administrateur avant d’exécuter la commande d’installation.

Commande introuvable après l’installation

Symptôme : L’exécution de freeguard retourne command not found ou not recognized.

Sortie Doctor :

✗ CLI binary:     Not in PATH

Solution : Le binaire n’est peut-être pas dans le PATH de votre shell. Ajoutez-le manuellement :

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

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

Sur Windows, ajoutez %USERPROFILE%\.freeguard\bin à votre variable d’environnement PATH système et redémarrez le terminal.

curl échoue ou le téléchargement expire

Symptôme : Le script d’installation ne peut pas télécharger le binaire.

Solution : Si vous êtes derrière un pare-feu d’entreprise ou dans un réseau restreint, téléchargez le binaire manuellement depuis la page des releases GitHub et placez-le dans ~/.freeguard/bin/. Rendez-le ensuite exécutable :

chmod +x ~/.freeguard/bin/freeguard

Problèmes de connexion au compte

Code de vérification non reçu

Symptôme : Après avoir exécuté freeguard login --email [email protected] --send-code, aucun e-mail n’arrive.

Solution :

Vérifiez votre dossier spam/indésirables — les e-mails de vérification sont parfois filtrés.
Attendez 2 minutes avant de redemander. Il y a une limite de débit sur l’envoi de codes.
Vérifiez que l’adresse e-mail est correcte :

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

Essayez un autre fournisseur d’e-mail si le problème persiste.

Token expiré

Symptôme : Les commandes échouent avec Authentication expired ou Token invalid.

Sortie Doctor :

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

Solution : Reconnectez-vous pour actualiser vos identifiants :

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

Mauvais e-mail — aucun abonnement trouvé

Symptôme : La connexion réussit mais freeguard connect indique No active subscription.

Sortie Doctor :

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

Solution : Assurez-vous de vous connecter avec le même e-mail que celui utilisé pour acheter votre abonnement. Si vous avez utilisé un e-mail différent :

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

Problèmes de connexion réseau

Expiration du délai de connexion

Symptôme : freeguard connect reste bloqué ou retourne Connection timed out.

Sortie Doctor :

✗ Network:         Internet not reachable

Solution :

Vérifiez votre connexion Internet de base (déconnectez d’abord le VPN) :

freeguard disconnect
ping 8.8.8.8

Essayez un nœud ou un pays différent :

freeguard connect --country SG

Essayez un protocole différent qui pourrait mieux fonctionner sur votre réseau :

freeguard connect --protocol hysteria2

Le port 7890 est déjà utilisé

Symptôme : freeguard connect échoue avec Port 7890 is already in use.

Sortie Doctor :

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

Solution : Une autre application proxy utilise le port par défaut. Arrêtez l’autre application ou changez le port proxy de FreeGuard :

freeguard config set proxy.port 8080
freeguard connect

Fuite DNS détectée

Symptôme : Les requêtes DNS contournent le tunnel VPN.

Solution : Passez à une configuration DNS sécurisée :

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Vous pouvez vérifier que le DNS est acheminé via le VPN :

freeguard doctor

Cherchez la vérification DNS dans la sortie pour confirmer qu’elle fonctionne correctement.

Problèmes de permissions

Le mode TUN nécessite sudo

Symptôme : freeguard connect --tun échoue avec Permission denied: TUN device.

Sortie Doctor :

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

Solution : Le mode TUN crée une interface réseau virtuelle, ce qui nécessite des privilèges élevés :

# macOS/Linux
sudo freeguard connect --tun

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

Si vous n’avez pas besoin d’une couverture VPN au niveau système, utilisez le mode proxy système par défaut (pas de sudo nécessaire) :

freeguard connect

Un port inférieur à 1024 nécessite des privilèges élevés

Symptôme : La configuration d’un port proxy inférieur à 1024 échoue avec Permission denied.

Solution : Les ports inférieurs à 1024 sont restreints sur la plupart des systèmes d’exploitation. Utilisez un port supérieur à 1024 :

freeguard config set proxy.port 7890

Ou exécutez avec des privilèges élevés si vous avez spécifiquement besoin d’un port bas :

sudo freeguard connect

Toujours bloqué ?

Si freeguard doctor et les solutions ci-dessus ne résolvent pas votre problème, laissez l’IA le diagnostiquer automatiquement.

Visitez la page FreeGuard CLI Agent et décrivez votre problème. L’agent peut lire la sortie de freeguard doctor --json et vous guider étape par étape vers une solution.

Vous pouvez également lancer l’assistant de dépannage interactif :

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

Questions fréquemment posées

Pourquoi FreeGuard CLI affiche-t-il “connection refused” ?

Cela signifie généralement que le serveur VPN est temporairement indisponible. Essayez freeguard connect --server auto pour sélectionner automatiquement le meilleur serveur disponible, ou vérifiez les paramètres de votre pare-feu.

Comment vérifier si ma connexion VPN fonctionne ?

Exécutez freeguard status pour voir l’état de votre connexion, le serveur actuel et le protocole. Vous pouvez également exécuter curl ifconfig.me pour vérifier que votre adresse IP a changé.

FreeGuard CLI ne démarre pas après une mise à jour système. Que faire ?

Exécutez freeguard update pour obtenir la dernière version. Si cela échoue, réinstallez avec le script d’installation : curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Comment signaler un bug ou obtenir de l’aide ?

Exécutez freeguard debug pour collecter des informations de diagnostic, puis contactez le support via le site web ou par e-mail. Incluez la sortie de debug pour une résolution plus rapide.

Dernière mise à jour : mars 2026