Riešenie problémov s FreeGuard CLI
Máte problémy s FreeGuard CLI? Tento sprievodca pokrýva najčastejšie problémy a ich riešenia. Pri každom probléme najprv skúste spustiť freeguard doctor — automaticky deteguje väčšinu problémov s konfiguráciou a prostredím.
Problémy s inštaláciou
Prístup zamietnutý počas inštalácie
Príznak: Inštalačný skript zlyhá s Permission denied alebo EACCES.
Riešenie: Na macOS/Linux potrebuje inštalátor oprávnenie na zápis do /usr/local/bin. Spustite so zvýšenými oprávneniami:
curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sudo sh
Na Windows sa uistite, že otvárate PowerShell ako správca pred spustením inštalačného príkazu.
Príkaz nenájdený po inštalácii
Príznak: Spustenie freeguard vráti command not found alebo not recognized.
Výstup Doctor:
✗ CLI binary: Not in PATH
Riešenie: Binárny súbor nemusí byť v PATH vášho shellu. Pridajte ho manuálne:
# macOS/Linux — add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="$HOME/.freeguard/bin:$PATH"
# Then reload your shell
source ~/.zshrc # or ~/.bashrc
Na Windows pridajte %USERPROFILE%\.freeguard\bin do systémovej premennej prostredia PATH a reštartujte terminál.
curl zlyhá alebo sťahovanie vyprší
Príznak: Inštalačný skript nemôže stiahnuť binárny súbor.
Riešenie: Ak ste za firemným firewallom alebo v obmedzenej sieti, stiahnite binárny súbor manuálne zo stránky vydaní na GitHube a umiestnite ho do ~/.freeguard/bin/. Potom ho nastavte ako spustiteľný:
chmod +x ~/.freeguard/bin/freeguard
Problémy s prihlásením
Overovací kód nebol doručený
Príznak: Po spustení freeguard login --email [email protected] --send-code nepríde žiadny e-mail.
Riešenie:
- Skontrolujte priečinok spam/nevyžiadaná pošta — overovacie e-maily sa niekedy filtrujú.
- Počkajte 2 minúty pred ďalšou požiadavkou. Na odosielanie kódov sa vzťahuje limit frekvencie.
- Overte správnosť e-mailovej adresy:
freeguard login --email [email protected] --send-code
- Skúste iného poskytovateľa e-mailu, ak problém pretrváva.
Token vypršal
Príznak: Príkazy zlyhávajú s Authentication expired alebo Token invalid.
Výstup Doctor:
✗ Credentials: Token expired (last refresh: 2026-03-01)
Riešenie: Prihláste sa znova na obnovenie prihlasovacích údajov:
freeguard logout
freeguard login --email [email protected] --send-code
Nesprávny e-mail — predplatné nenájdené
Príznak: Prihlásenie je úspešné, ale freeguard connect hlási No active subscription.
Výstup Doctor:
✓ Credentials: Logged in (email: u***@example.com)
✗ Subscription: No active subscription found
Riešenie: Uistite sa, že sa prihlasujete rovnakým e-mailom, ktorý ste použili na zakúpenie predplatného. Ak ste použili iný e-mail:
freeguard logout
freeguard login --email [email protected] --send-code
Problémy s pripojením
Vypršanie časového limitu pripojenia
Príznak: freeguard connect visí alebo vráti Connection timed out.
Výstup Doctor:
✗ Network: Internet not reachable
Riešenie:
- Skontrolujte základné internetové pripojenie (najprv odpojte VPN):
freeguard disconnect
ping 8.8.8.8
- Skúste iný uzol alebo krajinu:
freeguard connect --country SG
- Skúste iný protokol, ktorý môže lepšie fungovať vo vašej sieti:
freeguard connect --protocol hysteria2
Port 7890 je už používaný
Príznak: freeguard connect zlyhá s Port 7890 is already in use.
Výstup Doctor:
✗ Port 7890: In use by another process (PID: 12345)
Riešenie: Iná proxy aplikácia používa predvolený port. Zastavte druhú aplikáciu alebo zmeňte proxy port FreeGuard:
freeguard config set proxy.port 8080
freeguard connect
Detegovaný únik DNS
Príznak: DNS dotazy obchádzajú VPN tunel.
Riešenie: Prepnite na zabezpečenú konfiguráciu DNS:
freeguard config set dns.provider secure
freeguard disconnect
freeguard connect
Môžete overiť, že DNS je smerovaný cez VPN:
freeguard doctor
Vyhľadajte kontrolu DNS vo výstupe na potvrdenie správneho fungovania.
Problémy s oprávneniami
Režim TUN vyžaduje sudo
Príznak: freeguard connect --tun zlyhá s Permission denied: TUN device.
Výstup Doctor:
✗ TUN permission: Not available (run with sudo for TUN mode)
Riešenie: Režim TUN vytvára virtuálne sieťové rozhranie, čo vyžaduje zvýšené oprávnenia:
# macOS/Linux
sudo freeguard connect --tun
# Windows — run PowerShell as Administrator
freeguard connect --tun
Ak nepotrebujete celosystémové pokrytie VPN, použite predvolený režim systémového proxy (bez sudo):
freeguard connect
Port pod 1024 vyžaduje zvýšené oprávnenia
Príznak: Nastavenie proxy portu pod 1024 zlyhá s Permission denied.
Riešenie: Porty pod 1024 sú na väčšine operačných systémov obmedzené. Použite port nad 1024:
freeguard config set proxy.port 7890
Alebo spustite so zvýšenými oprávneniami, ak špecificky potrebujete nízky port:
sudo freeguard connect
Stále máte problém?
Ak freeguard doctor a vyššie uvedené riešenia nevyriešia váš problém, nechajte AI diagnostikovať ho automaticky.
Navštívte stránku FreeGuard CLI Agent a popíšte svoj problém. Agent môže prečítať výstup freeguard doctor --json a previesť vás krok za krokom k riešeniu.
Môžete tiež spustiť interaktívneho sprievodcu riešením problémov:
freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat
Často kladené otázky
Prečo FreeGuard CLI hlási “connection refused”?
To zvyčajne znamená, že VPN server je dočasne nedostupný. Skúste freeguard connect --server auto na automatický výber najlepšieho dostupného servera alebo skontrolujte nastavenia firewallu.
Ako zistím, či moje VPN pripojenie funguje?
Spustite freeguard status na zobrazenie stavu pripojenia, aktuálneho servera a protokolu. Môžete tiež spustiť curl ifconfig.me na overenie, že sa vaša IP adresa zmenila.
FreeGuard CLI sa nespustí po aktualizácii systému. Čo mám robiť?
Spustite freeguard update na získanie najnovšej verzie. Ak to zlyhá, preinštalujte pomocou inštalačného skriptu: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.
Ako nahlásiť chybu alebo získať pomoc?
Spustite freeguard debug na zhromaždenie diagnostických informácií a potom kontaktujte podporu prostredníctvom webu alebo e-mailu. Pre rýchlejšie vyriešenie priložte diagnostický výstup.
Posledná aktualizácia: marec 2026