FreeGuard CLI Schnellstart

FreeGuard CLI ist ein VPN-Client für die Befehlszeile, der sich mit einem Befehl verbindet. Installieren Sie ihn auf macOS, Linux oder Windows, melden Sie sich mit Ihrer E-Mail an und führen Sie freeguard connect aus, um Ihr Internet in unter 5 Minuten abzusichern.

Installation

macOS und Linux

Mit einem einzigen Befehl installieren:

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

Oder auf macOS Homebrew verwenden:

brew install freeguardvpn/tap/freeguard

Nach der Installation überprüfen Sie, ob alles funktioniert hat:

freeguard version

Erwartete Ausgabe:

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

Windows

Öffnen Sie PowerShell als Administrator und führen Sie aus:

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

Starten Sie nach der Installation Ihr Terminal neu und führen Sie freeguard version aus, um dies zu bestätigen.

Anmeldung

FreeGuard CLI verwendet eine Verifizierung per E-Mail — keine Konto-Registrierung erforderlich.

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

Sie erhalten einen 6-stelligen Verifizierungscode per E-Mail. Geben Sie ihn ein:

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

Beispielausgabe:

✓ Erfolgreich angemeldet!
✓ 1 aktives Abonnement gefunden (Pro Plan, läuft ab 2026-12-01)
✓ Konfiguration erstellt: ~/.freeguard/profiles/default.yaml

Wenn Sie ein FreeGuard-Konto haben, können Sie sich auch über den Browser anmelden:

freeguard login --account

Dies öffnet Ihren Browser für die OAuth-Authentifizierung und gibt automatisch ein Token zurück.

Verbinden

Verbinden Sie sich mit einem Befehl mit dem schnellsten verfügbaren Server:

freeguard connect

Beispielausgabe:

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

Um sich mit einem bestimmten Land zu verbinden:

freeguard connect --country JP

Um sich mit einem bestimmten Knoten zu verbinden:

freeguard connect jp-tok-01

Verifizieren

Prüfen Sie, ob Ihre Verbindung aktiv ist:

freeguard status

Beispielausgabe:

FreeGuard VPN Status
────────────────────
Status:     ● Connected
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)

Um maschinenlesbare Ausgabe zu erhalten (nützlich für Skripting oder KI-Agenten):

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}
}

Nächste Schritte

CLI Commands Reference — Vollständige Liste aller Befehle, Flags und Ausgabeformate.
CLI Troubleshooting — Lösungen für häufige Probleme bei Installation, Anmeldung und Verbindung.
FreeGuard CLI Agent — Lassen Sie KI Probleme für Sie automatisch diagnostizieren und beheben.
Führen Sie freeguard --help aus, um alle verfügbaren Befehle in Ihrem Terminal zu entdecken.

Häufig gestellte Fragen

Wie installiere ich FreeGuard CLI auf meinem System?

Führen Sie curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh auf macOS oder Linux aus. Auf macOS können Sie auch brew install freeguard verwenden. Das Installationsprogramm erkennt Ihr Betriebssystem und Ihre Architektur automatisch.

Kann ich FreeGuard CLI ohne GUI verwenden?

Ja. FreeGuard CLI ist vollständig headless — es läuft komplett im Terminal, ohne dass eine grafische Oberfläche erforderlich ist. Das macht es ideal für Server, Container und entfernte SSH-Sitzungen.

Wie wechsle ich VPN-Protokolle mit der CLI?

Verwenden Sie freeguard connect --protocol <name>. Unterstützte Protokolle sind Hysteria2, Anytls und Trojan. Die CLI verwendet standardmäßig das schnellste verfügbare Protokoll für Ihr Netzwerk.

Funktioniert FreeGuard CLI auf ARM-Geräten wie Raspberry Pi?

Ja. Die CLI unterstützt die Architekturen arm64 und armv7. Das Installationsskript erkennt Ihre Plattform automatisch und lädt die richtige Binärdatei herunter.

Zuletzt aktualisiert: März 2026