FreeGuard CLI feilsøking
Har du problemer med FreeGuard CLI? Denne guiden dekker de vanligste problemene og deres løsninger. For hvert problem, prøv å kjøre freeguard doctor først — den oppdager automatisk de fleste konfigurasjons- og miljøproblemer.
Installasjonsproblemer
Tilgang nektet under installasjon
Symptom: Installasjonsskriptet feiler med Permission denied eller EACCES.
Løsning: På macOS/Linux trenger installasjonsprogrammet skrivetilgang til /usr/local/bin. Kjør med forhøyede rettigheter:
curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sudo sh
På Windows, sørg for at du åpner PowerShell som administrator før du kjører installasjonskommandoen.
Kommando ikke funnet etter installasjon
Symptom: Å kjøre freeguard returnerer command not found eller not recognized.
Doctor-utdata:
✗ CLI binary: Not in PATH
Løsning: Den binære filen er kanskje ikke i shellets PATH. Legg den til manuelt:
# macOS/Linux — add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="$HOME/.freeguard/bin:$PATH"
# Then reload your shell
source ~/.zshrc # or ~/.bashrc
På Windows, legg til %USERPROFILE%\.freeguard\bin i systemets PATH-miljøvariabel og start terminalen på nytt.
curl feiler eller nedlasting tidsavbrudd
Symptom: Installasjonsskriptet kan ikke laste ned den binære filen.
Løsning: Hvis du er bak en bedriftsbrannmur eller i et begrenset nettverk, last ned den binære filen manuelt fra GitHub Releases-siden og plasser den i ~/.freeguard/bin/. Gjør den deretter kjørbar:
chmod +x ~/.freeguard/bin/freeguard
Innloggingsproblemer
Bekreftelseskode ikke mottatt
Symptom: Etter å ha kjørt freeguard login --email [email protected] --send-code kommer det ingen e-post.
Løsning:
- Sjekk spam-/søppelpostmappen — bekreftelses-e-poster blir noen ganger filtrert.
- Vent 2 minutter før du ber om ny kode. Det er en hastighetsbegrensning på kodesending.
- Bekreft at e-postadressen er riktig:
freeguard login --email [email protected] --send-code
- Prøv en annen e-postleverandør hvis problemet vedvarer.
Token utløpt
Symptom: Kommandoer feiler med Authentication expired eller Token invalid.
Doctor-utdata:
✗ Credentials: Token expired (last refresh: 2026-03-01)
Løsning: Logg inn igjen for å oppdatere legitimasjonen din:
freeguard logout
freeguard login --email [email protected] --send-code
Feil e-post — abonnement ikke funnet
Symptom: Innlogging lykkes, men freeguard connect sier No active subscription.
Doctor-utdata:
✓ Credentials: Logged in (email: u***@example.com)
✗ Subscription: No active subscription found
Løsning: Sørg for at du logger inn med samme e-post du brukte til å kjøpe abonnementet. Hvis du brukte en annen e-post:
freeguard logout
freeguard login --email [email protected] --send-code
Tilkoblingsproblemer
Tilkoblingstidsavbrudd
Symptom: freeguard connect henger eller returnerer Connection timed out.
Doctor-utdata:
✗ Network: Internet not reachable
Løsning:
- Sjekk den grunnleggende internettforbindelsen din (koble fra VPN først):
freeguard disconnect
ping 8.8.8.8
- Prøv en annen node eller et annet land:
freeguard connect --country SG
- Prøv en annen protokoll som kan fungere bedre på nettverket ditt:
freeguard connect --protocol hysteria2
Port 7890 er allerede i bruk
Symptom: freeguard connect feiler med Port 7890 is already in use.
Doctor-utdata:
✗ Port 7890: In use by another process (PID: 12345)
Løsning: En annen proxy-applikasjon bruker standardporten. Stopp den andre applikasjonen, eller endre FreeGuard proxy-porten:
freeguard config set proxy.port 8080
freeguard connect
DNS-lekkasje oppdaget
Symptom: DNS-forespørsler omgår VPN-tunnelen.
Løsning: Bytt til en sikker DNS-konfigurasjon:
freeguard config set dns.provider secure
freeguard disconnect
freeguard connect
Du kan bekrefte at DNS rutes gjennom VPN:
freeguard doctor
Se etter DNS-sjekken i utdataen for å bekrefte at den fungerer riktig.
Rettighetsproblemer
TUN-modus krever sudo
Symptom: freeguard connect --tun feiler med Permission denied: TUN device.
Doctor-utdata:
✗ TUN permission: Not available (run with sudo for TUN mode)
Løsning: TUN-modus oppretter et virtuelt nettverksgrensesnitt, som krever forhøyede rettigheter:
# macOS/Linux
sudo freeguard connect --tun
# Windows — run PowerShell as Administrator
freeguard connect --tun
Hvis du ikke trenger systemomfattende VPN-dekning, bruk standard system proxy-modus (ingen sudo nødvendig):
freeguard connect
Port under 1024 krever forhøyede rettigheter
Symptom: Å sette en proxy-port under 1024 feiler med Permission denied.
Løsning: Porter under 1024 er begrenset på de fleste operativsystemer. Bruk en port over 1024:
freeguard config set proxy.port 7890
Eller kjør med forhøyede rettigheter hvis du spesifikt trenger en lav port:
sudo freeguard connect
Fortsatt fastlåst?
Hvis freeguard doctor og løsningene ovenfor ikke løser problemet ditt, la AI diagnostisere det automatisk.
Besøk FreeGuard CLI Agent-siden og beskriv problemet ditt. Agenten kan lese freeguard doctor --json-utdataen din og lede deg steg for steg gjennom en løsning.
Du kan også kjøre den interaktive feilsøkingsveiviseren:
freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat
Ofte stilte spørsmål
Hvorfor sier FreeGuard CLI “connection refused”?
Dette betyr vanligvis at VPN-serveren er midlertidig utilgjengelig. Prøv freeguard connect --server auto for å automatisk velge den beste tilgjengelige serveren, eller sjekk brannmurinnstillingene dine.
Hvordan sjekker jeg om VPN-tilkoblingen min fungerer?
Kjør freeguard status for å se tilkoblingsstatusen, gjeldende server og protokoll. Du kan også kjøre curl ifconfig.me for å bekrefte at IP-adressen din har endret seg.
FreeGuard CLI starter ikke etter systemoppdatering. Hva gjør jeg?
Kjør freeguard update for å få den nyeste versjonen. Hvis det feiler, installer på nytt med installasjonsskriptet: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.
Hvordan rapporterer jeg en feil eller får hjelp?
Kjør freeguard debug for å samle diagnostisk informasjon, og kontakt deretter støtte via nettsiden eller e-post. Inkluder debug-utdataen for raskere løsning.
Sist oppdatert: mars 2026