FreeGuard CLI Бърз старт

FreeGuard CLI е VPN клиент от командния ред, който се свързва с една команда. Инсталирайте го на macOS, Linux или Windows, влезте с вашия имейл и изпълнете freeguard connect, за да защитите интернет връзката си за по-малко от 5 минути.

Инсталация

macOS и Linux

Инсталирайте с една команда:

curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh

Или използвайте Homebrew на macOS:

brew install freeguardvpn/tap/freeguard

След инсталацията проверете дали е работило:

freeguard version

Очакван изход:

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

Windows

Отворете PowerShell като администратор и изпълнете:

irm https://downloadcli.freeguardvpn.com/cli/install.ps1 | iex

След инсталацията рестартирайте терминала си и изпълнете freeguard version, за да потвърдите.

Вход

FreeGuard CLI използва проверка чрез имейл — не е необходима регистрация на акаунт.

freeguard login --email [email protected] --send-code

Ще получите 6-цифрен код за потвърждение на вашия имейл. Въведете го:

freeguard login --email [email protected] --code 123456

Примерен изход:

✓ Logged in successfully!
✓ Found 1 active subscription (Pro Plan, expires 2026-12-01)
✓ Configuration generated: ~/.freeguard/profiles/default.yaml

Ако имате FreeGuard акаунт, можете също да влезете през браузър:

freeguard login --account

Това отваря вашия браузър за OAuth удостоверяване и автоматично връща token.

Свързване

Свържете се с най-бързия наличен сървър с една команда:

freeguard connect

Примерен изход:

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

За да се свържете с определена държава:

freeguard connect --country JP

За да се свържете с определен node:

freeguard connect jp-tok-01

Проверка

Проверете дали връзката ви е активна:

freeguard status

Примерен изход:

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)

За да получите изход в машинно четим формат (полезно за скриптове или 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}
}

Следващи стъпки

• CLI Commands Reference — Пълен списък на всички команди, флагове и формати на изход.
• CLI Troubleshooting — Решения за често срещани проблеми с инсталацията, входа и връзката.
• FreeGuard CLI Agent — Позволете на AI автоматично да диагностицира и отстранява проблеми вместо вас.
• Изпълнете freeguard --help, за да разгледате всички налични команди от вашия терминал.

Често задавани въпроси

Как да инсталирам FreeGuard CLI на моята система?

Изпълнете curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh на macOS или Linux. На macOS можете също да използвате brew install freeguard. Инсталаторът автоматично разпознава вашата OS и архитектура.

Мога ли да използвам FreeGuard CLI без GUI?

Да. FreeGuard CLI е напълно headless — работи изцяло в терминала, без да е необходим графичен интерфейс. Това го прави идеален за сървъри, контейнери и отдалечени SSH сесии.

Как да сменям VPN протоколи с CLI?

Използвайте freeguard connect --protocol <name>. Поддържаните протоколи включват Hysteria2, Anytls и Trojan. По подразбиране CLI използва най-бързия наличен протокол за вашата мрежа.

Работи ли FreeGuard CLI на ARM устройства като Raspberry Pi?

Да. CLI поддържа arm64 и armv7 архитектури. Скриптът за инсталация автоматично разпознава вашата платформа и изтегля правилния binary.

Последна актуализация: March 2026