FreeGuard CLI-Befehlsreferenz

FreeGuard CLI bietet einen vollständigen Satz von Befehlen, um Ihre VPN-Verbindung, Ihr Abonnement und Ihre Konfiguration direkt über das Terminal zu verwalten. Jeder Befehl unterstützt --json-Ausgabe für Scripting und die Integration von KI-Agenten.

Globale Flags

Diese Flags funktionieren mit jedem Befehl:

Flag	Beschreibung
`--json`	Ausgabe im JSON-Format (agentenfreundlich)
`--quiet`, `-q`	Stiller Modus, nur Ergebnisse ausgeben
`--verbose`, `-v`	Ausführliche Ausgabe mit Debug-Informationen
`--no-color`	Farbige Ausgabe deaktivieren
`--lang <code>`	Sprache der Benutzeroberfläche (`auto`, `en`, `zh`, `ja`, etc.)
`--config <path>`	Eine bestimmte Konfigurationsdatei verwenden

Verbindung

`freeguard connect`

Mit einem VPN-Server verbinden. Ohne Argumente wird automatisch der schnellste verfügbare Knoten ausgewählt.

# Automatisch mit dem besten Server verbinden
freeguard connect

# Mit einem bestimmten Knoten anhand der ID verbinden
freeguard connect us-new-01

# Mit dem besten Server in einem Land verbinden
freeguard connect --country JP

# Ein bestimmtes Protokoll verwenden
freeguard connect --protocol anytls

# TUN Mode aktivieren (erfordert sudo/admin)
freeguard connect --tun

Menschenlesbare Ausgabe:

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

JSON-Ausgabe:

freeguard connect --json

{"status": "connected", "node": "us-new-01", "protocol": "anytls", "latency_ms": 42}

Flags:

Flag	Beschreibung
`--country <code>`	Mit dem besten Knoten in diesem Land verbinden (ISO 3166-1 alpha-2)
`--protocol <name>`	Bevorzugtes Protokoll (`anytls`, `hysteria2`, `vless`, etc.)
`--tun`	TUN Mode für systemweites VPN verwenden (erfordert erhöhte Berechtigungen)

`freeguard disconnect`

Die Verbindung zum aktuellen VPN-Server trennen.

freeguard disconnect

✓ Getrennt

freeguard disconnect --json

{"status": "disconnected"}

`freeguard status`

Den aktuellen Verbindungsstatus und die Traffic-Statistiken anzeigen.

freeguard status

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

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

Authentifizierung

`freeguard login`

Bei FreeGuard authentifizieren. Unterstützt E-Mail-Verifizierung (kein Konto erforderlich) oder die Anmeldung mit einem FreeGuard-Konto.

E-Mail-Anmeldung (empfohlen):

# Schritt 1: Verifizierungscode anfordern
freeguard login --email [email protected] --send-code

# Schritt 2: Code eingeben
freeguard login --email [email protected] --code 123456

✓ Erfolgreich angemeldet!
✓ 1 aktives Abonnement gefunden (Pro Plan, läuft ab 2026-12-01)

Konto-Anmeldung (öffnet den Browser):

freeguard login --account

Flags:

Flag	Beschreibung
`--email <address>`	Mit E-Mail-Verifizierung anmelden
`--send-code`	Verifizierungscode per E-Mail senden
`--code <digits>`	Den 6-stelligen Verifizierungscode übermitteln
`--account`	Mit FreeGuard-Konto über Browser-OAuth anmelden

`freeguard logout`

Gespeicherte Anmeldedaten löschen und die Verbindung trennen, falls derzeit verbunden.

freeguard logout

✓ Abgemeldet. Anmeldedaten gelöscht.

Abonnement

`freeguard subscribe list`

Verfügbare Abonnementpläne und Ihren aktuellen Abonnementstatus anzeigen.

freeguard subscribe list

Ihr Abonnement
──────────────
Plan:       Pro
Status:     Aktiv
Läuft ab:   2026-12-01
Traffic:    450 GB / Unbegrenzt

Verfügbare Pläne
────────────────
Plan        Monatlich   Quartalsweise   Jährlich
Basic       $4.99       $12.99          $39.99
Pro         $9.99       $24.99          $79.99

freeguard subscribe list --json

{
  "current": {"plan": "pro", "status": "active", "expires": "2026-12-01"},
  "plans": [
    {"name": "basic", "prices": {"monthly": 4.99, "quarterly": 12.99, "annual": 39.99}},
    {"name": "pro", "prices": {"monthly": 9.99, "quarterly": 24.99, "annual": 79.99}}
  ]
}

`freeguard subscribe create`

Ein neues Abonnement erstellen. Öffnet Ihren Browser, um die Zahlung über Stripe oder Kryptowährung abzuschließen.

# Interaktive Planauswahl
freeguard subscribe create

# Plan direkt angeben
freeguard subscribe create --plan pro --email [email protected]

Flags:

Flag	Beschreibung
`--plan <name>`	Abonnementplan (`basic`, `pro`)
`--email <address>`	E-Mail für die Zustellung des Abonnements

Konfiguration

`freeguard config get`

Einen Konfigurationswert auslesen.

freeguard config get proxy.port

freeguard config get proxy.port --json

{"key": "proxy.port", "value": 7890}

`freeguard config set`

Einen Konfigurationswert ändern.

freeguard config set proxy.port 8080

✓ proxy.port auf 8080 gesetzt

Gängige Konfigurationsschlüssel:

Key	Standard	Beschreibung
`proxy.port`	`7890`	HTTP/SOCKS5-Proxy-Port
`proxy.mode`	`rule`	Proxy-Modus: `rule`, `global`, `direct`
`core.api_port`	`9090`	Mihomo-API-Port
`core.pinned_version`	(leer)	Mihomo auf eine bestimmte Version festlegen
`dns.provider`	`auto`	DNS-Anbieter
`update.auto_check`	`true`	Beim Start nach Updates suchen

`freeguard config edit`

Die Konfigurationsdatei in Ihrem Standard-Editor öffnen.

freeguard config edit

Diagnose

`freeguard doctor`

Eine umfassende Umgebungsprüfung ausführen, um Probleme zu diagnostizieren.

freeguard doctor

FreeGuard Environment Check
───────────────────────────
✓ OS:              macOS 15.2 (arm64)
✓ CLI version:     v1.0.0
✓ Core version:    mihomo v1.19.21
✓ Config dir:      ~/.freeguard/
✓ Credentials:     Eingeloggt (email: u***@example.com)
✓ Subscription:    Aktiv (läuft ab 2026-12-01)
✓ Network:         Internet erreichbar
✓ DNS:             Funktioniert (8.8.8.8)
✗ TUN permission:  Nicht verfügbar (für TUN Mode mit sudo ausführen)
✓ Port 7890:       Verfügbar
✓ GeoIP database:  Auf dem neuesten Stand (2026-03-15)

Result: 10/11 checks passed. TUN mode requires elevated privileges.

freeguard doctor --json

{
  "checks": [
    {"name": "os", "status": "pass", "detail": "macOS 15.2 (arm64)"},
    {"name": "cli_version", "status": "pass", "detail": "v1.0.0"},
    {"name": "tun_permission", "status": "fail", "detail": "Not available (run with sudo)"}
  ],
  "passed": 10,
  "total": 11
}

`freeguard version`

Versionsinformationen für die CLI und die Core-Engine anzeigen.

freeguard version

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

freeguard version --json

{"cli": "1.0.0", "core": "1.19.21", "os": "darwin", "arch": "arm64"}

Erweitert (Phase 2+)

Die folgenden Befehle sind für zukünftige Releases geplant.

`freeguard node list`

Verfügbare VPN-Knoten mit Filter- und Sortierfunktionen auflisten.

freeguard node list
freeguard node list --country US --sort latency

Flags:

Flag	Beschreibung
`--country <code>`	Nach Ländercode filtern
`--protocol <name>`	Nach Protokoll filtern
`--sort <field>`	Nach `speed`, `latency` oder `load` sortieren

`freeguard node test`

Latenz und Geschwindigkeit von Knoten testen.

freeguard node test us-new-01
freeguard node test --all

`freeguard monitor`

Echtzeit-Traffic-Überwachung in Ihrem Terminal anzeigen.

freeguard monitor

↑ 0.8 MB/s  ↓ 12.3 MB/s  Connections: 47

`freeguard core`

Verwaltet die zugrunde liegende mihomo-Engine.

# Check core status
freeguard core status

# Update to latest core version
freeguard core update

# Restart the core engine
freeguard core restart

`freeguard shell`

Wechselt in den interaktiven REPL-Modus, um mehrere Befehle in einer Sitzung auszuführen.

freeguard shell

`freeguard dashboard`

Öffnet das TUI-Dashboard mit Echtzeit-Verkehrsdiagrammen, der Knotenliste und Verbindungsdetails.

freeguard dashboard

Zuletzt aktualisiert: März 2026