FreeGuard CLI fejlfinding

Har du problemer med FreeGuard CLI? Denne guide dækker de mest almindelige problemer og deres løsninger. For hvert problem, prøv at køre freeguard doctor først — den registrerer automatisk de fleste konfigurations- og miljøproblemer.

Installationsproblemer

Adgang nægtet under installation

Symptom: Installationsscriptet fejler med Permission denied eller EACCES.

Løsning: På macOS/Linux har installationsprogrammet brug for skriveadgang til /usr/local/bin. Kør med forhøjede rettigheder:

curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sudo sh

På Windows skal du sørge for at åbne PowerShell som administrator, før du kører installationskommandoen.

Kommando ikke fundet efter installation

Symptom: At køre freeguard returnerer command not found eller not recognized.

Doctor-output:

✗ CLI binary:     Not in PATH

Løsning: Den binære fil er muligvis ikke i din shells PATH. Tilføj den 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 skal du tilføje %USERPROFILE%\.freeguard\bin til din system PATH-miljøvariabel og genstarte terminalen.

curl fejler eller download timeout

Symptom: Installationsscriptet kan ikke downloade den binære fil.

Løsning: Hvis du er bag en virksomhedsfirewall eller i et begrænset netværk, kan du downloade den binære fil manuelt fra GitHub Releases-siden og placere den i ~/.freeguard/bin/. Gør den derefter eksekverbar:

chmod +x ~/.freeguard/bin/freeguard

Loginproblemer

Bekræftelseskode ikke modtaget

Symptom: Efter at have kørt freeguard login --email [email protected] --send-code ankommer ingen e-mail.

Løsning:

Tjek din spam/uønsket post-mappe — bekræftelsesmails bliver nogle gange filtreret.
Vent 2 minutter, før du anmoder igen. Der er en hastighedsbegrænsning på kodesendelse.
Bekræft, at e-mailadressen er korrekt:

freeguard login --email [email protected] --send-code

Prøv en anden e-mailudbyder, hvis problemet fortsætter.

Token udløbet

Symptom: Kommandoer fejler med Authentication expired eller Token invalid.

Doctor-output:

✗ Credentials:     Token expired (last refresh: 2026-03-01)

Løsning: Log ind igen for at opdatere dine legitimationsoplysninger:

freeguard logout
freeguard login --email [email protected] --send-code

Forkert e-mail — intet abonnement fundet

Symptom: Login lykkes, men freeguard connect siger No active subscription.

Doctor-output:

✓ Credentials:     Logged in (email: u***@example.com)
✗ Subscription:    No active subscription found

Løsning: Sørg for, at du logger ind med den samme e-mail, du brugte til at købe dit abonnement. Hvis du brugte en anden e-mail:

freeguard logout
freeguard login --email [email protected] --send-code

Forbindelsesproblemer

Forbindelse timeout

Symptom: freeguard connect hænger eller returnerer Connection timed out.

Doctor-output:

✗ Network:         Internet not reachable

Løsning:

Tjek din grundlæggende internetforbindelse (afbryd VPN først):

freeguard disconnect
ping 8.8.8.8

Prøv en anden node eller et andet land:

freeguard connect --country SG

Prøv en anden protokol, der muligvis fungerer bedre på dit netværk:

freeguard connect --protocol hysteria2

Port 7890 er allerede i brug

Symptom: freeguard connect fejler med Port 7890 is already in use.

Doctor-output:

✗ Port 7890:       In use by another process (PID: 12345)

Løsning: En anden proxy-applikation bruger standardporten. Stop enten den anden applikation, eller skift FreeGuard proxy-porten:

freeguard config set proxy.port 8080
freeguard connect

DNS-læk opdaget

Symptom: DNS-forespørgsler omgår VPN-tunnelen.

Løsning: Skift til en sikker DNS-konfiguration:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Du kan bekræfte, at DNS dirigeres gennem VPN:

freeguard doctor

Se efter DNS-tjekket i outputtet for at bekræfte, at det fungerer korrekt.

Rettighedsproblemer

TUN-tilstand kræver sudo

Symptom: freeguard connect --tun fejler med Permission denied: TUN device.

Doctor-output:

✗ TUN permission:  Not available (run with sudo for TUN mode)

Løsning: TUN-tilstand opretter en virtuel netværksgrænseflade, hvilket kræver forhøjede rettigheder:

# macOS/Linux
sudo freeguard connect --tun

# Windows — run PowerShell as Administrator
freeguard connect --tun

Hvis du ikke har brug for systemdækkende VPN-dækning, kan du bruge standard system proxy-tilstand i stedet (ingen sudo nødvendig):

freeguard connect

Port under 1024 kræver forhøjede rettigheder

Symptom: Indstilling af en proxy-port under 1024 fejler med Permission denied.

Løsning: Porte under 1024 er begrænsede på de fleste operativsystemer. Brug en port over 1024:

freeguard config set proxy.port 7890

Eller kør med forhøjede rettigheder, hvis du specifikt har brug for en lav port:

sudo freeguard connect

Sidder du stadig fast?

Hvis freeguard doctor og løsningerne ovenfor ikke løser dit problem, lad AI diagnosticere det automatisk.

Besøg FreeGuard CLI Agent-siden og beskriv dit problem. Agenten kan læse dit freeguard doctor --json-output og guide dig trin for trin gennem en løsning.

Du kan også køre den interaktive fejlfindingsguide:

freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat

Ofte stillede spørgsmål

Hvorfor siger FreeGuard CLI “connection refused”?

Det betyder normalt, at VPN-serveren er midlertidigt utilgængelig. Prøv freeguard connect --server auto for at vælge den bedste tilgængelige server automatisk, eller tjek dine firewallindstillinger.

Hvordan tjekker jeg, om min VPN-forbindelse fungerer?

Kør freeguard status for at se din forbindelsesstatus, aktuelle server og protokol. Du kan også køre curl ifconfig.me for at bekræfte, at din IP-adresse er ændret.

FreeGuard CLI starter ikke efter systemopdatering. Hvad skal jeg gøre?

Kør freeguard update for at få den nyeste version. Hvis det fejler, geninstaller med installationsscriptet: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Hvordan rapporterer jeg en fejl eller får hjælp?

Kør freeguard debug for at indsamle diagnostisk information, og kontakt derefter support via hjemmesiden eller e-mail. Inkluder debug-outputtet for hurtigere løsning.

Sidst opdateret: marts 2026