FreeGuard CLI Ghid rapid de început

FreeGuard CLI este un client VPN din linia de comandă care se conectează cu o singură comandă. Instalează-l pe macOS, Linux sau Windows, autentifică-te cu emailul tău și rulează freeguard connect pentru a-ți securiza internetul în mai puțin de 5 minute.

Instalare

macOS și Linux

Instalează cu o singură comandă:

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

Sau folosește Homebrew pe macOS:

brew install freeguardvpn/tap/freeguard

După instalare, verifică dacă a funcționat:

freeguard version

Ieșire așteptată:

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

Windows

Deschide PowerShell ca Administrator și rulează:

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

După instalare, repornește terminalul și rulează freeguard version pentru confirmare.

Autentificare

FreeGuard CLI folosește verificarea pe bază de email — nu este necesară înregistrarea unui cont.

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

Vei primi un cod de verificare din 6 cifre pe email. Introdu-l:

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

Exemplu de ieșire:

✓ Autentificat cu succes!
✓ Găsit 1 abonament activ (Pro Plan, expiră 2026-12-01)
✓ Configurație generată: ~/.freeguard/profiles/default.yaml

Dacă ai un cont FreeGuard, te poți autentifica și prin browser:

freeguard login --account

Aceasta îți deschide browserul pentru autentificare OAuth și returnează automat un token.

Conectare

Conectează-te la cel mai rapid server disponibil cu o singură comandă:

freeguard connect

Exemplu de ieșire:

✓ Conectat la United States - New York (us-new-01)
  Protocol: anytls | Latență: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

Pentru a te conecta la o anumită țară:

freeguard connect --country JP

Pentru a te conecta la un anumit nod:

freeguard connect jp-tok-01

Verificare

Verifică dacă conexiunea ta este activă:

freeguard status

Exemplu de ieșire:

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)

Pentru a obține ieșire ușor de citit de mașină (utilă pentru scripting sau agenți 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}
}

Pașii următori

• CLI Commands Reference — Lista completă a tuturor comenzilor, flagurilor și formatelor de ieșire.
• CLI Troubleshooting — Soluții pentru problemele comune de instalare, autentificare și conectare.
• FreeGuard CLI Agent — Lasă AI să diagnosticheze și să rezolve automat problemele pentru tine.
• Rulează freeguard --help pentru a explora toate comenzile disponibile din terminalul tău.

Întrebări frecvente

Cum instalez FreeGuard CLI pe sistemul meu?

Rulează curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh pe macOS sau Linux. Pe macOS, poți folosi și brew install freeguard. Installerul detectează automat OS-ul și arhitectura.

Pot folosi FreeGuard CLI fără GUI?

Da. FreeGuard CLI este complet headless — rulează integral în terminal, fără a necesita o interfață grafică. Acest lucru îl face ideal pentru servere, containere și sesiuni SSH la distanță.

Cum schimb protocoalele VPN cu CLI?

Folosește freeguard connect --protocol <name>. Protocoalele acceptate includ Hysteria2, Anytls și Trojan. CLI-ul folosește implicit cel mai rapid protocol disponibil pentru rețeaua ta.

FreeGuard CLI funcționează pe dispozitive ARM precum Raspberry Pi?

Da. CLI-ul acceptă arhitecturile arm64 și armv7. Scriptul de instalare detectează automat platforma ta și descarcă binarul corect.

Ultima actualizare: martie 2026