FreeGuard CLI probleemoplossing

Problemen met FreeGuard CLI? Deze gids behandelt de meest voorkomende problemen en hun oplossingen. Probeer bij elk probleem eerst freeguard doctor uit te voeren — het detecteert automatisch de meeste configuratie- en omgevingsproblemen.

Installatieproblemen

Toestemming geweigerd tijdens installatie

Symptoom: Het installatiescript mislukt met Permission denied of EACCES.

Oplossing: Op macOS/Linux heeft het installatieprogramma schrijftoegang nodig tot /usr/local/bin. Voer uit met verhoogde rechten:

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

Op Windows, zorg ervoor dat u PowerShell als beheerder opent voordat u de installatieopdracht uitvoert.

Opdracht niet gevonden na installatie

Symptoom: Het uitvoeren van freeguard geeft command not found of not recognized.

Doctor-uitvoer:

✗ CLI binary:     Not in PATH

Oplossing: Het binaire bestand staat mogelijk niet in het PATH van uw shell. Voeg het handmatig toe:

# macOS/Linux — add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="$HOME/.freeguard/bin:$PATH"

# Then reload your shell
source ~/.zshrc  # or ~/.bashrc

Op Windows, voeg %USERPROFILE%\.freeguard\bin toe aan uw systeem PATH-omgevingsvariabele en herstart de terminal.

curl mislukt of download-timeout

Symptoom: Het installatiescript kan het binaire bestand niet downloaden.

Oplossing: Als u achter een bedrijfsfirewall zit of in een beperkt netwerk, download het binaire bestand handmatig van de GitHub Releases-pagina en plaats het in ~/.freeguard/bin/. Maak het vervolgens uitvoerbaar:

chmod +x ~/.freeguard/bin/freeguard

Inlogproblemen

Verificatiecode niet ontvangen

Symptoom: Na het uitvoeren van freeguard login --email [email protected] --send-code komt er geen e-mail aan.

Oplossing:

Controleer uw spam-/ongewenste-postmap — verificatie-e-mails worden soms gefilterd.
Wacht 2 minuten voordat u opnieuw aanvraagt. Er geldt een snelheidslimiet voor het verzenden van codes.
Controleer of het e-mailadres correct is:

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

Probeer een andere e-mailprovider als het probleem aanhoudt.

Token verlopen

Symptoom: Opdrachten mislukken met Authentication expired of Token invalid.

Doctor-uitvoer:

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

Oplossing: Log opnieuw in om uw inloggegevens te vernieuwen:

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

Verkeerd e-mailadres — geen abonnement gevonden

Symptoom: Inloggen lukt, maar freeguard connect meldt No active subscription.

Doctor-uitvoer:

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

Oplossing: Zorg ervoor dat u inlogt met hetzelfde e-mailadres waarmee u uw abonnement hebt aangeschaft. Als u een ander e-mailadres hebt gebruikt:

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

Verbindingsproblemen

Verbinding time-out

Symptoom: freeguard connect hangt of geeft Connection timed out.

Doctor-uitvoer:

✗ Network:         Internet not reachable

Oplossing:

Controleer uw basisinternetverbinding (verbreek eerst de VPN-verbinding):

freeguard disconnect
ping 8.8.8.8

Probeer een ander knooppunt of land:

freeguard connect --country SG

Probeer een ander protocol dat mogelijk beter werkt op uw netwerk:

freeguard connect --protocol hysteria2

Poort 7890 is al in gebruik

Symptoom: freeguard connect mislukt met Port 7890 is already in use.

Doctor-uitvoer:

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

Oplossing: Een andere proxy-applicatie gebruikt de standaardpoort. Stop de andere applicatie of wijzig de FreeGuard proxy-poort:

freeguard config set proxy.port 8080
freeguard connect

DNS-lek gedetecteerd

Symptoom: DNS-query’s omzeilen de VPN-tunnel.

Oplossing: Schakel over naar een veilige DNS-configuratie:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

U kunt verifiëren dat DNS via de VPN wordt gerouteerd:

freeguard doctor

Zoek naar de DNS-controle in de uitvoer om te bevestigen dat het correct werkt.

Rechten problemen

TUN-modus vereist sudo

Symptoom: freeguard connect --tun mislukt met Permission denied: TUN device.

Doctor-uitvoer:

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

Oplossing: TUN-modus maakt een virtuele netwerkinterface aan, waarvoor verhoogde rechten nodig zijn:

# macOS/Linux
sudo freeguard connect --tun

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

Als u geen systeembrede VPN-dekking nodig hebt, gebruik dan de standaard systeemproxy-modus (geen sudo nodig):

freeguard connect

Poort onder 1024 vereist verhoogde rechten

Symptoom: Het instellen van een proxypoort onder 1024 mislukt met Permission denied.

Oplossing: Poorten onder 1024 zijn beperkt op de meeste besturingssystemen. Gebruik een poort boven 1024:

freeguard config set proxy.port 7890

Of voer uit met verhoogde rechten als u specifiek een lage poort nodig hebt:

sudo freeguard connect

Nog steeds vastgelopen?

Als freeguard doctor en de bovenstaande oplossingen uw probleem niet oplossen, laat AI het automatisch diagnosticeren.

Bezoek de FreeGuard CLI Agent-pagina en beschrijf uw probleem. De agent kan uw freeguard doctor --json-uitvoer lezen en u stap voor stap door een oplossing leiden.

U kunt ook de interactieve probleemoplossingswizard uitvoeren:

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

Veelgestelde vragen

Waarom zegt FreeGuard CLI “connection refused”?

Dit betekent meestal dat de VPN-server tijdelijk niet beschikbaar is. Probeer freeguard connect --server auto om automatisch de beste beschikbare server te selecteren, of controleer uw firewall-instellingen.

Hoe controleer ik of mijn VPN-verbinding werkt?

Voer freeguard status uit om uw verbindingsstatus, huidige server en protocol te zien. U kunt ook curl ifconfig.me uitvoeren om te verifiëren dat uw IP-adres is gewijzigd.

FreeGuard CLI start niet na een systeemupdate. Wat moet ik doen?

Voer freeguard update uit om de nieuwste versie te krijgen. Als dat mislukt, installeer opnieuw met het installatiescript: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

Hoe meld ik een bug of krijg ik hulp?

Voer freeguard debug uit om diagnostische informatie te verzamelen en neem vervolgens contact op met ondersteuning via de website of e-mail. Voeg de debug-uitvoer toe voor een snellere oplossing.

Laatst bijgewerkt: maart 2026