FreeGuard CLI úrræðaleit
Ertu í vandræðum með FreeGuard CLI? Þessi leiðarvísir fjallar um algengustu vandamálin og lausnir þeirra. Fyrir hvert vandamál skaltu fyrst prófa að keyra freeguard doctor — það greinir sjálfkrafa flest stillinga- og umhverfisvandamál.
Uppsetningarvandamál
Heimild hafnað við uppsetningu
Einkenni: Uppsetningarskriftan mistekst með Permission denied eða EACCES.
Lausn: Á macOS/Linux þarf uppsetningarforritið skrifheimild í /usr/local/bin. Keyrðu með auknum réttindum:
curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sudo sh
Á Windows skaltu tryggja að þú opnir PowerShell sem stjórnandi áður en þú keyrir uppsetningarskipunina.
Skipun finnst ekki eftir uppsetningu
Einkenni: Keyrsla á freeguard skilar command not found eða not recognized.
Doctor úttak:
✗ CLI binary: Not in PATH
Lausn: Tvíundaskráin er kannski ekki í PATH skeljarinnar þinnar. Bættu henni við handvirkt:
# macOS/Linux — add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="$HOME/.freeguard/bin:$PATH"
# Then reload your shell
source ~/.zshrc # or ~/.bashrc
Á Windows skaltu bæta %USERPROFILE%\.freeguard\bin við PATH umhverfisbreytuna og endurræsa útstöðina.
curl mistekst eða niðurhal rennur út á tíma
Einkenni: Uppsetningarskriftan getur ekki halað niður tvíundaskránni.
Lausn: Ef þú ert á bak við fyrirtækjaeldvegg eða á takmörkuðu neti skaltu hala niður tvíundaskránni handvirkt af GitHub útgáfusíðunni og setja hana í ~/.freeguard/bin/. Gerðu hana síðan keyranlega:
chmod +x ~/.freeguard/bin/freeguard
Innskráningarvandamál
Staðfestingarkóði ekki móttekinn
Einkenni: Eftir keyrslu á freeguard login --email [email protected] --send-code kemur enginn tölvupóstur.
Lausn:
- Athugaðu ruslpóstsmöppuna — staðfestingarpóstar eru stundum síaðir.
- Bíddu í 2 mínútur áður en þú biður aftur. Það er hraðatakmörkun á sendingu kóða.
- Staðfestu að netfangið sé rétt:
freeguard login --email [email protected] --send-code
- Prófaðu annan tölvupóstþjónustuaðila ef vandamálið varir.
Tóki útrunninn
Einkenni: Skipanir mistakast með Authentication expired eða Token invalid.
Doctor úttak:
✗ Credentials: Token expired (last refresh: 2026-03-01)
Lausn: Skráðu þig inn aftur til að endurnýja auðkennin:
freeguard logout
freeguard login --email [email protected] --send-code
Rangt netfang — áskrift finnst ekki
Einkenni: Innskráning tekst en freeguard connect segir No active subscription.
Doctor úttak:
✓ Credentials: Logged in (email: u***@example.com)
✗ Subscription: No active subscription found
Lausn: Gakktu úr skugga um að þú skráir þig inn með sama netfangi og þú notaðir til að kaupa áskriftina. Ef þú notaðir annað netfang:
freeguard logout
freeguard login --email [email protected] --send-code
Tengingarvandamál
Tenging rennur út á tíma
Einkenni: freeguard connect hangir eða skilar Connection timed out.
Doctor úttak:
✗ Network: Internet not reachable
Lausn:
- Athugaðu grunnnettenginguna þína (aftengdu VPN fyrst):
freeguard disconnect
ping 8.8.8.8
- Prófaðu annan hnút eða land:
freeguard connect --country SG
- Prófaðu annað samskiptareglu sem gæti virkað betur á netinu þínu:
freeguard connect --protocol hysteria2
Gátt 7890 er þegar í notkun
Einkenni: freeguard connect mistekst með Port 7890 is already in use.
Doctor úttak:
✗ Port 7890: In use by another process (PID: 12345)
Lausn: Annað proxy forrit notar sjálfgefnu gáttina. Stöðvaðu hitt forritið eða breyttu FreeGuard proxy gáttinni:
freeguard config set proxy.port 8080
freeguard connect
DNS-leki greindst
Einkenni: DNS-fyrirspurnir fara framhjá VPN-göngunum.
Lausn: Skiptu yfir í örugga DNS-stillingu:
freeguard config set dns.provider secure
freeguard disconnect
freeguard connect
Þú getur staðfest að DNS er beint í gegnum VPN:
freeguard doctor
Leitaðu að DNS athuguninni í úttakinu til að staðfesta að hún virki rétt.
Heimildarvandamál
TUN-stilling krefst sudo
Einkenni: freeguard connect --tun mistekst með Permission denied: TUN device.
Doctor úttak:
✗ TUN permission: Not available (run with sudo for TUN mode)
Lausn: TUN-stilling býr til sýndarnetviðmót sem krefst aukinna réttinda:
# macOS/Linux
sudo freeguard connect --tun
# Windows — run PowerShell as Administrator
freeguard connect --tun
Ef þú þarft ekki VPN-vernd á kerfisháu stigi skaltu nota sjálfgefna kerfis proxy-stillingu (sudo ekki nauðsynlegt):
freeguard connect
Gátt undir 1024 krefst aukinna réttinda
Einkenni: Stilling proxy gáttar undir 1024 mistekst með Permission denied.
Lausn: Gáttir undir 1024 eru takmarkaðar á flestum stýrikerfum. Notaðu gátt yfir 1024:
freeguard config set proxy.port 7890
Eða keyrðu með auknum réttindum ef þú þarft sérstaklega lága gátt:
sudo freeguard connect
Enn fastur?
Ef freeguard doctor og lausnirnar hér að ofan leysa ekki vandamálið þitt skaltu láta gervigreind greina það sjálfkrafa.
Farðu á FreeGuard CLI Agent síðuna og lýstu vandamálinu þínu. Umboðsmaðurinn getur lesið freeguard doctor --json úttakið þitt og leiðbeint þér skref fyrir skref í átt að lausn.
Þú getur líka keyrt gagnvirka úrræðaleitarleiðsögn:
freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat
Algengar spurningar
Af hverju segir FreeGuard CLI “connection refused”?
Þetta þýðir venjulega að VPN-þjónninn er tímabundið óaðgengilegur. Prófaðu freeguard connect --server auto til að velja sjálfkrafa besta tiltæka þjóninn, eða athugaðu eldveggsstillingarnar.
Hvernig athuga ég hvort VPN-tengingin mín virkar?
Keyrðu freeguard status til að sjá tengistöðu, núverandi þjón og samskiptareglu. Þú getur líka keyrt curl ifconfig.me til að staðfesta að IP-talan þín hafi breyst.
FreeGuard CLI ræsist ekki eftir kerfisuppfærslu. Hvað á ég að gera?
Keyrðu freeguard update til að fá nýjustu útgáfuna. Ef það mistekst skaltu setja upp aftur með uppsetningarskriftunni: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.
Hvernig tilkynni ég villu eða fæ aðstoð?
Keyrðu freeguard debug til að safna greiningarupplýsingum og hafðu síðan samband við þjónustuver í gegnum vefsíðuna eða tölvupóst. Láttu debug-úttakið fylgja með til að fá hraðari úrlausn.
Síðast uppfært: mars 2026