Решавање проблеми со 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

Погрешна е-пошта — претплата не е пронајдена

Симптом: Најавувањето успева, но 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

Решение:

Проверете го вашиот основен интернет пристап (прво исклучете го 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 и решенијата погоре не го решаваат вашиот проблем, оставете 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 за да соберете дијагностички информации, потоа контактирајте ја поддршката преку веб-страницата или е-пошта. Вклучете го debug излезот за побрзо решавање.

Последно ажурирано: март 2026