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