FreeGuard CLI بدء سريع
FreeGuard CLI هو عميل VPN سطر أوامر يتصل بأمر واحد. ثبّته على macOS أو Linux أو Windows، سجّل الدخول باستخدام بريدك الإلكتروني، وشغّل `freeguard connect` لتأمين اتصالك بالإنترنت في أقل من 5 دقائق.

FreeGuard CLI بدء سريع

FreeGuard CLI هو عميل VPN سطر أوامر يتصل بأمر واحد. ثبّته على macOS أو Linux أو Windows، سجّل الدخول باستخدام بريدك الإلكتروني، وشغّل freeguard connect لتأمين اتصالك بالإنترنت في أقل من 5 دقائق.

التثبيت

macOS و Linux

ثبّته بأمر واحد:

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

أو استخدم Homebrew على macOS:

brew install freeguardvpn/tap/freeguard

بعد التثبيت، تحقّق من نجاحه:

freeguard version

المخرجات المتوقعة:

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

Windows

افتح PowerShell كمسؤول وشغّل:

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

مثال على المخرجات:

✓ تم تسجيل الدخول بنجاح!
✓ تم العثور على اشتراك نشط واحد (Pro Plan, expires 2026-12-01)
✓ تم إنشاء الإعدادات: ~/.freeguard/profiles/default.yaml

إذا كان لديك حساب FreeGuard، يمكنك أيضًا تسجيل الدخول عبر المتصفح:

freeguard login --account

سيفتح هذا متصفحك لمصادقة OAuth ويعيد رمزًا تلقائيًا.

الاتصال

اتصل بأسرع خادم متاح بأمر واحد:

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

للاتصال بعقدة محددة:

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)

للحصول على مخرجات قابلة للقراءة آليًا (مفيدة للبرمجة النصية أو وكلاء الذكاء الاصطناعي):

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 — القائمة الكاملة لجميع الأوامر والوسائط وصيغ المخرجات.
  • استكشاف أخطاء CLI وإصلاحها — حلول لمشكلات التثبيت وتسجيل الدخول والاتصال الشائعة.
  • وكيل FreeGuard CLI — دع الذكاء الاصطناعي يشخّص المشكلات ويصلحها لك تلقائيًا.
  • شغّل freeguard --help لاستعراض جميع الأوامر المتاحة من الطرفية.

الأسئلة الشائعة

كيف أثبّت FreeGuard CLI على نظامي؟

شغّل curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh على macOS أو Linux. على macOS، يمكنك أيضًا استخدام brew install freeguard. يتعرّف المثبّت تلقائيًا على نظام التشغيل والمعمارية.

هل يمكنني استخدام FreeGuard CLI بدون واجهة رسومية؟

نعم. يعمل FreeGuard CLI بشكل كامل بلا واجهة — إذ يعمل بالكامل في الطرفية دون الحاجة إلى واجهة رسومية. وهذا يجعله مثاليًا للخوادم والحاويات وجلسات SSH البعيدة.

كيف أبدّل بروتوكولات VPN باستخدام CLI؟

استخدم freeguard connect --protocol <name>. تشمل البروتوكولات المدعومة Hysteria2 و Anytls و Trojan. يستخدم CLI افتراضيًا أسرع بروتوكول متاح لشبكتك.

هل يعمل FreeGuard CLI على أجهزة ARM مثل Raspberry Pi؟

نعم. يدعم CLI معماريات arm64 و armv7. يتعرّف سكربت التثبيت تلقائيًا على منصتك ويحمّل الملف الثنائي الصحيح.

آخر تحديث: March 2026