FreeGuard VPN
Домашняя страницаVPN-узлыЦенообразование
Устранение неполадок FreeGuard CLI
Возникли проблемы с FreeGuard CLI? Это руководство охватывает наиболее распространённые проблемы и их решения. При каждой проблеме сначала попробуйте выполнить `freeguard doctor` — он автоматически обнаруживает большинство проблем с конфигурацией и окружением.
Содержание

Устранение неполадок FreeGuard CLI

Возникли проблемы с FreeGuard CLI? Это руководство охватывает наиболее распространённые проблемы и их решения. При каждой проблеме сначала попробуйте выполнить freeguard doctor — он автоматически обнаруживает большинство проблем с конфигурацией и окружением.

Проблемы с установкой

Отказ в доступе при установке

Симптом: Скрипт установки завершается ошибкой Permission denied или EACCES.

Решение: На macOS/Linux установщику необходим доступ на запись в /usr/local/bin. Запустите с повышенными привилегиями:

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

На Windows убедитесь, что открываете PowerShell от имени администратора перед выполнением команды установки.

Команда не найдена после установки

Симптом: Выполнение freeguard возвращает command not found или not recognized.

Вывод Doctor:

✗ CLI binary:     Not in PATH

Решение: Бинарный файл может отсутствовать в PATH вашей оболочки. Добавьте его вручную:

# macOS/Linux — add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="$HOME/.freeguard/bin:$PATH"

# Then reload your shell
source ~/.zshrc  # or ~/.bashrc

На Windows добавьте %USERPROFILE%\.freeguard\bin в системную переменную окружения PATH и перезапустите терминал.

curl завершается ошибкой или загрузка прерывается по таймауту

Симптом: Скрипт установки не может загрузить бинарный файл.

Решение: Если вы находитесь за корпоративным брандмауэром или в ограниченной сети, загрузите бинарный файл вручную со страницы релизов на GitHub и поместите его в ~/.freeguard/bin/. Затем сделайте его исполняемым:

chmod +x ~/.freeguard/bin/freeguard

Проблемы со входом

Код подтверждения не получен

Симптом: После выполнения freeguard login --email [email protected] --send-code письмо не приходит.

Решение:

  1. Проверьте папку спам/нежелательная почта — письма с кодом подтверждения иногда попадают в фильтр.
  2. Подождите 2 минуты перед повторным запросом. Существует ограничение частоты отправки кодов.
  3. Убедитесь, что адрес электронной почты указан правильно:
freeguard login --email [email protected] --send-code
  1. Попробуйте другого провайдера электронной почты, если проблема сохраняется.

Токен истёк

Симптом: Команды завершаются ошибкой Authentication expired или Token invalid.

Вывод Doctor:

✗ Credentials:     Token expired (last refresh: 2026-03-01)

Решение: Войдите снова, чтобы обновить учётные данные:

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

Неверный email — подписка не найдена

Симптом: Вход выполнен успешно, но freeguard connect сообщает No active subscription.

Вывод Doctor:

✓ Credentials:     Logged in (email: u***@example.com)
✗ Subscription:    No active subscription found

Решение: Убедитесь, что входите с тем же email, который использовали для покупки подписки. Если вы использовали другой email:

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

Проблемы с подключением

Таймаут подключения

Симптом: freeguard connect зависает или возвращает Connection timed out.

Вывод Doctor:

✗ Network:         Internet not reachable

Решение:

  1. Проверьте базовое интернет-соединение (сначала отключите VPN):
freeguard disconnect
ping 8.8.8.8
  1. Попробуйте другой узел или страну:
freeguard connect --country SG
  1. Попробуйте другой протокол, который может лучше работать в вашей сети:
freeguard connect --protocol hysteria2

Порт 7890 уже используется

Симптом: freeguard connect завершается ошибкой Port 7890 is already in use.

Вывод Doctor:

✗ Port 7890:       In use by another process (PID: 12345)

Решение: Другое proxy-приложение использует порт по умолчанию. Остановите другое приложение или измените proxy-порт FreeGuard:

freeguard config set proxy.port 8080
freeguard connect

Обнаружена утечка DNS

Симптом: DNS-запросы обходят VPN-туннель.

Решение: Переключитесь на безопасную конфигурацию DNS:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Вы можете проверить, что DNS маршрутизируется через VPN:

freeguard doctor

Найдите проверку DNS в выводе, чтобы убедиться в корректной работе.

Проблемы с правами доступа

Режим TUN требует sudo

Симптом: freeguard connect --tun завершается ошибкой Permission denied: TUN device.

Вывод Doctor:

✗ TUN permission:  Not available (run with sudo for TUN mode)

Решение: Режим TUN создаёт виртуальный сетевой интерфейс, для чего необходимы повышенные привилегии:

# macOS/Linux
sudo freeguard connect --tun

# Windows — run PowerShell as Administrator
freeguard connect --tun

Если вам не нужно покрытие VPN на уровне всей системы, используйте режим системного proxy по умолчанию (sudo не требуется):

freeguard connect

Порт ниже 1024 требует повышенных привилегий

Симптом: Установка proxy-порта ниже 1024 завершается ошибкой Permission denied.

Решение: Порты ниже 1024 ограничены в большинстве операционных систем. Используйте порт выше 1024:

freeguard config set proxy.port 7890

Или запустите с повышенными привилегиями, если вам конкретно нужен низкий порт:

sudo freeguard connect

Всё ещё не решено?

Если freeguard doctor и приведённые выше решения не устраняют вашу проблему, позвольте ИИ автоматически её диагностировать.

Перейдите на страницу FreeGuard CLI Agent и опишите свою проблему. Агент может прочитать вывод freeguard doctor --json и пошагово провести вас к решению.

Вы также можете запустить интерактивный мастер устранения неполадок:

freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat

Часто задаваемые вопросы

Почему FreeGuard CLI выдаёт “connection refused”?

Обычно это означает, что VPN-сервер временно недоступен. Попробуйте freeguard connect --server auto для автоматического выбора лучшего доступного сервера или проверьте настройки брандмауэра.

Как проверить, работает ли моё VPN-соединение?

Выполните freeguard status, чтобы увидеть состояние подключения, текущий сервер и протокол. Также можно выполнить curl ifconfig.me, чтобы проверить, изменился ли ваш IP-адрес.

FreeGuard CLI не запускается после обновления системы. Что делать?

Выполните freeguard update, чтобы получить последнюю версию. Если это не поможет, переустановите с помощью скрипта установки: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Как сообщить об ошибке или получить помощь?

Выполните freeguard debug для сбора диагностической информации, затем свяжитесь со службой поддержки через сайт или по электронной почте. Приложите вывод debug для более быстрого решения.

Последнее обновление: март 2026