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