FreeGuard CLI Быстрый старт

FreeGuard CLI — это VPN-клиент для командной строки, который подключается одной командой. Установите его на macOS, Linux или Windows, войдите, используя свой email, и запустите 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 использует проверку по email — регистрация аккаунта не требуется.

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

Вы получите 6-значный код подтверждения на свой email. Введите его:

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)
  Протокол: anytls | Задержка: 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-агентов):

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 полностью работает без интерфейса — он запускается целиком в терминале и не требует графического интерфейса. Это делает его идеальным для серверов, контейнеров и удалённых SSH-сеансов.

Как переключать VPN-протоколы через CLI?

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

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

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

Последнее обновление: March 2026