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.

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 --help biex 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