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

FreeGuard per Linux è un client da riga di comando pensato per server e sviluppatori: instrada il traffico con regole definite da te o per area geografica con GeoIP, automatizzalo con l’output JSON ed eseguilo come servizio utente systemd. Installalo con un solo comando su x86_64 o arm64.

FreeGuard su Linux è un client da riga di comando

Un singolo binario Go che configura automaticamente il core mihomo. Per un’app grafica, usa FreeGuard per Windows o Mac.

La CLI freeguard gestisce l’accesso, la selezione del server, la connessione, le regole di instradamento e l’avvio automatico dal terminale. È un unico binario Go per Linux x86_64 e arm64 che configura il core mihomo, quindi è adatto a server, container e installazioni minime, oltre che ai laptop degli sviluppatori.

Non è disponibile un’app desktop per Linux. Se desideri un’interfaccia grafica, usa l’app FreeGuard per Windows o Mac.

Instrada il traffico come preferisci: regole e routing per area geografica GeoIP

Scrivi le tue regole di routing oppure instrada direttamente il traffico di una regione, quindi controlla il riepilogo del routing dopo la connessione.

• Modalità regole predefinita: le regole di routing decidono quale traffico passa attraverso la VPN e quale viene instradato direttamente, e freeguard connect stampa un riepilogo del routing in linguaggio semplice
• Regole personalizzate: freeguard rule add DOMAIN example.com DIRECT aggiunge una regola; rule list, rule remove e rule import (da un URL o da un file) gestiscono il resto
• Instradamento GeoIP per regione: freeguard config set geoip_region CN invia direttamente il traffico di una regione, ad esempio CN o JP, mentre tutto il resto rimane sulla VPN
• Modalità TUN: freeguard connect --tun intercetta tutto il traffico della macchina; senza questa modalità, FreeGuard fornisce un proxy locale che le tue app possono usare

Installare FreeGuard su Linux

Tre modalità di installazione supportate: il nostro script di installazione, Homebrew o GitHub Releases. Non esistono repository ufficiali apt, dnf o pacman.

Script di installazione (consigliato):

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

Installa con Homebrew:

brew install planetlinkinc/tap/freeguardvpn

Binario diretto: scarica la release per la tua architettura da GitHub Releases.

Non pubblichiamo pacchetti .deb, .rpm o Arch tramite i repository delle distribuzioni, quindi non è possibile usare apt install freeguard, dnf install freeguard o pacman -S freeguard.

Altre funzionalità CLI

• Protocolli: anytls, hysteria2 e trojan; scegline uno per connessione, ad esempio freeguard connect la2 anytls
• Selezione del server: freeguard connect la2 o hk1 tramite alias, freeguard connect US per il miglior server negli Stati Uniti, oppure freeguard connect senza argomenti per riutilizzare l’ultimo server o scegliere il migliore
• Avvio automatico: freeguard autostart enable installa un servizio systemd utente in ~/.config/systemd/user/freeguard.service (non è necessario alcun demone root)
• Diagnostica: freeguard doctor controlla il tuo ambiente
• Stato e monitoraggio: freeguard status e freeguard monitor mostrano i dettagli della connessione in tempo reale
• Scripting: aggiungi --json a un comando per ottenere un output leggibile da script e agenti IA

Come iniziare

1. Passaggio 1: Esegui curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh
2. Passaggio 2: Esegui freeguard init e accedi con il tuo account FreeGuard
3. Passaggio 3: Esegui freeguard connect (oppure freeguard connect la2 per un server specifico)

Domande frequenti

FreeGuard dispone di un’applicazione con interfaccia grafica per Linux?

No. FreeGuard per Linux è il client da riga di comando freeguard. Se desideri un’interfaccia grafica, usa l’app per Windows o Mac.

Come instradare solo parte del traffico tramite la VPN su Linux?

Usa regole di instradamento o l’instradamento per regione GeoIP. freeguard rule add invia domini specifici o intervalli IP direttamente o tramite la VPN, mentre freeguard config set geoip_region CN invia direttamente il traffico di una regione e mantiene il resto sulla VPN.

La CLI per Linux è gratuita?

Installarlo è gratuito. Per connetterti è necessario un abbonamento FreeGuard; esegui freeguard subscribe list per vedere i piani.

Posso installare FreeGuard dal gestore di pacchetti della mia distribuzione?

Non dai repository ufficiali della distribuzione. Usa il nostro script di installazione (install.sh), Homebrew o un binario da GitHub Releases. Non pubblichiamo su apt, dnf, pacman o AUR.

La CLI funziona su server headless e Docker?

Sì. La CLI è un singolo binario Go senza dipendenze dalla GUI. Funziona tramite SSH, all’interno di container e su immagini base minimali, purché un container disponga delle capacità di rete necessarie per creare un dispositivo TUN.

Posso avviare FreeGuard automaticamente all’avvio?

Sì. freeguard autostart enable installa un servizio utente di systemd in ~/.config/systemd/user/freeguard.service. Viene eseguito come utente, non come demone root.

Quali architetture e distribuzioni sono supportate?

Linux x86_64 e arm64. La CLI è un singolo binario Go che configura il core mihomo per te, quindi dovrebbe funzionare su qualsiasi distribuzione moderna con un kernel recente; testiamo principalmente su Ubuntu e Debian.

La CLI Linux usa gli stessi protocolli delle app desktop?

Sì. anytls, hysteria2 e trojan funzionano tutti nella CLI, sullo stesso core mihomo utilizzato dalle app Windows e Mac.

Come disinstallo la CLI?

Se hai utilizzato lo script di installazione, rimuovi il binario freeguard da /usr/local/bin (o ~/.local/bin) ed elimina ~/.freeguard. Con Homebrew, esegui brew uninstall freeguardvpn. Se hai abilitato l’avvio automatico, esegui prima freeguard autostart disable.