Does FreeGuard have a Linux GUI application?

No. FreeGuard for Linux is the freeguard command-line client. If you want a graphical interface, use the Windows or Mac app.

How do I route only some traffic through the VPN on Linux?

Use routing rules or GeoIP region routing. freeguard rule add sends specific domains or IP ranges direct or through the VPN, and freeguard config set geoip_region CN sends one region's traffic direct while the rest stays on the VPN.

Is the Linux CLI free?

Installing it is free. Connecting uses your FreeGuard subscription; run freeguard subscribe list to see the plans.

Can I install FreeGuard from my distribution's package manager?

Not from official distribution repositories. Use our install script, Homebrew, or a binary from GitHub Releases. We do not publish to apt, dnf, pacman or the AUR.

Does the CLI work on headless servers and Docker?

Yes. The CLI is a single Go binary with no GUI dependencies. It runs over SSH, inside containers and on minimal base images, as long as a container has the network capabilities it needs to create a TUN device.

FreeGuard for Linux: Command-Line VPN with Rules and GeoIP Routing

FreeGuard pour Linux est un client en ligne de commande conçu pour les serveurs et les développeurs : acheminez le trafic selon vos propres règles ou par région avec GeoIP, automatisez son utilisation avec une sortie JSON et exécutez-le en tant que service utilisateur systemd. Installez-le avec une seule commande sur x86_64 ou arm64.

FreeGuard sur Linux est un client en ligne de commande

Un binaire Go unique qui configure le cœur mihomo pour vous. Pour une application graphique, utilisez FreeGuard pour Windows ou Mac.

L’interface en ligne de commande freeguard gère la connexion à votre compte, le choix du serveur, la connexion, les règles de routage et le démarrage automatique depuis le terminal. Il s’agit d’un binaire Go unique pour Linux x86_64 et arm64 qui configure le cœur mihomo pour vous. Il convient donc aux serveurs, aux conteneurs et aux installations minimales, ainsi qu’aux ordinateurs portables des développeurs.

Il n’existe pas d’application de bureau Linux. Si vous souhaitez une interface graphique, utilisez l’application FreeGuard pour Windows ou Mac.

Acheminez le trafic comme vous le souhaitez : règles et routage par région GeoIP

Rédigez vos propres règles de routage ou faites passer directement le trafic d’une région, puis vérifiez le résumé du routage après vous être connecté.

Mode règles par défaut : les règles de routage déterminent quel trafic passe par le VPN et lequel passe en direct, et freeguard connect affiche un résumé du routage en langage clair
Règles personnalisées : freeguard rule add DOMAIN example.com DIRECT ajoute une règle ; rule list, rule remove et rule import (depuis une URL ou un fichier) permettent de gérer le reste
Routage par région GeoIP : freeguard config set geoip_region CN achemine directement le trafic d’une région, comme CN ou JP, tandis que tout le reste reste sur le VPN
Mode TUN : freeguard connect --tun intercepte tout le trafic de la machine ; sans ce mode, FreeGuard fournit un proxy local que vos applications peuvent utiliser

Installer FreeGuard sous Linux

Trois méthodes d’installation prises en charge : notre script d’installation, Homebrew ou GitHub Releases. Il n’existe aucun dépôt officiel apt, dnf ou pacman.

Script d’installation (recommandé) :

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

Installer avec Homebrew :

brew install planetlinkinc/tap/freeguardvpn

Binaire direct : téléchargez la version correspondant à votre architecture depuis GitHub Releases.

Nous ne publions pas de paquets .deb, .rpm ou Arch via les dépôts des distributions ; il n’existe donc pas de apt install freeguard, dnf install freeguard ou pacman -S freeguard.

Plus de fonctionnalités CLI

Protocoles : anytls, hysteria2 et trojan ; choisissez-en un par connexion, par exemple freeguard connect la2 anytls
Sélection du serveur : freeguard connect la2 ou hk1 avec un alias, freeguard connect US pour le meilleur serveur aux États-Unis, ou freeguard connect sans argument pour réutiliser votre dernier serveur ou choisir le meilleur
Démarrage automatique : freeguard autostart enable installe un service systemd utilisateur dans ~/.config/systemd/user/freeguard.service (aucun démon root requis)
Diagnostics : freeguard doctor vérifie votre environnement
État et surveillance : freeguard status et freeguard monitor affichent les détails de la connexion en temps réel
Scripts : ajoutez --json à une commande pour obtenir une sortie lisible par les scripts et les agents IA

Comment commencer

Étape 1 : Exécutez curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh
Étape 2 : Exécutez freeguard init et connectez-vous avec votre compte FreeGuard
Étape 3 : Exécutez freeguard connect (ou freeguard connect la2 pour un serveur spécifique)

Foire aux questions

FreeGuard propose-t-il une application graphique pour Linux ?

Non. FreeGuard pour Linux est le client en ligne de commande freeguard. Si vous souhaitez une interface graphique, utilisez l’application Windows ou Mac.

Comment ne faire passer qu’une partie du trafic par le VPN sous Linux ?

Utilisez des règles de routage ou le routage par région GeoIP. freeguard rule add achemine des domaines ou plages d’adresses IP spécifiques directement ou via le VPN, et freeguard config set geoip_region CN achemine directement le trafic d’une région tandis que le reste passe par le VPN.

L’interface en ligne de commande Linux est-elle gratuite ?

Son installation est gratuite. La connexion nécessite votre abonnement FreeGuard ; exécutez freeguard subscribe list pour voir les offres.

Puis-je installer FreeGuard depuis le gestionnaire de paquets de ma distribution ?

Pas depuis les dépôts officiels de votre distribution. Utilisez notre script d’installation (install.sh), Homebrew ou un binaire des GitHub Releases. Nous ne publions pas de paquets sur apt, dnf, pacman ou l’AUR.

Le CLI fonctionne-t-il sur les serveurs sans interface graphique et dans Docker ?

Oui. La CLI est un binaire Go unique sans dépendances d’interface graphique. Elle fonctionne via SSH, dans des conteneurs et sur des images de base minimales, à condition qu’un conteneur dispose des capacités réseau nécessaires pour créer un périphérique TUN.

Puis-je démarrer FreeGuard automatiquement au démarrage ?

Oui. freeguard autostart enable installe un service systemd utilisateur dans ~/.config/systemd/user/freeguard.service. Il s’exécute sous votre compte utilisateur, et non en tant que démon root.

Quelles architectures et distributions sont prises en charge ?

Linux x86_64 et arm64. La CLI est un seul binaire Go qui configure le cœur mihomo pour vous ; toute distribution moderne dotée d’un noyau récent devrait donc fonctionner. Nous testons principalement sur Ubuntu et Debian.

La CLI Linux utilise-t-elle les mêmes protocoles que les applications de bureau ?

Oui. anytls, hysteria2 et trojan fonctionnent tous dans la CLI, sur le même cœur mihomo que celui utilisé par les applications Windows et Mac.

Comment désinstaller la CLI ?

Si vous avez utilisé le script d’installation, supprimez le binaire freeguard de /usr/local/bin (ou de ~/.local/bin) et supprimez ~/.freeguard. Avec Homebrew, exécutez brew uninstall freeguardvpn. Si vous avez activé le démarrage automatique, exécutez d’abord freeguard autostart disable.