Démarrage rapide de FreeGuard CLI
FreeGuard CLI est un client VPN en ligne de commande qui se connecte en une seule commande. Installez-le sur macOS, Linux ou Windows, connectez-vous avec votre e-mail, puis exécutez freeguard connect pour sécuriser votre connexion Internet en moins de 5 minutes.
Installation
macOS et Linux
Installez avec une seule commande :
curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh
Ou utilisez Homebrew sur macOS :
brew install freeguardvpn/tap/freeguard
Après l’installation, vérifiez que cela a fonctionné :
freeguard version
Sortie attendue :
FreeGuard CLI v1.0.0
Core: mihomo v1.19.21
OS: darwin/arm64
Windows
Ouvrez PowerShell en tant qu’administrateur et exécutez :
irm https://downloadcli.freeguardvpn.com/cli/install.ps1 | iex
Après l’installation, redémarrez votre terminal et exécutez freeguard version pour confirmer.
Connexion
FreeGuard CLI utilise une vérification basée sur l’e-mail — aucune inscription de compte n’est requise.
freeguard login --email [email protected] --send-code
Vous recevrez un code de vérification à 6 chiffres à votre adresse e-mail. Saisissez-le :
freeguard login --email [email protected] --code 123456
Exemple de sortie :
✓ Connexion réussie !
✓ 1 abonnement actif trouvé (Pro Plan, expire le 2026-12-01)
✓ Configuration générée : ~/.freeguard/profiles/default.yaml
Si vous avez un compte FreeGuard, vous pouvez également vous connecter via le navigateur :
freeguard login --account
Cela ouvre votre navigateur pour une authentification OAuth et renvoie automatiquement un jeton.
Connexion
Connectez-vous au serveur le plus rapide disponible avec une seule commande :
freeguard connect
Exemple de sortie :
✓ Connecté à United States - New York (us-new-01)
Protocol: anytls | Latency: 42ms
Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)
Pour se connecter à un pays spécifique :
freeguard connect --country JP
Pour se connecter à un nœud spécifique :
freeguard connect jp-tok-01
Vérification
Vérifiez que votre connexion est active :
freeguard status
Exemple de sortie :
FreeGuard VPN Status
────────────────────
Status: ● Connected
Node: United States - New York (us-new-01)
Protocol: anytls
Latency: 42ms
Upload: 1.2 MB/s
Download: 15.8 MB/s
Duration: 2h 15m
Mode: System Proxy (HTTP/SOCKS5)
Pour obtenir une sortie lisible par machine (utile pour les scripts ou les agents IA) :
freeguard status --json
{
"connected": true,
"node": {"id": "us-new-01", "name": "United States - New York", "country": "US"},
"protocol": "anytls",
"latency_ms": 42,
"traffic": {"upload_bps": 1258291, "download_bps": 16569754},
"duration_seconds": 8100,
"mode": "system_proxy",
"proxy_port": {"mixed": 7890}
}
Étapes suivantes
- Référence des commandes CLI — Liste complète de toutes les commandes, options et formats de sortie.
- Dépannage CLI — Solutions aux problèmes courants d’installation, de connexion et de connexion.
- FreeGuard CLI Agent — Laissez l’IA diagnostiquer et corriger automatiquement les problèmes pour vous.
- Exécutez
freeguard --helppour explorer toutes les commandes disponibles depuis votre terminal.
Questions fréquemment posées
Comment installer FreeGuard CLI sur mon système ?
Exécutez curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh sur macOS ou Linux. Sur macOS, vous pouvez aussi utiliser brew install freeguard. L’installateur détecte automatiquement votre OS et votre architecture.
Puis-je utiliser FreeGuard CLI sans interface graphique ?
Oui. FreeGuard CLI est entièrement sans interface graphique — il s’exécute entièrement dans le terminal sans interface graphique requise. Cela le rend idéal pour les serveurs, les conteneurs et les sessions SSH distantes.
Comment changer de protocoles VPN avec la CLI ?
Utilisez freeguard connect --protocol <name>. Les protocoles pris en charge incluent Hysteria2, Anytls et Trojan. La CLI utilise par défaut le protocole le plus rapide disponible pour votre réseau.
FreeGuard CLI fonctionne-t-il sur les appareils ARM comme Raspberry Pi ?
Oui. La CLI prend en charge les architectures arm64 et armv7. Le script d’installation détecte automatiquement votre plateforme et télécharge le binaire approprié.
Dernière mise à jour : mars 2026