Усунення несправностей 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 лист не надходить.

Рішення:

Перевірте папку спам/небажана пошта — листи підтвердження іноді фільтруються.
Зачекайте 2 хвилини перед повторним запитом. Існує обмеження частоти надсилання кодів.
Переконайтеся, що адреса електронної пошти правильна:

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

Спробуйте іншого постачальника електронної пошти, якщо проблема не зникає.

Токен закінчився

Симптом: Команди завершуються помилкою 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

Рішення:

Перевірте базове інтернет-з’єднання (спершу від’єднайте VPN):

freeguard disconnect
ping 8.8.8.8

Спробуйте інший вузол або країну:

freeguard connect --country SG

Спробуйте інший протокол, який може краще працювати у вашій мережі:

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