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

Приклад виводу:

✓ Успішно виконано вхід!
✓ Знайдено 1 активну підписку (Pro Plan, закінчується 2026-12-01)
✓ Конфігурацію згенеровано: ~/.freeguard/profiles/default.yaml

Якщо у вас є обліковий запис FreeGuard, ви також можете увійти через браузер:

freeguard login --account

Це відкриє ваш браузер для автентифікації OAuth і автоматично поверне токен.

Підключення

Підключіться до найшвидшого доступного сервера однією командою:

freeguard connect

Приклад виводу:

✓ Підключено до United States - New York (us-new-01)
  Protocol: anytls | Latency: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

Щоб підключитися до певної країни:

freeguard connect --country JP

Щоб підключитися до певного вузла:

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 agents):

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. Встановлювач автоматично визначає вашу ОС і архітектуру.

Чи можу я використовувати 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. Сценарій встановлення автоматично визначає вашу платформу та завантажує правильний бінарний файл.

Оновлено: березень 2026