FreeGuard CLI Komutları Referansı

FreeGuard CLI, VPN bağlantınızı, aboneliğinizi ve yapılandırmanızı terminalden yönetmek için eksiksiz bir komut seti sağlar. Her komut, betik yazımı ve AI ajan entegrasyonu için --json çıktısını destekler.

Genel Bayraklar

Bu bayraklar herhangi bir komutla çalışır:

Bayrak	Açıklama
`--json`	JSON biçiminde çıktı verir (ajan dostu)
`--quiet`, `-q`	Sessiz mod, yalnızca sonuçları çıktılar
`--verbose`, `-v`	Hata ayıklama bilgileriyle ayrıntılı çıktı
`--no-color`	Renkli çıktıyı devre dışı bırakır
`--lang <code>`	Arayüz dili (`auto`, `en`, `zh`, `ja`, vb.)
`--config <path>`	Belirli bir yapılandırma dosyası kullanır

Bağlantı

`freeguard connect`

Bir VPN sunucusuna bağlanır. Argüman olmadan, otomatik olarak kullanılabilir en hızlı düğümü seçer.

# En iyi sunucuya otomatik bağlan
freeguard connect

# ID ile belirli bir düğüme bağlan
freeguard connect us-new-01

# Bir ülkedeki en iyi sunucuya bağlan
freeguard connect --country JP

# Belirli bir protokol kullan
freeguard connect --protocol anytls

# TUN mode'u etkinleştir (sudo/admin gerekir)
freeguard connect --tun

İnsan tarafından okunabilir çıktı:

✓ United States - New York (us-new-01) ile bağlantı kuruldu
  Protocol: anytls | Latency: 42ms
  Proxy: 127.0.0.1:7890 (HTTP/SOCKS5)

JSON çıktısı:

freeguard connect --json

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

Bayraklar:

Bayrak	Açıklama
`--country <code>`	Bu ülkedeki en iyi düğüme bağlanır (ISO 3166-1 alpha-2)
`--protocol <name>`	Tercih edilen protokol (`anytls`, `hysteria2`, `vless`, vb.)
`--tun`	Sistem genelinde VPN için TUN mode kullanır (yükseltilmiş ayrıcalıklar gerekir)

`freeguard disconnect`

Mevcut VPN sunucusundan bağlantıyı keser.

freeguard disconnect

✓ Bağlantı kesildi

freeguard disconnect --json

{"status": "disconnected"}

`freeguard status`

Geçerli bağlantı durumunu ve trafik istatistiklerini gösterir.

freeguard status

FreeGuard VPN Durumu
────────────────────
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}
}

Kimlik Doğrulama

`freeguard login`

FreeGuard ile kimlik doğrular. E-posta doğrulamasını (hesap gerekmez) veya FreeGuard hesabı ile oturum açmayı destekler.

E-posta ile giriş (önerilir):

# Adım 1: Doğrulama kodu iste
freeguard login --email [email protected] --send-code

# Adım 2: Kodu gir
freeguard login --email [email protected] --code 123456

✓ Başarıyla giriş yapıldı!
✓ 1 aktif abonelik bulundu (Pro Plan, expires 2026-12-01)

Hesap ile giriş (tarayıcı açar):

freeguard login --account

Bayraklar:

Bayrak	Açıklama
`--email <address>`	E-posta doğrulaması ile giriş yapar
`--send-code`	Doğrulama kodunu e-postaya gönderir
`--code <digits>`	6 haneli doğrulama kodunu gönderir
`--account`	Tarayıcı OAuth üzerinden FreeGuard hesabı ile giriş yapar

`freeguard logout`

Depolanan kimlik bilgilerini temizler ve bağlıysa bağlantıyı keser.

freeguard logout

✓ Oturum kapatıldı. Kimlik bilgileri temizlendi.

Abonelik

`freeguard subscribe list`

Mevcut abonelik planlarını ve geçerli abonelik durumunuzu görüntüler.

freeguard subscribe list

Aboneliğiniz
─────────────
Plan:       Pro
Status:     Active
Expires:    2026-12-01
Traffic:    450 GB / Unlimited

Mevcut Planlar
───────────────
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`

Yeni bir abonelik oluşturur. Stripe veya kripto para ile ödemeyi tamamlamak için tarayıcınızı açar.

# Etkileşimli plan seçimi
freeguard subscribe create

# Planı doğrudan belirt
freeguard subscribe create --plan pro --email [email protected]

Bayraklar:

Bayrak	Açıklama
`--plan <name>`	Abonelik planı (`basic`, `pro`)
`--email <address>`	Abonelik teslimatı için e-posta

Yapılandırma

`freeguard config get`

Bir yapılandırma değerini okur.

freeguard config get proxy.port

freeguard config get proxy.port --json

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

`freeguard config set`

Bir yapılandırma değerini değiştirir.

freeguard config set proxy.port 8080

✓ proxy.port 8080 olarak ayarlandı

Yaygın yapılandırma anahtarları:

Key	Default	Açıklama
`proxy.port`	`7890`	HTTP/SOCKS5 proxy portu
`proxy.mode`	`rule`	Proxy modu: `rule`, `global`, `direct`
`core.api_port`	`9090`	Mihomo API portu
`core.pinned_version`	(empty)	Mihomo’yu belirli bir sürüme sabitler
`dns.provider`	`auto`	DNS sağlayıcısı
`update.auto_check`	`true`	Başlangıçta güncellemeleri kontrol eder

`freeguard config edit`

Yapılandırma dosyasını varsayılan düzenleyicinizde açar.

freeguard config edit

Tanılama

`freeguard doctor`

Sorunları teşhis etmek için kapsamlı bir ortam kontrolü çalıştırır.

freeguard doctor

FreeGuard Ortam Kontrolü
───────────────────────────
✓ OS:              macOS 15.2 (arm64)
✓ CLI version:     v1.0.0
✓ Core version:    mihomo v1.19.21
✓ Config dir:      ~/.freeguard/
✓ Credentials:     Giriş yapılmış (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 ve core engine için sürüm bilgilerini gösterir.

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

Gelişmiş (Phase 2+)

Aşağıdaki komutlar gelecekteki sürümler için planlanmıştır.

`freeguard node list`

Filtreleme ve sıralama ile mevcut VPN düğümlerini listeler.

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

Bayraklar:

Bayrak	Açıklama
`--country <code>`	Ülke koduna göre filtreler
`--protocol <name>`	Protokole göre filtreler
`--sort <field>`	`speed`, `latency` veya `load` alanına göre sıralar

`freeguard node test`

Düğümlerin gecikme süresini ve hızını test eder.

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

`freeguard monitor`

Terminalinizde gerçek zamanlı trafik izleme gösterir.

freeguard monitor

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

`freeguard core`

Alttaki mihomo motorunu yönetin.

# Check core status
freeguard core status

# Update to latest core version
freeguard core update

# Restart the core engine
freeguard core restart

`freeguard shell`

Bir oturumda birden fazla komut çalıştırmak için etkileşimli REPL moduna girin.

freeguard shell

`freeguard dashboard`

Gerçek zamanlı trafik grafikleri, düğüm listesi ve bağlantı ayrıntılarıyla TUI gösterge panelini açın.

freeguard dashboard

Son güncelleme: March 2026