FreeGuard CLI tõrkeotsing
Kas teil on probleeme FreeGuard CLI-ga? See juhend käsitleb levinumaid probleeme ja nende lahendusi. Iga probleemi puhul proovige esmalt käivitada freeguard doctor — see tuvastab automaatselt enamiku konfiguratsiooni- ja keskkonnaprobleeme.
Paigaldusprobleemid
Paigaldamisel keelatud juurdepääs
Sümptom: Paigaldusskript ebaõnnestub veaga Permission denied või EACCES.
Lahendus: macOS/Linux-is vajab paigaldaja kirjutamisõigust kausta /usr/local/bin. Käivitage kõrgendatud õigustega:
curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sudo sh
Windowsis veenduge, et avate PowerShelli administraatorina enne paigalduskäsu käivitamist.
Käsku ei leitud pärast paigaldamist
Sümptom: freeguard käivitamine tagastab command not found või not recognized.
Doctor väljund:
✗ CLI binary: Not in PATH
Lahendus: Binaarfail ei pruugi olla teie shelli PATH-is. Lisage see käsitsi:
# macOS/Linux — add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="$HOME/.freeguard/bin:$PATH"
# Then reload your shell
source ~/.zshrc # or ~/.bashrc
Windowsis lisage %USERPROFILE%\.freeguard\bin oma süsteemi PATH keskkonnamuutujale ja taaskäivitage terminal.
curl ebaõnnestub või allalaadimine aegub
Sümptom: Paigaldusskript ei saa binaarfaili alla laadida.
Lahendus: Kui olete ettevõtte tulemüüri taga või piiratud võrgus, laadige binaarfail käsitsi alla GitHubi väljalasete lehelt ja asetage see kausta ~/.freeguard/bin/. Seejärel tehke see käivitatavaks:
chmod +x ~/.freeguard/bin/freeguard
Sisselogimisprobleemid
Kinnituskoodi ei saadud
Sümptom: Pärast freeguard login --email [email protected] --send-code käivitamist ei saabu e-kirja.
Lahendus:
- Kontrollige oma rämpsposti/prügi kausta — kinnituskirjad filtreeritakse mõnikord välja.
- Oodake 2 minutit enne uuesti pärimist. Koodide saatmisel kehtib sageduspiirang.
- Veenduge, et e-posti aadress on õige:
freeguard login --email [email protected] --send-code
- Proovige teist e-posti teenusepakkujat, kui probleem püsib.
Token aegunud
Sümptom: Käsud ebaõnnestuvad veaga Authentication expired või Token invalid.
Doctor väljund:
✗ Credentials: Token expired (last refresh: 2026-03-01)
Lahendus: Logige uuesti sisse, et oma volitusi värskendada:
freeguard logout
freeguard login --email [email protected] --send-code
Vale e-post — tellimust ei leitud
Sümptom: Sisselogimine õnnestub, kuid freeguard connect ütleb No active subscription.
Doctor väljund:
✓ Credentials: Logged in (email: u***@example.com)
✗ Subscription: No active subscription found
Lahendus: Veenduge, et logite sisse sama e-postiga, mida kasutasite tellimuse ostmiseks. Kui kasutasite teist e-posti:
freeguard logout
freeguard login --email [email protected] --send-code
Ühendusprobleemid
Ühenduse aegumine
Sümptom: freeguard connect jääb rippuma või tagastab Connection timed out.
Doctor väljund:
✗ Network: Internet not reachable
Lahendus:
- Kontrollige oma põhilist internetiühendust (katkestage esmalt VPN):
freeguard disconnect
ping 8.8.8.8
- Proovige teist sõlme või riiki:
freeguard connect --country SG
- Proovige teist protokolli, mis võib teie võrgus paremini toimida:
freeguard connect --protocol hysteria2
Port 7890 on juba kasutusel
Sümptom: freeguard connect ebaõnnestub veaga Port 7890 is already in use.
Doctor väljund:
✗ Port 7890: In use by another process (PID: 12345)
Lahendus: Teine proxy rakendus kasutab vaikeporti. Kas peatage teine rakendus või muutke FreeGuard proxy porti:
freeguard config set proxy.port 8080
freeguard connect
DNS-leke tuvastatud
Sümptom: DNS-päringud mööduvad VPN-tunnelist.
Lahendus: Lülituge turvalise DNS-i konfiguratsioonile:
freeguard config set dns.provider secure
freeguard disconnect
freeguard connect
Saate kontrollida, kas DNS suunatakse läbi VPN-i:
freeguard doctor
Otsige väljundist DNS-i kontrolli, et kinnitada selle korrektset toimimist.
Õiguste probleemid
TUN-režiim nõuab sudo
Sümptom: freeguard connect --tun ebaõnnestub veaga Permission denied: TUN device.
Doctor väljund:
✗ TUN permission: Not available (run with sudo for TUN mode)
Lahendus: TUN-režiim loob virtuaalse võrguliidese, mis nõuab kõrgendatud õigusi:
# macOS/Linux
sudo freeguard connect --tun
# Windows — run PowerShell as Administrator
freeguard connect --tun
Kui te ei vaja süsteemiülest VPN-katet, kasutage vaikimisi süsteemi proxy režiimi (sudo pole vajalik):
freeguard connect
Port alla 1024 nõuab kõrgendatud õigusi
Sümptom: Proxy pordi seadmine alla 1024 ebaõnnestub veaga Permission denied.
Lahendus: Pordid alla 1024 on enamikus operatsioonisüsteemides piiratud. Kasutage porti üle 1024:
freeguard config set proxy.port 7890
Või käivitage kõrgendatud õigustega, kui vajate konkreetselt madalat porti:
sudo freeguard connect
Ikka veel hätta jäänud?
Kui freeguard doctor ja ülaltoodud lahendused ei lahenda teie probleemi, laske tehisintellektil see automaatselt diagnoosida.
Külastage FreeGuard CLI Agent lehte ja kirjeldage oma probleemi. Agent saab lugeda teie freeguard doctor --json väljundit ja juhatada teid samm-sammult lahenduseni.
Saate käivitada ka interaktiivse tõrkeotsinguviisardi:
freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat
Korduma kippuvad küsimused
Miks ütleb FreeGuard CLI “connection refused”?
See tähendab tavaliselt, et VPN-server on ajutiselt kättesaamatu. Proovige freeguard connect --server auto, et automaatselt valida parim saadaolev server, või kontrollige oma tulemüüri seadeid.
Kuidas kontrollida, kas mu VPN-ühendus töötab?
Käivitage freeguard status, et näha ühenduse olekut, praegust serverit ja protokolli. Saate ka käivitada curl ifconfig.me, et kontrollida, kas teie IP-aadress on muutunud.
FreeGuard CLI ei käivitu pärast süsteemivärskendust. Mida teha?
Käivitage freeguard update, et saada uusim versioon. Kui see ebaõnnestub, installige uuesti paigaldusskriptiga: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.
Kuidas teatada veast või saada abi?
Käivitage freeguard debug, et koguda diagnostikateavet, seejärel pöörduge toe poole veebisaidi või e-posti kaudu. Lisage silumisväljund kiiremaks lahendamiseks.
Viimati uuendatud: märts 2026