Справочник команд FreeGuard CLI
FreeGuard CLI предоставляет полный набор команд для управления вашим VPN-подключением, подпиской и конфигурацией из терминала. Каждая команда поддерживает вывод --json для сценариев и интеграции с AI-агентами.
Глобальные флаги
Эти флаги работают с любой командой:
| Флаг | Описание |
|---|---|
--json |
Вывод в формате JSON (удобно для агентів) |
--quiet, -q |
Тихий режим, вывод только результатов |
--verbose, -v |
Подробный вывод с отладочной информацией |
--no-color |
Отключить цветной вывод |
--lang <code> |
Язык интерфейса (auto, en, zh, ja, и т. д.) |
--config <path> |
Использовать указанный файл конфигурации |
Подключение
freeguard connect
Подключиться к VPN-серверу. Без аргументов автоматически выбирает самый быстрый доступный узел.
# Автоподключение к лучшему серверу
freeguard connect
# Подключение к конкретному узлу по ID
freeguard connect us-new-01
# Подключение к лучшему серверу в стране
freeguard connect --country JP
# Использовать определенный протокол
freeguard connect --protocol anytls
# Включить TUN mode (требует sudo/admin)
freeguard connect --tun
Человекочитаемый вывод:
✓ Connected to United States - New York (us-new-01)
Protocol: anytls | Latency: 42ms
Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)
Вывод JSON:
freeguard connect --json
{"status": "connected", "node": "us-new-01", "protocol": "anytls", "latency_ms": 42}
Флаги:
| Флаг | Описание |
|---|---|
--country <code> |
Подключиться к лучшему узлу в этой стране (ISO 3166-1 alpha-2) |
--protocol <name> |
Предпочтительный протокол (anytls, hysteria2, vless, и т. д.) |
--tun |
Использовать TUN mode для системного VPN (требуются повышенные привилегии) |
freeguard disconnect
Отключиться от текущего VPN-сервера.
freeguard disconnect
✓ Disconnected
freeguard disconnect --json
{"status": "disconnected"}
freeguard status
Показать текущее состояние подключения и статистику трафика.
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)
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}
}
Аутентификация
freeguard login
Аутентификация в FreeGuard. Поддерживает подтверждение по email (аккаунт не нужен) или вход в аккаунт FreeGuard.
Вход по email (рекомендуется):
# Шаг 1: запросить код подтверждения
freeguard login --email [email protected] --send-code
# Шаг 2: ввести код
freeguard login --email [email protected] --code 123456
✓ Logged in successfully!
✓ Found 1 active subscription (Pro Plan, expires 2026-12-01)
Вход в аккаунт (открывает браузер):
freeguard login --account
Флаги:
| Флаг | Описание |
|---|---|
--email <address> |
Войти с подтверждением по email |
--send-code |
Отправить код подтверждения на email |
--code <digits> |
Отправить 6-значный код подтверждения |
--account |
Войти в аккаунт FreeGuard через браузер OAuth |
freeguard logout
Очистить сохраненные учетные данные и отключиться, если подключение активно.
freeguard logout
✓ Logged out. Credentials cleared.
Подписка
freeguard subscribe list
Просмотреть доступные тарифы подписки и текущий статус вашей подписки.
freeguard subscribe list
Your Subscription
─────────────────
Plan: Pro
Status: Active
Expires: 2026-12-01
Traffic: 450 GB / Unlimited
Available Plans
───────────────
Plan Monthly Quarterly Annual
Basic $4.99 $12.99 $39.99
Pro $9.99 $24.99 $79.99
freeguard subscribe list --json
{
"current": {"plan": "pro", "status": "active", "expires": "2026-12-01"},
"plans": [
{"name": "basic", "prices": {"monthly": 4.99, "quarterly": 12.99, "annual": 39.99}},
{"name": "pro", "prices": {"monthly": 9.99, "quarterly": 24.99, "annual": 79.99}}
]
}
freeguard subscribe create
Создать новую подписку. Откроет браузер для завершения оплаты через Stripe или криптовалюту.
# Интерактивный выбор тарифа
freeguard subscribe create
# Указать тариф напрямую
freeguard subscribe create --plan pro --email [email protected]
Флаги:
| Флаг | Описание |
|---|---|
--plan <name> |
Тариф подписки (basic, pro) |
--email <address> |
Email для доставки подписки |
Конфигурация
freeguard config get
Читать значение конфигурации.
freeguard config get proxy.port
7890
freeguard config get proxy.port --json
{"key": "proxy.port", "value": 7890}
freeguard config set
Изменить значение конфигурации.
freeguard config set proxy.port 8080
✓ proxy.port set to 8080
Распространенные ключи конфигурации:
| Key | Default | Description |
|---|---|---|
proxy.port |
7890 |
Порт прокси HTTP/SOCKS5 |
proxy.mode |
rule |
Режим Proxy: rule, global, direct |
core.api_port |
9090 |
Порт API Mihomo |
core.pinned_version |
(empty) | Зафиксировать mihomo на определенной версии |
dns.provider |
auto |
Провайдер DNS |
update.auto_check |
true |
Проверять обновления при запуске |
freeguard config edit
Открыть файл конфигурации в редакторе по умолчанию.
freeguard config edit
Диагностика
freeguard doctor
Запустить комплексную проверку окружения для диагностики проблем.
freeguard doctor
FreeGuard Environment Check
───────────────────────────
✓ OS: macOS 15.2 (arm64)
✓ CLI version: v1.0.0
✓ Core version: mihomo v1.19.21
✓ Config dir: ~/.freeguard/
✓ Credentials: Logged in (email: u***@example.com)
✓ Subscription: Active (expires 2026-12-01)
✓ Network: Internet reachable
✓ DNS: Working (8.8.8.8)
✗ TUN permission: Not available (run with sudo for TUN mode)
✓ Port 7890: Available
✓ GeoIP database: Up to date (2026-03-15)
Result: 10/11 checks passed. TUN mode requires elevated privileges.
freeguard doctor --json
{
"checks": [
{"name": "os", "status": "pass", "detail": "macOS 15.2 (arm64)"},
{"name": "cli_version", "status": "pass", "detail": "v1.0.0"},
{"name": "tun_permission", "status": "fail", "detail": "Not available (run with sudo)"}
],
"passed": 10,
"total": 11
}
freeguard version
Показать информацию о версии CLI и ядра.
freeguard version
FreeGuard CLI v1.0.0
Core: mihomo v1.19.21
OS: darwin/arm64
freeguard version --json
{"cli": "1.0.0", "core": "1.19.21", "os": "darwin", "arch": "arm64"}
Расширенные функции (Phase 2+)
Следующие команды запланированы для будущих релизов.
freeguard node list
Список доступных VPN-узлов с фильтрацией и сортировкой.
freeguard node list
freeguard node list --country US --sort latency
Флаги:
| Флаг | Описание |
|---|---|
--country <code> |
Фильтровать по коду страны |
--protocol <name> |
Фильтровать по протоколу |
--sort <field> |
Сортировать по speed, latency или load |
freeguard node test
Проверить задержку и скорость узлов.
freeguard node test us-new-01
freeguard node test --all
freeguard monitor
Показывать мониторинг трафика в реальном времени в терминале.
freeguard monitor
↑ 0.8 MB/s ↓ 12.3 MB/s Connections: 47
freeguard core
Управление базовым движком mihomo.
# Проверить статус core
freeguard core status
# Обновить до последней версии core
freeguard core update
# Перезапустить core engine
freeguard core restart
freeguard shell
Войти в интерактивный режим REPL для выполнения нескольких команд в одной сессии.
freeguard shell
freeguard dashboard
Открыть TUI dashboard с графиками трафика в реальном времени, списком узлов и сведениями о подключении.
freeguard dashboard
Последнее обновление: March 2026