FreeGuard CLI Rychlý start

FreeGuard CLI je VPN klient z příkazové řádky, který se připojí jediným příkazem. Nainstalujte jej na macOS, Linux nebo Windows, přihlaste se pomocí svého e-mailu a spusťte freeguard connect, abyste si zabezpečili internet za méně než 5 minut.

Instalace

macOS a Linux

Nainstalujte jedním příkazem:

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

Nebo na macOS použijte Homebrew:

brew install freeguardvpn/tap/freeguard

Po instalaci ověřte, že vše funguje:

freeguard version

Očekávaný výstup:

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

Windows

Otevřete PowerShell jako Správce a spusťte:

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

Po instalaci restartujte terminál a spusťte freeguard version pro potvrzení.

Přihlášení

FreeGuard CLI používá ověření pomocí e-mailu — není nutná žádná registrace účtu.

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

Na svůj e-mail obdržíte 6místný ověřovací kód. Zadejte jej:

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

Ukázkový výstup:

✓ Úspěšně přihlášeno!
✓ Nalezena 1 aktivní předplatná (Pro Plan, platnost do 2026-12-01)
✓ Vygenerována konfigurace: ~/.freeguard/profiles/default.yaml

Pokud máte účet FreeGuard, můžete se také přihlásit přes prohlížeč:

freeguard login --account

Tím se otevře váš prohlížeč pro OAuth ověření a token se vrátí automaticky.

Připojení

Připojte se k nejrychlejšímu dostupnému serveru jediným příkazem:

freeguard connect

Ukázkový výstup:

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

Pro připojení ke konkrétní zemi:

freeguard connect --country JP

Pro připojení ke konkrétnímu uzlu:

freeguard connect jp-tok-01

Ověření

Zkontrolujte, že je vaše připojení aktivní:

freeguard status

Ukázkový výstup:

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)

Pro strojově čitelný výstup (užitečné pro skriptování nebo AI agenty):

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

Další kroky

Reference příkazů CLI — Úplný seznam všech příkazů, přepínačů a formátů výstupu.
Řešení potíží s CLI — Řešení běžných problémů s instalací, přihlášením a připojením.
Agent FreeGuard CLI — Nechte AI, aby vám problémy automaticky diagnostikovala a opravila.
Spusťte freeguard --help a prozkoumejte všechny dostupné příkazy v terminálu.

Často kladené otázky

Jak nainstaluji FreeGuard CLI do svého systému?

Spusťte curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh na macOS nebo Linuxu. Na macOS můžete také použít brew install freeguard. Instalační program automaticky rozpozná vaše OS a architekturu.

Mohu používat FreeGuard CLI bez GUI?

Ano. FreeGuard CLI je plně headless — běží výhradně v terminálu a nevyžaduje žádné grafické rozhraní. Díky tomu je ideální pro servery, kontejnery a vzdálené relace SSH.

Jak přepnu VPN protokoly pomocí CLI?

Použijte freeguard connect --protocol <name>. Podporované protokoly zahrnují Hysteria2, Anytls a Trojan. CLI ve výchozím nastavení používá nejrychlejší dostupný protokol pro vaši síť.

Funguje FreeGuard CLI na ARM zařízeních, jako je Raspberry Pi?

Ano. CLI podporuje architektury arm64 a armv7. Instalační skript automaticky rozpozná vaši platformu a stáhne správný binární soubor.

Poslední aktualizace: březen 2026