FreeGuard VPN
الصفحة الرئيسيةعُقد VPNالأسعار
استكشاف أخطاء FreeGuard CLI وإصلاحها
هل تواجه مشاكل مع FreeGuard CLI؟ يغطي هذا الدليل المشاكل الأكثر شيوعاً وحلولها. لكل مشكلة، جرّب تشغيل `freeguard doctor` أولاً — فهو يكتشف معظم مشاكل الإعداد والبيئة تلقائياً.
جدول المحتويات

استكشاف أخطاء FreeGuard CLI وإصلاحها

هل تواجه مشاكل مع FreeGuard CLI؟ يغطي هذا الدليل المشاكل الأكثر شيوعاً وحلولها. لكل مشكلة، جرّب تشغيل freeguard doctor أولاً — فهو يكتشف معظم مشاكل الإعداد والبيئة تلقائياً.

مشاكل التثبيت

رفض الإذن أثناء التثبيت

العرَض: يفشل سكريبت التثبيت مع رسالة Permission denied أو EACCES.

الحل: على macOS/Linux، يحتاج المثبّت إلى صلاحية الكتابة في /usr/local/bin. شغّله بصلاحيات مرتفعة:

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

على Windows، تأكد من فتح PowerShell كمسؤول قبل تشغيل أمر التثبيت.

لم يتم العثور على الأمر بعد التثبيت

العرَض: تشغيل freeguard يُرجع command not found أو not recognized.

مخرجات Doctor:

✗ CLI binary:     Not in PATH

الحل: قد لا يكون الملف التنفيذي في مسار PATH الخاص بصدفتك. أضفه يدوياً:

# macOS/Linux — add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="$HOME/.freeguard/bin:$PATH"

# Then reload your shell
source ~/.zshrc  # or ~/.bashrc

على Windows، أضف %USERPROFILE%\.freeguard\bin إلى متغير بيئة PATH في نظامك وأعد تشغيل الطرفية.

فشل curl أو انتهاء مهلة التنزيل

العرَض: لا يستطيع سكريبت التثبيت تنزيل الملف التنفيذي.

الحل: إذا كنت خلف جدار حماية مؤسسي أو في شبكة مقيّدة، نزّل الملف التنفيذي يدوياً من صفحة الإصدارات على GitHub وضعه في ~/.freeguard/bin/. ثم اجعله قابلاً للتنفيذ:

chmod +x ~/.freeguard/bin/freeguard

مشاكل تسجيل الدخول

لم يتم استلام رمز التحقق

العرَض: بعد تشغيل freeguard login --email [email protected] --send-code، لا يصل أي بريد إلكتروني.

الحل:

  1. تحقق من مجلد البريد العشوائي/المهمل — رسائل التحقق قد تُصفّى أحياناً.
  2. انتظر دقيقتين قبل طلب رمز جديد. هناك حد لمعدل إرسال الرموز.
  3. تأكد من صحة عنوان البريد الإلكتروني:
freeguard login --email [email protected] --send-code
  1. جرّب مزود بريد إلكتروني مختلف إذا استمرت المشكلة.

انتهاء صلاحية الرمز المميز

العرَض: تفشل الأوامر مع رسالة Authentication expired أو Token invalid.

مخرجات Doctor:

✗ Credentials:     Token expired (last refresh: 2026-03-01)

الحل: سجّل الدخول مجدداً لتحديث بيانات اعتمادك:

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

بريد إلكتروني خاطئ — لم يتم العثور على اشتراك

العرَض: ينجح تسجيل الدخول لكن freeguard connect يقول No active subscription.

مخرجات Doctor:

✓ Credentials:     Logged in (email: u***@example.com)
✗ Subscription:    No active subscription found

الحل: تأكد أنك تسجّل الدخول بنفس البريد الإلكتروني الذي استخدمته لشراء اشتراكك. إذا استخدمت بريداً إلكترونياً مختلفاً:

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

مشاكل الاتصال

انتهاء مهلة الاتصال

العرَض: freeguard connect يتوقف أو يُرجع Connection timed out.

مخرجات Doctor:

✗ Network:         Internet not reachable

الحل:

  1. تحقق من اتصالك الأساسي بالإنترنت (افصل VPN أولاً):
freeguard disconnect
ping 8.8.8.8
  1. جرّب عقدة أو دولة مختلفة:
freeguard connect --country SG
  1. جرّب بروتوكولاً مختلفاً قد يعمل بشكل أفضل على شبكتك:
freeguard connect --protocol hysteria2

المنفذ 7890 مستخدم بالفعل

العرَض: freeguard connect يفشل مع رسالة Port 7890 is already in use.

مخرجات Doctor:

✗ Port 7890:       In use by another process (PID: 12345)

الحل: تطبيق proxy آخر يستخدم المنفذ الافتراضي. إما أوقف التطبيق الآخر، أو غيّر منفذ proxy الخاص بـ FreeGuard:

freeguard config set proxy.port 8080
freeguard connect

تم اكتشاف تسرب DNS

العرَض: استعلامات DNS تتجاوز نفق VPN.

الحل: انتقل إلى إعداد DNS آمن:

freeguard config set dns.provider secure
freeguard disconnect
freeguard connect

يمكنك التحقق من أن DNS يُوجَّه عبر VPN:

freeguard doctor

ابحث عن فحص DNS في المخرجات للتأكد من أنه يعمل بشكل صحيح.

مشاكل الصلاحيات

وضع TUN يتطلب sudo

العرَض: freeguard connect --tun يفشل مع رسالة Permission denied: TUN device.

مخرجات Doctor:

✗ TUN permission:  Not available (run with sudo for TUN mode)

الحل: وضع TUN ينشئ واجهة شبكة افتراضية، مما يتطلب صلاحيات مرتفعة:

# macOS/Linux
sudo freeguard connect --tun

# Windows — run PowerShell as Administrator
freeguard connect --tun

إذا لم تكن بحاجة إلى تغطية VPN على مستوى النظام، استخدم وضع proxy النظام الافتراضي بدلاً من ذلك (لا حاجة لـ sudo):

freeguard connect

المنفذ أقل من 1024 يتطلب صلاحيات مرتفعة

العرَض: تعيين منفذ proxy أقل من 1024 يفشل مع رسالة Permission denied.

الحل: المنافذ أقل من 1024 مقيّدة في معظم أنظمة التشغيل. استخدم منفذاً أعلى من 1024:

freeguard config set proxy.port 7890

أو شغّل بصلاحيات مرتفعة إذا كنت تحتاج تحديداً إلى منفذ منخفض:

sudo freeguard connect

هل ما زلت عالقاً؟

إذا لم يحل freeguard doctor والحلول أعلاه مشكلتك، دع الذكاء الاصطناعي يشخّصها تلقائياً.

قم بزيارة صفحة FreeGuard CLI Agent واصف مشكلتك. يمكن للوكيل قراءة مخرجات freeguard doctor --json وإرشادك خطوة بخطوة نحو الحل.

يمكنك أيضاً تشغيل معالج استكشاف الأخطاء التفاعلي:

freeguard doctor --json | pbcopy
# Then paste the output into the CLI Agent chat

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

لماذا يقول FreeGuard CLI “connection refused”؟

هذا يعني عادةً أن خادم VPN غير متاح مؤقتاً. جرّب freeguard connect --server auto لاختيار أفضل خادم متاح تلقائياً، أو تحقق من إعدادات جدار الحماية.

كيف أتحقق مما إذا كان اتصال VPN يعمل؟

شغّل freeguard status لرؤية حالة اتصالك والخادم الحالي والبروتوكول. يمكنك أيضاً تشغيل curl ifconfig.me للتحقق من أن عنوان IP الخاص بك قد تغيّر.

FreeGuard CLI لا يبدأ بعد تحديث النظام. ماذا أفعل؟

شغّل freeguard update للحصول على أحدث إصدار. إذا فشل ذلك، أعد التثبيت باستخدام سكريبت التثبيت: curl -fsSL https://downloadcli.freeguardvpn.com/cli/install.sh | sh.

كيف أبلّغ عن خطأ أو أحصل على مساعدة؟

شغّل freeguard debug لجمع معلومات التشخيص، ثم تواصل مع الدعم عبر الموقع أو البريد الإلكتروني. أرفق مخرجات التشخيص لحل أسرع.

آخر تحديث: مارس 2026