FreeGuard VPN
HemVPN-noderPrissättning
FreeGuard CLI felsökning
Har du problem med FreeGuard CLI? Den här guiden täcker de vanligaste problemen och deras lösningar. För varje problem, försök köra `freeguard doctor` först — den upptäcker automatiskt de flesta konfigurations- och miljöproblem.
Innehållsförteckning

FreeGuard CLI felsökning

Har du problem med FreeGuard CLI? Den här guiden täcker de vanligaste problemen och deras lösningar. För varje problem, försök köra freeguard doctor först — den upptäcker automatiskt de flesta konfigurations- och miljöproblem.

Installationsproblem

Åtkomst nekad under installation

Symptom: Installationsskriptet misslyckas med Permission denied eller EACCES.

Lösning: På macOS/Linux behöver installationsprogrammet skrivåtkomst till /usr/local/bin. Kör med förhöjda rättigheter:

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

På Windows, se till att du öppnar PowerShell som administratör innan du kör installationskommandot.

Kommandot hittades inte efter installation

Symptom: Att köra freeguard returnerar command not found eller not recognized.

Doctor-utdata:

✗ CLI binary:     Not in PATH

Lösning: Den binära filen kanske inte finns i ditt skals PATH. Lägg till den manuellt:

# 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, lägg till %USERPROFILE%\.freeguard\bin i systemets PATH-miljövariabel och starta om terminalen.

curl misslyckas eller nedladdningen tar timeout

Symptom: Installationsskriptet kan inte ladda ner den binära filen.

Lösning: Om du befinner dig bakom en företagsbrandvägg eller i ett begränsat nätverk, ladda ner den binära filen manuellt från GitHub Releases-sidan och placera den i ~/.freeguard/bin/. Gör den sedan körbar:

chmod +x ~/.freeguard/bin/freeguard

Inloggningsproblem

Verifieringskod inte mottagen

Symptom: Efter att ha kört freeguard login --email [email protected] --send-code kommer inget e-postmeddelande.

Lösning:

  1. Kontrollera din skräppost/spam-mapp — verifieringsmeddelanden filtreras ibland.
  2. Vänta 2 minuter innan du begär igen. Det finns en hastighetsbegränsning för kodsändning.
  3. Bekräfta att e-postadressen är korrekt:
freeguard login --email [email protected] --send-code
  1. Prova en annan e-postleverantör om problemet kvarstår.

Token har gått ut

Symptom: Kommandon misslyckas med Authentication expired eller Token invalid.

Doctor-utdata:

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

Lösning: Logga in igen för att uppdatera dina autentiseringsuppgifter:

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

Fel e-post — prenumeration hittades inte

Symptom: Inloggningen lyckas men freeguard connect säger No active subscription.

Doctor-utdata:

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

Lösning: Se till att du loggar in med samma e-post som du använde för att köpa din prenumeration. Om du använde en annan e-post:

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

Anslutningsproblem

Anslutningstimeout

Symptom: freeguard connect hänger sig eller returnerar Connection timed out.

Doctor-utdata:

✗ Network:         Internet not reachable

Lösning:

  1. Kontrollera din grundläggande internetanslutning (koppla bort VPN först):
freeguard disconnect
ping 8.8.8.8
  1. Prova en annan nod eller ett annat land:
freeguard connect --country SG
  1. Prova ett annat protokoll som kanske fungerar bättre i ditt nätverk:
freeguard connect --protocol hysteria2

Port 7890 används redan

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

Doctor-utdata:

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

Lösning: En annan proxyapplikation använder standardporten. Stoppa den andra applikationen eller ändra FreeGuard-proxyporten:

freeguard config set proxy.port 8080
freeguard connect

DNS-läcka upptäckt

Symptom: DNS-frågor kringgår VPN-tunneln.

Lösning: Byt till en säker DNS-konfiguration:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

Du kan verifiera att DNS dirigeras genom VPN:

freeguard doctor

Leta efter DNS-kontrollen i utdata för att bekräfta att den fungerar korrekt.

Behörighetsproblem

TUN-läge kräver sudo

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

Doctor-utdata:

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

Lösning: TUN-läge skapar ett virtuellt nätverksgränssnitt, vilket kräver förhöjda rättigheter:

# macOS/Linux
sudo freeguard connect --tun

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

Om du inte behöver systemomfattande VPN-täckning, använd standardläget för systemproxy (sudo behövs inte):

freeguard connect

Port under 1024 kräver förhöjda rättigheter

Symptom: Att ställa in en proxyport under 1024 misslyckas med Permission denied.

Lösning: Portar under 1024 är begränsade på de flesta operativsystem. Använd en port över 1024:

freeguard config set proxy.port 7890

Eller kör med förhöjda rättigheter om du specifikt behöver en låg port:

sudo freeguard connect

Fortfarande fastlåst?

Om freeguard doctor och lösningarna ovan inte löser ditt problem, låt AI diagnostisera det automatiskt.

Besök FreeGuard CLI Agent-sidan och beskriv ditt problem. Agenten kan läsa din freeguard doctor --json-utdata och guida dig steg för steg mot en lösning.

Du kan också köra den interaktiva felsökningsguiden:

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

Vanliga frågor

Varför säger FreeGuard CLI “connection refused”?

Detta betyder vanligtvis att VPN-servern är tillfälligt otillgänglig. Prova freeguard connect --server auto för att automatiskt välja den bästa tillgängliga servern, eller kontrollera dina brandväggsinställningar.

Hur kontrollerar jag om min VPN-anslutning fungerar?

Kör freeguard status för att se din anslutningsstatus, aktuell server och protokoll. Du kan också köra curl ifconfig.me för att verifiera att din IP-adress har ändrats.

FreeGuard CLI startar inte efter systemuppdatering. Vad ska jag göra?

Kör freeguard update för att hämta den senaste versionen. Om det misslyckas, installera om med installationsskriptet: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Hur rapporterar jag en bugg eller får hjälp?

Kör freeguard debug för att samla in diagnostisk information och kontakta sedan supporten via webbplatsen eller e-post. Inkludera debug-utdata för snabbare lösning.

Senast uppdaterad: mars 2026