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

Грешен имейл — не е намерен абонамент

Симптом: Входът е успешен, но freeguard connect казва No active subscription.

Изход от Doctor:

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

Решение: Уверете се, че влизате със същия имейл, с който сте закупили абонамента. Ако сте използвали различен имейл:

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 и решенията по-горе не разрешат проблема ви, оставете AI да го диагностицира автоматично.

Посетете страницата 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, за да съберете диагностична информация, след което се свържете с поддръжката чрез уебсайта или имейл. Включете диагностичния изход за по-бързо решение.

Последна актуализация: март 2026