FreeGuard CLI Quick Start
FreeGuard CLI hija klijent VPN tal-linea tal-kmand li jikkonnettja b’kmand wieħed. Installa fuq macOS, Linux, jew Windows, idħol bl-email tiegħek, u ħaddem freeguard connect biex tiżgura l-internet tiegħek f’inqas minn 5 minuti.
Installazzjoni
macOS u Linux
Installa b’kmand wieħed:
curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh
Jew uża Homebrew fuq macOS:
brew install freeguardvpn/tap/freeguard
Wara l-installazzjoni, ivverifika li ħadmet:
freeguard version
Output mistenni:
FreeGuard CLI v1.0.0
Core: mihomo v1.19.21
OS: darwin/arm64
Windows
Iftaħ PowerShell bħala Administrator u ħaddem:
irm https://downloadcli.freeguardvpn.com/cli/install.ps1 | iex
Wara l-installazzjoni, erġa’ ibda t-terminal tiegħek u ħaddem freeguard version biex tikkonferma.
Login
FreeGuard CLI juża verifika bbażata fuq email — l-ebda reġistrazzjoni ta’ kont mhi meħtieġa.
freeguard login --email [email protected] --send-code
Int ser tirċievi kodiċi ta’ verifika ta’ 6 ċifri fl-email tiegħek. Daħħlu:
freeguard login --email [email protected] --code 123456
Eżempju ta’ output:
✓ Logged in successfully!
✓ Found 1 active subscription (Pro Plan, expires 2026-12-01)
✓ Configuration generated: ~/.freeguard/profiles/default.yaml
Jekk għandek kont FreeGuard, tista’ wkoll tidħol permezz tal-browser:
freeguard login --account
Dan jiftaħ il-browser tiegħek għall-awtentikazzjoni OAuth u jirritorna token awtomatikament.
Ikkonnettja
Ikkonnettja mal-aktar server veloċi disponibbli b’kmand wieħed:
freeguard connect
Eżempju ta’ output:
✓ Connected to United States - New York (us-new-01)
Protocol: anytls | Latency: 42ms
Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)
Biex tikkonnettja ma’ pajjiż speċifiku:
freeguard connect --country JP
Biex tikkonnettja ma’ node speċifiku:
freeguard connect jp-tok-01
Ivverifika
Iċċekkja li l-konnessjoni tiegħek hija attiva:
freeguard status
Eżempju ta’ output:
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)
Biex tikseb output li jinqara mill-magni (utli għall-iskripting jew għall-aġenti AI):
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}
}
Passi Li Jmiss
- CLI Commands Reference — Lista sħiħa tal-kmandi, flags, u formati ta’ output kollha.
- CLI Troubleshooting — Soluzzjonijiet għal problemi komuni ta’ installazzjoni, login, u konnessjoni.
- FreeGuard CLI Agent — Ħalli l-AI tiddijanjostika u tiffissa l-problemi għalik awtomatikament.
- Ħaddem
freeguard --helpbiex tesplora l-kmandi kollha disponibbli mit-terminal tiegħek.
Mistoqsijiet Frekwenti
Kif ninstalla FreeGuard CLI fuq is-sistema tiegħi?
Ħaddem curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh fuq macOS jew Linux. Fuq macOS, tista’ wkoll tuża brew install freeguard. L-installatur jiddetekta awtomatikament l-OS u l-arkitettura tiegħek.
Nista’ nuża FreeGuard CLI mingħajr GUI?
Iva. FreeGuard CLI huwa kompletament headless — jaħdem kollu fit-terminal mingħajr ebda interface grafiku meħtieġ. Dan jagħmlu ideali għal servers, containers, u sessjonijiet remoti SSH.
Kif nibdel VPN protocols bil-CLI?
Uża freeguard connect --protocol <name>. Il-protocols appoġġjati jinkludu Hysteria2, Anytls, u Trojan. Il-CLI juża awtomatikament l-aktar protocol veloċi disponibbli għan-netwerk tiegħek.
FreeGuard CLI jaħdem fuq apparati ARM bħal Raspberry Pi?
Iva. Il-CLI jappoġġja l-arkitetturi arm64 u armv7. L-iskritt tal-installazzjoni jiddetekta awtomatikament il-pjattaforma tiegħek u jniżżel il-binary korrett.
Aġġornat l-aħħar: March 2026