FreeGuard CLI Reference Komandi

FreeGuard CLI pruža kompletan skup komandi za upravljanje vašom VPN vezom, pretplatom i konfiguracijom iz terminala. Svaka komanda podržava --json izlaz za skriptiranje i integraciju AI agenata.

Globalne zastavice

Ove zastavice rade sa bilo kojom komandom:

Zastavica	Opis
`--json`	Izlaz u JSON formatu (pogodno za agente)
`--quiet`, `-q`	Tihi režim, prikazuje samo rezultate
`--verbose`, `-v`	Detaljan izlaz sa informacijama za otklanjanje grešaka
`--no-color`	Isključuje obojeni izlaz
`--lang <code>`	Jezik interfejsa (`auto`, `en`, `zh`, `ja`, itd.)
`--config <path>`	Koristi određenu konfiguracionu datoteku

Povezivanje

`freeguard connect`

Povezuje se na VPN server. Bez argumenata, automatski bira najbrži dostupni čvor.

# Automatsko povezivanje na najbolji server
freeguard connect

# Povezivanje na određeni čvor po ID-ju
freeguard connect us-new-01

# Povezivanje na najbolji server u nekoj zemlji
freeguard connect --country JP

# Korišćenje određenog protokola
freeguard connect --protocol anytls

# Omogućavanje TUN Mode (zahteva sudo/admin)
freeguard connect --tun

Izlaz čitljiv za čoveka:

✓ Povezano na United States - New York (us-new-01)
  Protokol: anytls | Kašnjenje: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

JSON izlaz:

freeguard connect --json

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

Zastavice:

Zastavica	Opis
`--country <code>`	Povezuje se na najbolji čvor u ovoj zemlji (ISO 3166-1 alpha-2)
`--protocol <name>`	Preferirani protokol (`anytls`, `hysteria2`, `vless`, itd.)
`--tun`	Koristi TUN mode za VPN na nivou sistema (zahteva povišene privilegije)

`freeguard disconnect`

Prekida vezu sa trenutnim VPN serverom.

freeguard disconnect

✓ Veza prekinuta

freeguard disconnect --json

{"status": "disconnected"}

`freeguard status`

Prikazuje trenutni status veze i statistiku saobraćaja.

freeguard status

FreeGuard VPN Status
────────────────────
Status:     ● Povezano
Čvor:       United States - New York (us-new-01)
Protokol:   anytls
Kašnjenje:  42ms
Slanje:     1.2 MB/s
Preuzimanje: 15.8 MB/s
Trajanje:   2h 15m
Režim:      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`

Autentifikacija sa FreeGuard. Podržava verifikaciju putem emaila (nije potreban nalog) ili prijavu na FreeGuard nalog.

Prijava putem emaila (preporučeno):

# Korak 1: Zatražite verifikacioni kod
freeguard login --email [email protected] --send-code

# Korak 2: Unesite kod
freeguard login --email [email protected] --code 123456

✓ Uspešno prijavljeni!
✓ Pronađena 1 aktivna pretplata (Pro Plan, ističe 2026-12-01)

Prijava na nalog (otvara pregledač):

freeguard login --account

Zastavice:

Zastavica	Opis
`--email <address>`	Prijava verifikacijom putem emaila
`--send-code`	Slanje verifikacionog koda na email
`--code <digits>`	Slanje 6-cifrenog verifikacionog koda
`--account`	Prijava na FreeGuard nalog preko browser OAuth

`freeguard logout`

Briše sačuvane akreditive i prekida vezu ako je trenutno uspostavljena.

freeguard logout

✓ Odjavljeni ste. Akreditivi su obrisani.

Pretplata

`freeguard subscribe list`

Prikazuje dostupne planove pretplate i trenutni status pretplate.

freeguard subscribe list

Vaša pretplata
─────────────────
Plan:       Pro
Status:     Active
Ističe:     2026-12-01
Saobraćaj:  450 GB / Unlimited

Dostupni planovi
───────────────
Plan        Mesečno   Tromesečno   Godišnje
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`

Kreira novu pretplatu. Otvara vaš pregledač radi završetka plaćanja putem Stripe-a ili kriptovalute.

# Interaktivni izbor plana
freeguard subscribe create

# Direktno navođenje plana
freeguard subscribe create --plan pro --email [email protected]

Zastavice:

Zastavica	Opis
`--plan <name>`	Plan pretplate (`basic`, `pro`)
`--email <address>`	Email za isporuku pretplate

Konfiguracija

`freeguard config get`

Čita vrednost konfiguracije.

freeguard config get proxy.port

freeguard config get proxy.port --json

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

`freeguard config set`

Menja vrednost konfiguracije.

freeguard config set proxy.port 8080

✓ proxy.port postavljen na 8080

Uobičajeni ključevi konfiguracije:

Ključ	Podrazumevano	Opis
`proxy.port`	`7890`	Port HTTP/SOCKS5 proxy-ja
`proxy.mode`	`rule`	Režim Proxy-ja: `rule`, `global`, `direct`
`core.api_port`	`9090`	Mihomo API port
`core.pinned_version`	(prazno)	Zaključava mihomo na određenu verziju
`dns.provider`	`auto`	DNS provajder
`update.auto_check`	`true`	Provera ažuriranja pri pokretanju

`freeguard config edit`

Otvara konfiguracionu datoteku u podrazumevanom editoru.

freeguard config edit

Dijagnostika

`freeguard doctor`

Pokreće sveobuhvatnu proveru okruženja radi dijagnostikovanja problema.

freeguard doctor

FreeGuard Environment Check
───────────────────────────
✓ OS:              macOS 15.2 (arm64)
✓ CLI version:     v1.0.0
✓ Core version:    mihomo v1.19.21
✓ Config dir:      ~/.freeguard/
✓ Credentials:     Logged in (email: u***@example.com)
✓ Subscription:    Active (expires 2026-12-01)
✓ Network:         Internet reachable
✓ DNS:             Working (8.8.8.8)
✗ TUN permission:  Not available (run with sudo for TUN mode)
✓ Port 7890:       Available
✓ GeoIP database:  Up to date (2026-03-15)

Result: 10/11 checks passed. TUN mode requires elevated privileges.

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`

Prikazuje informacije o verziji za CLI i core engine.

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

Napredno (Phase 2+)

Sledeće komande su planirane za buduća izdanja.

`freeguard node list`

Prikazuje dostupne VPN čvorove sa filtriranjem i sortiranjem.

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

Zastavice:

Zastavica	Opis
`--country <code>`	Filtriranje po kodu zemlje
`--protocol <name>`	Filtriranje po protokolu
`--sort <field>`	Sortiranje po `speed`, `latency`, ili `load`

`freeguard node test`

Testira kašnjenje i brzinu čvorova.

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

`freeguard monitor`

Prikazuje nadzor saobraćaja u realnom vremenu u vašem terminalu.

freeguard monitor

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

`freeguard core`

Upravljajte osnovnim mihomo engine-om.

# Check core status
freeguard core status

# Update to latest core version
freeguard core update

# Restart the core engine
freeguard core restart

`freeguard shell`

Uđite u interaktivni REPL režim za pokretanje više komandi u jednoj sesiji.

freeguard shell

`freeguard dashboard`

Otvorite TUI dashboard sa grafikonima saobraćaja u realnom vremenu, listom čvorova i detaljima veze.

freeguard dashboard

Poslednje ažuriranje: March 2026