FreeGuard CLI Guida rapida

FreeGuard CLI è un client VPN da riga di comando che si connette con un solo comando. Installalo su macOS, Linux o Windows, accedi con la tua email ed esegui freeguard connect per proteggere la tua connessione Internet in meno di 5 minuti.

Installazione

macOS e Linux

Installa con un singolo comando:

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

Oppure usa Homebrew su macOS:

brew install freeguardvpn/tap/freeguard

Dopo l’installazione, verifica che abbia funzionato:

freeguard version

Output previsto:

FreeGuard CLI v1.0.0
Core: mihomo v1.19.21
OS: darwin/arm64

Windows

Apri PowerShell come Amministratore ed esegui:

irm https://downloadcli.freeguardvpn.com/cli/install.ps1 | iex

Dopo l’installazione, riavvia il terminale ed esegui freeguard version per confermare.

Accesso

FreeGuard CLI utilizza la verifica basata su email — non è richiesta alcuna registrazione dell’account.

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

Riceverai un codice di verifica a 6 cifre nella tua email. Inseriscilo:

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

Esempio di output:

✓ Accesso effettuato con successo!
✓ Trovato 1 abbonamento attivo (Pro Plan, scade il 2026-12-01)
✓ Configurazione generata: ~/.freeguard/profiles/default.yaml

Se hai un account FreeGuard, puoi anche accedere tramite browser:

freeguard login --account

Questo apre il browser per l’autenticazione OAuth e restituisce automaticamente un token.

Connessione

Connettiti al server più veloce disponibile con un solo comando:

freeguard connect

Esempio di output:

✓ Connesso a United States - New York (us-new-01)
  Protocol: anytls | Latency: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

Per connetterti a un paese specifico:

freeguard connect --country JP

Per connetterti a un nodo specifico:

freeguard connect jp-tok-01

Verifica

Controlla che la connessione sia attiva:

freeguard status

Esempio di output:

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)

Per ottenere un output leggibile dalla macchina (utile per script o agenti AI):

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}
}

Passi successivi

Riferimento comandi CLI — Elenco completo di tutti i comandi, flag e formati di output.
Risoluzione problemi CLI — Soluzioni per i problemi comuni di installazione, accesso e connessione.
FreeGuard CLI Agent — Lascia che l’AI diagnostichi e risolva automaticamente i problemi per te.
Esegui freeguard --help per esplorare tutti i comandi disponibili dal tuo terminale.

Domande frequenti

Come installo FreeGuard CLI sul mio sistema?

Esegui curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh su macOS o Linux. Su macOS, puoi anche usare brew install freeguard. L’installer rileva automaticamente il tuo OS e la tua architettura.

Posso usare FreeGuard CLI senza una GUI?

Sì. FreeGuard CLI è completamente headless — funziona interamente nel terminale senza alcuna interfaccia grafica richiesta. Questo lo rende ideale per server, container e sessioni SSH remote.

Come cambio i protocolli VPN con la CLI?

Usa freeguard connect --protocol <name>. I protocolli supportati includono Hysteria2, Anytls e Trojan. La CLI usa come predefinito il protocollo più veloce disponibile per la tua rete.

FreeGuard CLI funziona su dispositivi ARM come Raspberry Pi?

Sì. La CLI supporta le architetture arm64 e armv7. Lo script di installazione rileva automaticamente la tua piattaforma e scarica il binario corretto.

Ultimo aggiornamento: marzo 2026