FreeGuard CLI komandų nuoroda

FreeGuard CLI suteikia pilną komandų rinkinį, skirtą valdyti jūsų VPN ryšį, prenumeratą ir konfigūraciją iš terminalo. Kiekviena komanda palaiko --json išvestį skriptavimui ir AI agentų integracijai.

Globalūs vėliavėlės parametrai

Šie parametrai veikia su bet kuria komanda:

Vėliavėlė	Aprašymas
`--json`	Išvestis JSON formatu (patogu agentams)
`--quiet`, `-q`	Tylus režimas, išveda tik rezultatus
`--verbose`, `-v`	Išsami išvestis su derinimo informacija
`--no-color`	Išjungti spalvotą išvestį
`--lang <code>`	Sąsajos kalba (`auto`, `en`, `zh`, `ja`, ir t. t.)
`--config <path>`	Naudoti konkretų konfigūracijos failą

Prisijungimas

`freeguard connect`

Prisijungia prie VPN serverio. Be argumentų automatiškai pasirenka greičiausią prieinamą mazgą.

# Automatiškai prisijungti prie geriausio serverio
freeguard connect

# Prisijungti prie konkretaus mazgo pagal ID
freeguard connect us-new-01

# Prisijungti prie geriausio serverio šalyje
freeguard connect --country JP

# Naudoti konkretų protokolą
freeguard connect --protocol anytls

# Įjungti TUN Mode (reikia sudo/admin)
freeguard connect --tun

Žmogui suprantama išvestis:

✓ Prisijungta prie United States - New York (us-new-01)
  Protokolas: anytls | Užlaikymas: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

JSON išvestis:

freeguard connect --json

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

Parametrai:

Vėliavėlė	Aprašymas
`--country <code>`	Prisijungti prie geriausio mazgo šioje šalyje (ISO 3166-1 alpha-2)
`--protocol <name>`	Pageidaujamas protokolas (`anytls`, `hysteria2`, `vless`, ir t. t.)
`--tun`	Naudoti TUN Mode visos sistemos VPN ryšiui (reikia padidintų privilegijų)

`freeguard disconnect`

Atsijungia nuo dabartinio VPN serverio.

freeguard disconnect

✓ Atsijungta

freeguard disconnect --json

{"status": "disconnected"}

`freeguard status`

Parodo dabartinę ryšio būseną ir srauto statistiką.

freeguard status

FreeGuard VPN būsena
────────────────────
Būsena:     ● Prisijungta
Mazgas:     United States - New York (us-new-01)
Protokolas: anytls
Užlaikymas: 42ms
Siuntimas:  1.2 MB/s
Atsisiuntimas: 15.8 MB/s
Trukmė:     2h 15m
Režimas:    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}
}

Autentifikacija

`freeguard login`

Autentifikuojasi su FreeGuard. Palaiko el. pašto patvirtinimą (nereikia paskyros) arba prisijungimą prie FreeGuard paskyros.

Prisijungimas el. paštu (rekomenduojama):

# 1 žingsnis: užklausti patvirtinimo kodą
freeguard login --email [email protected] --send-code

# 2 žingsnis: įvesti kodą
freeguard login --email [email protected] --code 123456

✓ Sėkmingai prisijungta!
✓ Rasta 1 aktyvi prenumerata (Pro Plan, baigiasi 2026-12-01)

Prisijungimas prie paskyros (atidaro naršyklę):

freeguard login --account

Parametrai:

Vėliavėlė	Aprašymas
`--email <address>`	Prisijungti naudojant el. pašto patvirtinimą
`--send-code`	Nusiųsti patvirtinimo kodą į el. paštą
`--code <digits>`	Pateikti 6 skaitmenų patvirtinimo kodą
`--account`	Prisijungti prie FreeGuard paskyros per naršyklės OAuth

`freeguard logout`

Išvalo saugomus prisijungimo duomenis ir atsijungia, jei šiuo metu prisijungta.

freeguard logout

✓ Atsijungta. Prisijungimo duomenys išvalyti.

Prenumerata

`freeguard subscribe list`

Peržiūrėti galimus prenumeratos planus ir dabartinės prenumeratos būseną.

freeguard subscribe list

Jūsų prenumerata
─────────────────
Planas:     Pro
Būsena:     Aktyvi
Baigiasi:   2026-12-01
Srautas:    450 GB / Unlimited

Galimi planai
───────────────
Planas      Mėnesinis   Kas ketvirtį   Metinis
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`

Sukurti naują prenumeratą. Atidaro jūsų naršyklę, kad užbaigtumėte mokėjimą per Stripe arba kriptovaliutą.

# Interaktyvus plano pasirinkimas
freeguard subscribe create

# Nurodyti planą tiesiogiai
freeguard subscribe create --plan pro --email [email protected]

Parametrai:

Vėliavėlė	Aprašymas
`--plan <name>`	Prenumeratos planas (`basic`, `pro`)
`--email <address>`	El. paštas prenumeratos pristatymui

Konfigūracija

`freeguard config get`

Nuskaito konfigūracijos reikšmę.

freeguard config get proxy.port

freeguard config get proxy.port --json

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

`freeguard config set`

Pakeičia konfigūracijos reikšmę.

freeguard config set proxy.port 8080

✓ proxy.port nustatytas į 8080

Dažni konfigūracijos raktai:

Raktas	Numatytasis	Aprašymas
`proxy.port`	`7890`	HTTP/SOCKS5 proxy prievadas
`proxy.mode`	`rule`	Proxy režimas: `rule`, `global`, `direct`
`core.api_port`	`9090`	Mihomo API prievadas
`core.pinned_version`	(tuščia)	Pririšti mihomo prie konkrečios versijos
`dns.provider`	`auto`	DNS tiekėjas
`update.auto_check`	`true`	Tikrinti atnaujinimus paleidimo metu

`freeguard config edit`

Atidaro konfigūracijos failą numatytojoje redagavimo programoje.

freeguard config edit

Diagnostika

`freeguard doctor`

Atlieka išsamų aplinkos patikrinimą, kad būtų galima diagnozuoti problemas.

freeguard doctor

FreeGuard aplinkos patikra
───────────────────────────
✓ OS:              macOS 15.2 (arm64)
✓ CLI version:     v1.0.0
✓ Core version:    mihomo v1.19.21
✓ Config dir:      ~/.freeguard/
✓ Credentials:     Prisijungta (el. paštas: u***@example.com)
✓ Subscription:    Aktyvi (baigiasi 2026-12-01)
✓ Network:         Internet pasiekiamas
✓ DNS:             Veikia (8.8.8.8)
✗ TUN permission:  Nepasiekiama (naudokite sudo TUN Mode režimui)
✓ Port 7890:       Prieinamas
✓ GeoIP database:  Atnaujinta (2026-03-15)

Rezultatas: 10/11 patikrinimų praėjo. TUN Mode reikalauja padidintų privilegijų.

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`

Parodo CLI ir pagrindinio variklio versijos informaciją.

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

Išplėstiniai (Phase 2+)

Toliau pateiktos komandos yra suplanuotos būsimoms versijoms.

`freeguard node list`

Išvardija galimus VPN mazgus su filtravimu ir rūšiavimu.

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

Parametrai:

Vėliavėlė	Aprašymas
`--country <code>`	Filtruoti pagal šalies kodą
`--protocol <name>`	Filtruoti pagal protokolą
`--sort <field>`	Rūšiuoti pagal `speed`, `latency` arba `load`

`freeguard node test`

Tikrina mazgų užlaikymą ir greitį.

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

`freeguard monitor`

Terminale rodo realaus laiko srauto stebėjimą.

freeguard monitor

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

`freeguard core`

Valdykite pagrindinį mihomo variklį.

# Check core status
freeguard core status

# Update to latest core version
freeguard core update

# Restart the core engine
freeguard core restart

`freeguard shell`

Įeikite į interaktyvų REPL režimą, kad vienoje sesijoje galėtumėte vykdyti kelias komandas.

freeguard shell

`freeguard dashboard`

Atidarykite TUI informacinį skydelį su realaus laiko srauto grafikais, mazgų sąrašu ir ryšio informacija.

freeguard dashboard

Naujausias atnaujinimas: 2026 m. kovo mėn.