FreeGuard CLI Snelle Start

FreeGuard CLI is een VPN-client voor de commandoregel die met één opdracht verbinding maakt. Installeer het op macOS, Linux of Windows, log in met je e-mailadres en voer freeguard connect uit om je internet binnen 5 minuten te beveiligen.

Installatie

macOS en Linux

Installeer met één opdracht:

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

Of gebruik Homebrew op macOS:

brew install freeguardvpn/tap/freeguard

Controleer na installatie of het gelukt is:

freeguard version

Verwachte uitvoer:

FreeGuard CLI v1.0.0
Core: mihomo v1.19.21
OS: darwin/arm64

Windows

Open PowerShell als Administrator en voer uit:

irm https://downloadcli.freeguardvpn.com/cli/install.ps1 | iex

Start na installatie je terminal opnieuw en voer freeguard version uit om te bevestigen.

Inloggen

FreeGuard CLI gebruikt verificatie via e-mail — geen accountregistratie vereist.

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

Je ontvangt een verificatiecode van 6 cijfers op je e-mailadres. Voer deze in:

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

Voorbeeld uitvoer:

✓ Succesvol ingelogd!
✓ 1 actief abonnement gevonden (Pro Plan, verloopt 2026-12-01)
✓ Configuratie gegenereerd: ~/.freeguard/profiles/default.yaml

Als je een FreeGuard-account hebt, kun je ook via de browser inloggen:

freeguard login --account

Dit opent je browser voor OAuth-authenticatie en retourneert automatisch een token.

Verbinden

Maak met één opdracht verbinding met de snelste beschikbare server:

freeguard connect

Voorbeeld uitvoer:

✓ Verbonden met United States - New York (us-new-01)
  Protocol: anytls | Latency: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

Om verbinding te maken met een specifiek land:

freeguard connect --country JP

Om verbinding te maken met een specifieke node:

freeguard connect jp-tok-01

Verifiëren

Controleer of je verbinding actief is:

freeguard status

Voorbeeld uitvoer:

FreeGuard VPN Status
────────────────────
Status:     ● Verbonden
Node:       United States - New York (us-new-01)
Protocol:   anytls
Latency:    42ms
Upload:     1.2 MB/s
Download:   15.8 MB/s
Duration:   2h 15m
Mode:       System Proxy (HTTP/SOCKS5)

Voor machineleesbare uitvoer (handig voor scripting of AI-agents):

freeguard status --json

{
  "connected": true,
  "node": {"id": "us-new-01", "name": "United States - New York", "country": "US"},
  "protocol": "anytls",
  "latency_ms": 42,
  "traffic": {"upload_bps": 1258291, "download_bps": 16569754},
  "duration_seconds": 8100,
  "mode": "system_proxy",
  "proxy_port": {"mixed": 7890}
}

Volgende stappen

• CLI Commands Reference — Volledige lijst met alle opdrachten, vlaggen en uitvoerformaten.
• CLI Troubleshooting — Oplossingen voor veelvoorkomende installatie-, inlog- en verbindingsproblemen.
• FreeGuard CLI Agent — Laat AI problemen automatisch voor je diagnosticeren en oplossen.
• Voer freeguard --help uit om alle beschikbare opdrachten in je terminal te verkennen.

Veelgestelde vragen

Hoe installeer ik FreeGuard CLI op mijn systeem?

Voer curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh uit op macOS of Linux. Op macOS kun je ook brew install freeguard gebruiken. Het installatieprogramma detecteert automatisch je OS en architectuur.

Kan ik FreeGuard CLI zonder GUI gebruiken?

Ja. FreeGuard CLI is volledig headless — het draait volledig in de terminal zonder grafische interface. Dit maakt het ideaal voor servers, containers en externe SSH-sessies.

Hoe schakel ik VPN-protocollen met de CLI?

Gebruik freeguard connect --protocol <name>. Ondersteunde protocollen zijn onder andere Hysteria2, Anytls en Trojan. De CLI gebruikt standaard het snelste beschikbare protocol voor je netwerk.

Werkt FreeGuard CLI op ARM-apparaten zoals Raspberry Pi?

Ja. De CLI ondersteunt arm64- en armv7-architecturen. Het installatiescript detecteert automatisch je platform en downloadt de juiste binary.

Laatst bijgewerkt: maart 2026