Αναφορά Εντολών FreeGuard CLI

Το FreeGuard CLI παρέχει ένα πλήρες σύνολο εντολών για τη διαχείριση της VPN σύνδεσής σας, της συνδρομής και της διαμόρφωσης από το τερματικό. Κάθε εντολή υποστηρίζει έξοδο --json για scripting και ενσωμάτωση AI agent.

Καθολικές Σημαίες

Αυτές οι σημαίες λειτουργούν με οποιαδήποτε εντολή:

Flag	Description
`--json`	Έξοδος σε μορφή JSON (φιλική προς agent)
`--quiet`, `-q`	Αθόρυβη λειτουργία, μόνο έξοδος αποτελεσμάτων
`--verbose`, `-v`	Αναλυτική έξοδος με πληροφορίες debug
`--no-color`	Απενεργοποίηση έγχρωμης εξόδου
`--lang <code>`	Γλώσσα διεπαφής (`auto`, `en`, `zh`, `ja`, κ.λπ.)
`--config <path>`	Χρήση συγκεκριμένου αρχείου διαμόρφωσης

Σύνδεση

`freeguard connect`

Σύνδεση σε έναν διακομιστή VPN. Χωρίς ορίσματα, επιλέγει αυτόματα τον ταχύτερο διαθέσιμο node.

# Auto-connect to the best server
freeguard connect

# Connect to a specific node by ID
freeguard connect us-new-01

# Connect to the best server in a country
freeguard connect --country JP

# Use a specific protocol
freeguard connect --protocol anytls

# Enable TUN mode (requires sudo/admin)
freeguard connect --tun

Έξοδος αναγνώσιμη από άνθρωπο:

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

Έξοδος JSON:

freeguard connect --json

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

Flags:

Flag	Description
`--country <code>`	Σύνδεση στον καλύτερο node σε αυτή τη χώρα (ISO 3166-1 alpha-2)
`--protocol <name>`	Προτιμώμενο πρωτόκολλο (`anytls`, `hysteria2`, `vless`, κ.λπ.)
`--tun`	Χρήση TUN mode για VPN σε επίπεδο συστήματος (απαιτεί αυξημένα δικαιώματα)

`freeguard disconnect`

Αποσύνδεση από τον τρέχοντα διακομιστή VPN.

freeguard disconnect

✓ Disconnected

freeguard disconnect --json

{"status": "disconnected"}

`freeguard status`

Εμφάνιση της τρέχουσας κατάστασης σύνδεσης και των στατιστικών κίνησης.

freeguard status

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)

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

Πιστοποίηση

`freeguard login`

Πιστοποίηση με το FreeGuard. Υποστηρίζει επιβεβαίωση μέσω email (δεν απαιτείται λογαριασμός) ή σύνδεση με λογαριασμό FreeGuard.

Σύνδεση μέσω email (προτείνεται):

# Step 1: Request verification code
freeguard login --email [email protected] --send-code

# Step 2: Enter the code
freeguard login --email [email protected] --code 123456

✓ Logged in successfully!
✓ Found 1 active subscription (Pro Plan, expires 2026-12-01)

Σύνδεση με λογαριασμό (ανοίγει browser):

freeguard login --account

Flags:

Flag	Description
`--email <address>`	Σύνδεση με επιβεβαίωση μέσω email
`--send-code`	Αποστολή κωδικού επιβεβαίωσης στο email
`--code <digits>`	Υποβολή του 6ψήφιου κωδικού επιβεβαίωσης
`--account`	Σύνδεση με λογαριασμό FreeGuard μέσω browser OAuth

`freeguard logout`

Διαγραφή των αποθηκευμένων διαπιστευτηρίων και αποσύνδεση αν υπάρχει ενεργή σύνδεση.

freeguard logout

✓ Logged out. Credentials cleared.

Συνδρομή

`freeguard subscribe list`

Προβολή των διαθέσιμων προγραμμάτων συνδρομής και της τρέχουσας κατάστασης συνδρομής σας.

freeguard subscribe list

Your Subscription
─────────────────
Plan:       Pro
Status:     Active
Expires:    2026-12-01
Traffic:    450 GB / Unlimited

Available Plans
───────────────
Plan        Monthly   Quarterly   Annual
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`

Δημιουργία νέας συνδρομής. Ανοίγει τον browser σας για ολοκλήρωση της πληρωμής μέσω Stripe ή κρυπτονομίσματος.

# Interactive plan selection
freeguard subscribe create

# Specify plan directly
freeguard subscribe create --plan pro --email [email protected]

Flags:

Flag	Description
`--plan <name>`	Πρόγραμμα συνδρομής (`basic`, `pro`)
`--email <address>`	Email για παράδοση της συνδρομής

Διαμόρφωση

`freeguard config get`

Ανάγνωση μιας τιμής διαμόρφωσης.

freeguard config get proxy.port

freeguard config get proxy.port --json

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

`freeguard config set`

Αλλαγή μιας τιμής διαμόρφωσης.

freeguard config set proxy.port 8080

✓ proxy.port set to 8080

Συνηθισμένα κλειδιά διαμόρφωσης:

Key	Default	Description
`proxy.port`	`7890`	Θύρα HTTP/SOCKS5 proxy
`proxy.mode`	`rule`	Λειτουργία Proxy: `rule`, `global`, `direct`
`core.api_port`	`9090`	Θύρα API του Mihomo
`core.pinned_version`	(empty)	Καρφίτσωμα του mihomo σε συγκεκριμένη έκδοση
`dns.provider`	`auto`	Πάροχος DNS
`update.auto_check`	`true`	Έλεγχος για ενημερώσεις κατά την εκκίνηση

`freeguard config edit`

Άνοιγμα του αρχείου διαμόρφωσης στον προεπιλεγμένο επεξεργαστή σας.

freeguard config edit

Διαγνωστικά

`freeguard doctor`

Εκτέλεση ολοκληρωμένου ελέγχου περιβάλλοντος για διάγνωση προβλημάτων.

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:     Logged in (email: u***@example.com)
✓ Subscription:    Active (expires 2026-12-01)
✓ Network:         Internet reachable
✓ DNS:             Working (8.8.8.8)
✗ TUN permission:  Not available (run with sudo for TUN mode)
✓ Port 7890:       Available
✓ GeoIP database:  Up to date (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`

Εμφάνιση πληροφοριών έκδοσης για το CLI και τον core engine.

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

Προχωρημένα (Phase 2+)

Οι ακόλουθες εντολές προγραμματίζονται για μελλοντικές εκδόσεις.

`freeguard node list`

Λίστα των διαθέσιμων VPN nodes με φιλτράρισμα και ταξινόμηση.

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

Flags:

Flag	Description
`--country <code>`	Φιλτράρισμα με βάση τον κωδικό χώρας
`--protocol <name>`	Φιλτράρισμα με βάση το πρωτόκολλο
`--sort <field>`	Ταξινόμηση κατά `speed`, `latency` ή `load`

`freeguard node test`

Έλεγχος καθυστέρησης και ταχύτητας των nodes.

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

`freeguard monitor`

Εμφάνιση παρακολούθησης κίνησης σε πραγματικό χρόνο στο τερματικό σας.

freeguard monitor

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

`freeguard core`

Διαχείριση του υποκείμενου μηχανισμού mihomo.

# Check core status
freeguard core status

# Update to latest core version
freeguard core update

# Restart the core engine
freeguard core restart

`freeguard shell`

Είσοδος σε διαδραστική λειτουργία REPL για εκτέλεση πολλαπλών εντολών σε μία συνεδρία.

freeguard shell

`freeguard dashboard`

Ανοίξτε το TUI dashboard με γραφήματα κίνησης σε πραγματικό χρόνο, λίστα κόμβων και λεπτομέρειες σύνδεσης.

freeguard dashboard

Τελευταία ενημέρωση: March 2026