شروع سریع FreeGuard CLI

FreeGuard CLI یک کلاینت VPN خط فرمان است که با یک دستور متصل می‌شود. آن را روی macOS، Linux یا Windows نصب کنید، با ایمیل خود وارد شوید، و freeguard connect را اجرا کنید تا اینترنت خود را در کمتر از 5 دقیقه ایمن کنید.

نصب

macOS و Linux

با یک دستور نصب کنید:

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

یا در macOS از Homebrew استفاده کنید:

brew install freeguardvpn/tap/freeguard

پس از نصب، بررسی کنید که درست کار کرده است:

freeguard version

خروجی مورد انتظار:

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

Windows

PowerShell را به‌صورت Administrator باز کنید و اجرا کنید:

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

پس از نصب، ترمینال خود را دوباره راه‌اندازی کنید و برای تأیید freeguard version را اجرا کنید.

ورود

FreeGuard CLI از تأیید هویت مبتنی بر ایمیل استفاده می‌کند — نیازی به ثبت‌نام حساب نیست.

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

یک کد تأیید 6 رقمی در ایمیل شما دریافت خواهد شد. آن را وارد کنید:

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

نمونه خروجی:

✓ با موفقیت وارد شدید!
✓ 1 اشتراک فعال یافت شد (Pro Plan, expires 2026-12-01)
✓ پیکربندی ایجاد شد: ~/.freeguard/profiles/default.yaml

اگر حساب FreeGuard دارید، می‌توانید از طریق مرورگر نیز وارد شوید:

freeguard login --account

این کار مرورگر شما را برای احراز هویت OAuth باز می‌کند و به‌صورت خودکار یک token برمی‌گرداند.

اتصال

با یک دستور به سریع‌ترین سرورِ در دسترس متصل شوید:

freeguard connect

نمونه خروجی:

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

برای اتصال به یک کشور مشخص:

freeguard connect --country JP

برای اتصال به یک node مشخص:

freeguard connect jp-tok-01

تأیید

بررسی کنید که اتصال شما فعال است:

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)

برای دریافت خروجی قابل‌خواندن توسط ماشین (مفید برای اسکریپت‌نویسی یا agentهای AI):

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

مراحل بعدی

CLI Commands Reference — فهرست کامل همه دستورها، flagها و قالب‌های خروجی.
CLI Troubleshooting — راه‌حل‌هایی برای مشکلات رایج نصب، ورود و اتصال.
FreeGuard CLI Agent — اجازه دهید AI مشکلات را برای شما به‌صورت خودکار تشخیص دهد و برطرف کند.
freeguard --help را اجرا کنید تا همه دستورهای موجود را از ترمینال خود بررسی کنید.

پرسش‌های متداول

چگونه FreeGuard CLI را روی سیستم خود نصب کنم؟

در macOS یا Linux، curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh را اجرا کنید. در macOS، می‌توانید از brew install freeguard نیز استفاده کنید. نصب‌کننده به‌طور خودکار OS و معماری شما را تشخیص می‌دهد.

آیا می‌توانم از FreeGuard CLI بدون GUI استفاده کنم؟

بله. FreeGuard CLI کاملاً headless است — به‌طور کامل در ترمینال اجرا می‌شود و به هیچ رابط گرافیکی نیاز ندارد. این ویژگی آن را برای سرورها، containerها و نشست‌های SSH از راه دور ایده‌آل می‌کند.

چگونه با CLI پروتکل‌های VPN را تغییر دهم؟

از freeguard connect --protocol <name> استفاده کنید. پروتکل‌های پشتیبانی‌شده شامل Hysteria2، Anytls و Trojan هستند. CLI به‌صورت پیش‌فرض از سریع‌ترین پروتکلِ در دسترس برای شبکه شما استفاده می‌کند.

آیا FreeGuard CLI روی دستگاه‌های ARM مانند Raspberry Pi کار می‌کند؟

بله. CLI از معماری‌های arm64 و armv7 پشتیبانی می‌کند. اسکریپت نصب، platform شما را به‌طور خودکار تشخیص می‌دهد و binary مناسب را دانلود می‌کند.

آخرین به‌روزرسانی: March 2026