FreeGuard CLI Rýchly štart

FreeGuard CLI je VPN klient pre príkazový riadok, ktorý sa pripojí jediným príkazom. Nainštalujte ho na macOS, Linux alebo Windows, prihláste sa pomocou svojho e-mailu a spustite freeguard connect, aby ste si zabezpečili internet za menej než 5 minút.

Inštalácia

macOS a Linux

Nainštalujte jedným príkazom:

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

Alebo na macOS použite Homebrew:

brew install freeguardvpn/tap/freeguard

Po inštalácii overte, že všetko prebehlo správne:

freeguard version

Očakávaný výstup:

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

Windows

Otvorte PowerShell ako správca a spustite:

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

Po inštalácii reštartujte terminál a spustením freeguard version potvrďte úspešnú inštaláciu.

Prihlásenie

FreeGuard CLI používa overenie prostredníctvom e-mailu — registrácia účtu nie je potrebná.

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

Na váš e-mail dostanete 6-miestny overovací kód. Zadajte ho:

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

Príklad výstupu:

✓ Úspešne prihlásený!
✓ Nájdené 1 aktívne predplatné (Pro Plan, expires 2026-12-01)
✓ Konfigurácia vygenerovaná: ~/.freeguard/profiles/default.yaml

Ak máte účet FreeGuard, môžete sa prihlásiť aj cez prehliadač:

freeguard login --account

Tým sa otvorí váš prehliadač na overenie OAuth a automaticky sa vráti token.

Pripojenie

Pripojte sa k najrýchlejšiemu dostupnému serveru jediným príkazom:

freeguard connect

Príklad výstupu:

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

Ak sa chcete pripojiť ku konkrétnej krajine:

freeguard connect --country JP

Ak sa chcete pripojiť ku konkrétnemu uzlu:

freeguard connect jp-tok-01

Overenie

Skontrolujte, či je vaše pripojenie aktívne:

freeguard status

Príklad výstupu:

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)

Ak chcete získať výstup čitateľný pre stroj (užitočné pri skriptovaní alebo pre AI agentov):

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

Ďalšie kroky

• CLI Commands Reference — Úplný zoznam všetkých príkazov, prepínačov a formátov výstupu.
• CLI Troubleshooting — Riešenia bežných problémov s inštaláciou, prihlásením a pripojením.
• FreeGuard CLI Agent — Nechajte AI, aby vám problémy automaticky diagnostikovala a opravila.
• Spustite freeguard --help a preskúmajte všetky dostupné príkazy vo svojom termináli.

Často kladené otázky

Ako nainštalujem FreeGuard CLI na svojom systéme?

Na macOS alebo Linux spustite curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh. Na macOS môžete použiť aj brew install freeguard. Inštalačný program automaticky rozpozná váš OS a architektúru.

Môžem používať FreeGuard CLI bez GUI?

Áno. FreeGuard CLI je plne bez grafického rozhrania — beží výhradne v termináli a nevyžaduje žiadne grafické rozhranie. Vďaka tomu je ideálny pre servery, kontajnery a vzdialené SSH relácie.

Ako prepnem VPN protokoly pomocou CLI?

Použite freeguard connect --protocol <name>. Medzi podporované protokoly patria Hysteria2, Anytls a Trojan. CLI štandardne používa najrýchlejší dostupný protokol pre vašu sieť.

Funguje FreeGuard CLI aj na ARM zariadeniach ako Raspberry Pi?

Áno. CLI podporuje architektúry arm64 a armv7. Inštalačný skript automaticky rozpozná vašu platformu a stiahne správny binárny súbor.

Posledná aktualizácia: marec 2026