Odpravljanje težav s FreeGuard CLI
Imate težave s FreeGuard CLI? Ta vodnik pokriva najpogostejše težave in njihove rešitve. Za vsako težavo najprej poskusite zagnati freeguard doctor — samodejno zazna večino konfiguracijskih in okoljskih težav.
Težave z namestitvijo
Dovoljenje zavrnjeno med namestitvijo
Simptom: Namestitveni skript ne uspe z Permission denied ali EACCES.
Rešitev: Na macOS/Linux namestitveni program potrebuje dostop za pisanje v /usr/local/bin. Zaženite s povišenimi pravicami:
curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sudo sh
Na Windows se prepričajte, da odprete PowerShell kot skrbnik pred zagonom namestitvenega ukaza.
Ukaz ni najden po namestitvi
Simptom: Zagon freeguard vrne command not found ali not recognized.
Izhod Doctor:
✗ CLI binary: Not in PATH
Rešitev: Binarna datoteka morda ni v PATH vaše lupine. Dodajte jo ročno:
# 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 dodajte %USERPROFILE%\.freeguard\bin v sistemsko spremenljivko okolja PATH in znova zaženite terminal.
curl ne uspe ali prenos poteče
Simptom: Namestitveni skript ne more prenesti binarne datoteke.
Rešitev: Če ste za korporativnim požarnim zidom ali v omejenem omrežju, prenesite binarno datoteko ročno s strani izdaj na GitHubu in jo postavite v ~/.freeguard/bin/. Nato jo naredite izvršljivo:
chmod +x ~/.freeguard/bin/freeguard
Težave s prijavo
Potrditvena koda ni bila prejeta
Simptom: Po zagonu freeguard login --email [email protected] --send-code ne pride nobeno e-poštno sporočilo.
Rešitev:
- Preverite mapo z vsiljeno/neželeno pošto — potrditvena e-poštna sporočila se včasih filtrirajo.
- Počakajte 2 minuti pred ponovnim zahtevkom. Za pošiljanje kod velja omejitev hitrosti.
- Preverite, ali je e-poštni naslov pravilen:
freeguard login --email [email protected] --send-code
- Poskusite z drugim ponudnikom e-pošte, če se težava nadaljuje.
Žeton je potekel
Simptom: Ukazi ne uspejo z Authentication expired ali Token invalid.
Izhod Doctor:
✗ Credentials: Token expired (last refresh: 2026-03-01)
Rešitev: Prijavite se znova, da osvežite poverilnice:
freeguard logout
freeguard login --email [email protected] --send-code
Napačen e-naslov — naročnina ni najdena
Simptom: Prijava uspe, vendar freeguard connect sporoči No active subscription.
Izhod Doctor:
✓ Credentials: Logged in (email: u***@example.com)
✗ Subscription: No active subscription found
Rešitev: Prepričajte se, da se prijavljate z istim e-naslovom, s katerim ste kupili naročnino. Če ste uporabili drug e-naslov:
freeguard logout
freeguard login --email [email protected] --send-code
Težave s povezavo
Potek časa povezave
Simptom: freeguard connect visi ali vrne Connection timed out.
Izhod Doctor:
✗ Network: Internet not reachable
Rešitev:
- Preverite osnovno internetno povezavo (najprej prekinite VPN):
freeguard disconnect
ping 8.8.8.8
- Poskusite z drugim vozliščem ali državo:
freeguard connect --country SG
- Poskusite z drugim protokolom, ki morda bolje deluje v vašem omrežju:
freeguard connect --protocol hysteria2
Vrata 7890 so že v uporabi
Simptom: freeguard connect ne uspe z Port 7890 is already in use.
Izhod Doctor:
✗ Port 7890: In use by another process (PID: 12345)
Rešitev: Druga proxy aplikacija uporablja privzeta vrata. Ustavite drugo aplikacijo ali spremenite proxy vrata FreeGuard:
freeguard config set proxy.port 8080
freeguard connect
Zaznano uhajanje DNS
Simptom: DNS poizvedbe obidejo VPN tunel.
Rešitev: Preklopite na varno DNS konfiguracijo:
freeguard config set dns.provider secure
freeguard disconnect
freeguard connect
Preverite lahko, ali se DNS usmerja prek VPN:
freeguard doctor
Poiščite preverjanje DNS v izhodu, da potrdite pravilno delovanje.
Težave z dovoljenji
Način TUN zahteva sudo
Simptom: freeguard connect --tun ne uspe z Permission denied: TUN device.
Izhod Doctor:
✗ TUN permission: Not available (run with sudo for TUN mode)
Rešitev: Način TUN ustvari navidezni omrežni vmesnik, kar zahteva povišene pravice:
# macOS/Linux
sudo freeguard connect --tun
# Windows — run PowerShell as Administrator
freeguard connect --tun
Če ne potrebujete sistemskega pokritja VPN, uporabite privzeti sistemski proxy način (sudo ni potreben):
freeguard connect
Vrata pod 1024 zahtevajo povišene pravice
Simptom: Nastavitev proxy vrat pod 1024 ne uspe z Permission denied.
Rešitev: Vrata pod 1024 so na večini operacijskih sistemov omejena. Uporabite vrata nad 1024:
freeguard config set proxy.port 7890
Ali zaženite s povišenimi pravicami, če posebej potrebujete nizka vrata:
sudo freeguard connect
Še vedno obtičali?
Če freeguard doctor in zgornje rešitve ne rešijo vaše težave, pustite AI, da jo samodejno diagnosticira.
Obiščite stran FreeGuard CLI Agent in opišite svojo težavo. Agent lahko prebere izhod freeguard doctor --json in vas korak za korakom vodi do rešitve.
Lahko tudi zaženete interaktivnega čarovnika za odpravljanje težav:
freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat
Pogosta vprašanja
Zakaj FreeGuard CLI javlja “connection refused”?
To običajno pomeni, da je VPN strežnik začasno nedostopen. Poskusite freeguard connect --server auto za samodejno izbiro najboljšega razpoložljivega strežnika ali preverite nastavitve požarnega zidu.
Kako preverim, ali moja VPN povezava deluje?
Zaženite freeguard status, da vidite stanje povezave, trenutni strežnik in protokol. Zaženete lahko tudi curl ifconfig.me, da preverite, ali se je vaš IP naslov spremenil.
FreeGuard CLI se ne zažene po posodobitvi sistema. Kaj storiti?
Zaženite freeguard update, da dobite najnovejšo različico. Če to ne uspe, znova namestite z namestitvenim skriptom: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.
Kako prijavim napako ali dobim pomoč?
Zaženite freeguard debug, da zberete diagnostične informacije, nato pa se obrnite na podporo prek spletne strani ali e-pošte. Priložite izhod debug za hitrejšo rešitev.
Nazadnje posodobljeno: marec 2026