Reference příkazů FreeGuard CLI

FreeGuard CLI poskytuje kompletní sadu příkazů pro správu vašeho VPN připojení, předplatného a konfigurace z terminálu. Každý příkaz podporuje výstup --json pro skriptování a integraci AI agentů.

Globální přepínače

Tyto přepínače fungují s libovolným příkazem:

Přepínač	Popis
`--json`	Výstup ve formátu JSON (vhodné pro agenty)
`--quiet`, `-q`	Tichý režim, vypisuje pouze výsledky
`--verbose`, `-v`	Podrobný výstup s ladicími informacemi
`--no-color`	Zakáže barevný výstup
`--lang <code>`	Jazyk rozhraní (`auto`, `en`, `zh`, `ja`, atd.)
`--config <path>`	Použije konkrétní konfigurační soubor

Připojení

`freeguard connect`

Připojí k VPN serveru. Bez argumentů automaticky vybere nejrychlejší dostupný uzel.

# Automatické připojení k nejlepšímu serveru
freeguard connect

# Připojení ke კონკრეტnímu uzlu podle ID
freeguard connect us-new-01

# Připojení k nejlepšímu serveru v dané zemi
freeguard connect --country JP

# Použití konkrétního protokolu
freeguard connect --protocol anytls

# Povolit režim TUN (vyžaduje sudo/admin)
freeguard connect --tun

Výstup čitelný pro člověka:

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

Výstup JSON:

freeguard connect --json

{"status": "connected", "node": "us-new-01", "protocol": "anytls", "latency_ms": 42}

Přepínače:

Přepínač	Popis
`--country <code>`	Připojí k nejlepšímu uzlu v této zemi (ISO 3166-1 alpha-2)
`--protocol <name>`	Upřednostňovaný protokol (`anytls`, `hysteria2`, `vless`, atd.)
`--tun`	Použije režim TUN pro VPN v celém systému (vyžaduje zvýšená oprávnění)

`freeguard disconnect`

Odpojí od aktuálního VPN serveru.

freeguard disconnect

✓ Odpojeno

freeguard disconnect --json

{"status": "disconnected"}

`freeguard status`

Zobrazí aktuální stav připojení a statistiky provozu.

freeguard status

Stav FreeGuard VPN
────────────────────
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)

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

Autentizace

`freeguard login`

Ověří uživatele ve FreeGuard. Podporuje ověření e-mailem (není potřeba účet) nebo přihlášení k účtu FreeGuard.

Přihlášení e-mailem (doporučeno):

# Krok 1: Vyžádání ověřovacího kódu
freeguard login --email [email protected] --send-code

# Krok 2: Zadání kódu
freeguard login --email [email protected] --code 123456

✓ Úspěšně přihlášeno!
✓ Nalezena 1 aktivní subscription (Pro Plan, vyprší 2026-12-01)

Přihlášení k účtu (otevře prohlížeč):

freeguard login --account

Přepínače:

Přepínač	Popis
`--email <address>`	Přihlášení pomocí ověření e-mailem
`--send-code`	Odeslat ověřovací kód na e-mail
`--code <digits>`	Odeslat 6místný ověřovací kód
`--account`	Přihlášení k účtu FreeGuard přes OAuth v prohlížeči

`freeguard logout`

Vymaže uložené přihlašovací údaje a odpojí, pokud jste aktuálně připojeni.

freeguard logout

✓ Odhlášeno. Přihlašovací údaje vymazány.

Předplatné

`freeguard subscribe list`

Zobrazí dostupné plány předplatného a stav vašeho aktuálního předplatného.

freeguard subscribe list

Vaše subscription
─────────────────
Plan:       Pro
Status:     Active
Expires:    2026-12-01
Traffic:    450 GB / Unlimited

Dostupné plány
───────────────
Plan        Monthly   Quarterly   Annual
Basic       $4.99     $12.99      $39.99
Pro         $9.99     $24.99      $79.99

freeguard subscribe list --json

{
  "current": {"plan": "pro", "status": "active", "expires": "2026-12-01"},
  "plans": [
    {"name": "basic", "prices": {"monthly": 4.99, "quarterly": 12.99, "annual": 39.99}},
    {"name": "pro", "prices": {"monthly": 9.99, "quarterly": 24.99, "annual": 79.99}}
  ]
}

`freeguard subscribe create`

Vytvoří nové předplatné. Otevře váš prohlížeč pro dokončení platby přes Stripe nebo kryptoměnu.

# Interaktivní výběr plánu
freeguard subscribe create

# Přímé zadání plánu
freeguard subscribe create --plan pro --email [email protected]

Přepínače:

Přepínač	Popis
`--plan <name>`	Plán subscription (`basic`, `pro`)
`--email <address>`	E-mail pro doručení subscription

Konfigurace

`freeguard config get`

Přečte hodnotu konfigurace.

freeguard config get proxy.port

freeguard config get proxy.port --json

{"key": "proxy.port", "value": 7890}

`freeguard config set`

Změní hodnotu konfigurace.

freeguard config set proxy.port 8080

✓ proxy.port nastaveno na 8080

Běžné klíče konfigurace:

Klíč	Výchozí hodnota	Popis
`proxy.port`	`7890`	Port proxy HTTP/SOCKS5
`proxy.mode`	`rule`	Režim Proxy: `rule`, `global`, `direct`
`core.api_port`	`9090`	Port Mihomo API
`core.pinned_version`	(prázdné)	Uzamkne mihomo na konkrétní verzi
`dns.provider`	`auto`	Poskytovatel DNS
`update.auto_check`	`true`	Kontrolovat aktualizace při spuštění

`freeguard config edit`

Otevře konfigurační soubor ve výchozím editoru.

freeguard config edit

Diagnostika

`freeguard doctor`

Spustí komplexní kontrolu prostředí pro diagnostiku problémů.

freeguard doctor

Kontrola prostředí FreeGuard
───────────────────────────
✓ OS:              macOS 15.2 (arm64)
✓ CLI version:     v1.0.0
✓ Core version:    mihomo v1.19.21
✓ Config dir:      ~/.freeguard/
✓ Credentials:     Přihlášeno (e-mail: u***@example.com)
✓ Subscription:    Active (vyprší 2026-12-01)
✓ Network:         Internet dostupný
✓ DNS:             Funguje (8.8.8.8)
✗ TUN permission:  Není k dispozici (pro TUN mode spusťte se sudo)
✓ Port 7890:       Dostupný
✓ GeoIP database:  Aktuální (2026-03-15)

Výsledek: 10/11 kontrol prošlo. TUN mode vyžaduje zvýšená oprávnění.

freeguard doctor --json

{
  "checks": [
    {"name": "os", "status": "pass", "detail": "macOS 15.2 (arm64)"},
    {"name": "cli_version", "status": "pass", "detail": "v1.0.0"},
    {"name": "tun_permission", "status": "fail", "detail": "Not available (run with sudo)"}
  ],
  "passed": 10,
  "total": 11
}

`freeguard version`

Zobrazí informace o verzi CLI a hlavního enginu.

freeguard version

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

freeguard version --json

{"cli": "1.0.0", "core": "1.19.21", "os": "darwin", "arch": "arm64"}

Pokročilé (Phase 2+)

Následující příkazy jsou plánovány pro budoucí verze.

`freeguard node list`

Vypíše dostupné VPN uzly s filtrováním a řazením.

freeguard node list
freeguard node list --country US --sort latency

Přepínače:

Přepínač	Popis
`--country <code>`	Filtrovat podle kódu země
`--protocol <name>`	Filtrovat podle protokolu
`--sort <field>`	Řadit podle `speed`, `latency` nebo `load`

`freeguard node test`

Otestuje latenci a rychlost uzlů.

freeguard node test us-new-01
freeguard node test --all

`freeguard monitor`

Zobrazí monitorování provozu v reálném čase ve vašem terminálu.

freeguard monitor

↑ 0.8 MB/s  ↓ 12.3 MB/s  Connections: 47

`freeguard core`

Spravujte základní engine mihomo.

# Check core status
freeguard core status

# Update to latest core version
freeguard core update

# Restart the core engine
freeguard core restart

`freeguard shell`

Vstupte do interaktivního režimu REPL pro spuštění více příkazů v jedné relaci.

freeguard shell

`freeguard dashboard`

Otevřete TUI dashboard s grafy provozu v reálném čase, seznamem uzlů a podrobnostmi o připojení.

freeguard dashboard

Last updated: March 2026