الأسئلة الشائعة حول PandaVPN CLI

Panda CLI هو عميل سطر الأوامر الخاص بـ Panda، ويدعم تنفيذ ما يلي من خلال الطرفية:

• تسجيل الدخول وإدارة الحساب
• تحديث العقد والاتصال بها
• التبديل بين أوضاع PandaVPN / Proxy / WireGuard / Auto
• تكوين وكيل النظام
• قواعد Split rules لتقسيم المسارات
• تكوين Split DNS
• حماية Kill-switch
• Auto-connect
• السجلات والتشخيصات

وهو مناسب لمستخدمي الاختبار الداخلي والمطورين والمستخدمين المتقدمين وسيناريوهات الاختبار التي تتطلب عمليات قابلة للبرمجة النصية.

يُعد PandaVPN CLI أكثر ملاءمة للاختبارات الآلية، واستكشاف الأخطاء وإصلاحها عن بُعد، والاتصالات التي يتم تشغيلها عبر البرامج النصية.

يُعد Panda Desktop وPandaVPN CLI واجهتَي تحكم لنفس PandaVPN daemon، ويشتركان في حالة الاتصال نفسها، لذلك يمكن استخدامهما معًا.

لا تشغّل تطبيقات سطح المكتب القديمة، مثل Panda-Qt أو Linux AppImage القديم، في الوقت نفسه مع PandaVPN CLI، لأن ذلك قد يسبب تعارضات في إعدادات الشبكة.

تتطلب بعض القدرات صلاحيات على مستوى النظام، مثل:

• إنشاء واجهات شبكة TUN / WireGuard
• تعديل DNS
• إعداد وكيل النظام
• تطبيق Kill-switch
• إصلاح التوجيه
• إدارة packet VPN runtime

لذلك، ينفذ CLI هذه العمليات عبر daemon / service المناسبة للمنصة.

أشكال daemon على المنصات المختلفة:

الفرق الأساسي هو: في Windows وmacOS عادةً ما يتم تثبيت الخدمة تلقائياً عبر حزمة التثبيت، بينما في Linux يحتاج المستخدم عادةً إلى تنفيذ sudo panda service install يدوياً.

في Windows، لا تحتاج إلى تنفيذ الأمر التالي من PowerShell بصلاحيات المسؤول إلا عند عدم استخدام حزمة التثبيت ووضع الملفات الثنائية يدوياً:

panda service install windows

في macOS، لا تحتاج إلى الأمر التالي إلا أثناء التطوير والتصحيح، أو عند عدم استخدام حزمة تثبيت .pkg، أو إذا لم يبدأ daemon تلقائياً:

sudo panda start

في Linux، يوصى بما يلي:

sudo panda service install
panda service status

نعم، هي نفسها. يكمن الاختلاف الأساسي في معمارية حزمة التثبيت التي يتم تنزيلها.

خطوات التثبيت والأوامر وطريقة إدارة الخدمة متطابقة. ستقوم حزمة التثبيت تلقائيًا برفع الصلاحيات وتسجيل Windows Service.

نعم، هي نفسها. يكمن الاختلاف الأساسي في بنية حزمة .pkg التي يتم تنزيلها.

خطوات التثبيت متطابقة. بعد التثبيت باستخدام .pkg، عادةً ما يتم تثبيت LaunchDaemon / helper وتشغيله تلقائياً.

بالنسبة للمستخدمين حول العالم، نوصي باستخدام mode auto افتراضيًا:

panda login
panda node refresh
panda mode auto
panda connect
panda doctor

إذا كان التثبيت الجديد يستخدم mode auto افتراضيًا بالفعل، فيمكن أيضًا استخدام نسخة أبسط:

panda login
panda node refresh
panda connect
panda doctor

الإصدار المختصر المقابل:

panda login
panda no re
panda conn
panda do

يُوصى بأن تعرض صفحة التنزيل الرسمية ودليل المبتدئين الأوامر الكاملة أولًا؛ ثم تُعرض الاختصارات في الوثائق المتقدمة أو شرح الوضع التفاعلي.

gfwlist هو مصدر محدد لقواعد التقسيم، ولا يصلح كنمط افتراضي للمستخدمين حول العالم.

الإعداد الافتراضي الموصى به للمستخدمين العالميين هو:

panda mode auto

أو استخدام وضع PandaVPN العام بشكل ثابت:

panda mode pandavpn global

يمكن الاحتفاظ بـ gfwlist في وثائق التقسيم المتقدمة، لكن لا يُنصح بعرضه في الجزء الأول من الموقع الرسمي أو Hero صفحة التنزيل أو دليل البدء السريع للمبتدئين.

يُوصى بقطع الاتصال أولًا وإيقاف Kill-switch:

panda disconnect
panda kill-switch off

إذا كانت الترقية يدوية أو ترقية Linux service، فيُوصى أيضًا بإيقاف daemon:

sudo panda stop

عند ترقية macOS وWindows باستخدام المثبّت، يتولى المثبّت عادةً تثبيت الخدمة وإعادة تشغيلها تلقائيًا. بعد اكتمال الترقية، يُوصى بتنفيذ:

panda version
panda doctor
panda connect

بعد الترقية اليدوية على Linux، يُوصى بما يلي:

sudo panda service install
sudo panda service restart
panda version
panda doctor

panda connect us

يشير إلى bare group selector، ولا يثبت VIP / SVIP / FREE tab، بل يترك API يختار tab المناسب.

panda connect svip us

يشير إلى استخدام us ضمن SVIP tab بشكل ثابت.

صيغة النقطتين مكافئة ومناسبة للسكربتات:

panda connect svip:us

حاليًا، favorite tab هو flat favorite channel list، ولا يدعم group smart connect للمفضلة مثل connect fav us؛ للمفضلة استخدم:

panda connect fav

أو:

panda connect --node <NODE_ID>

يدعم بشكل أساسي:

الإعدادات الشائعة:

panda mode auto
panda mode pandavpn global
panda mode proxy global
panda mode wireguard

لا يُنصح حاليًا بعرض openvpn كمسار رئيسي في وثائق المستخدم.

التوصية:

ملاحظة: mode proxy يتعارض مع Kill-switch.

mode auto هو الوضع الافتراضي في الإصدار الجديد.

سلوكه هو:

• يقوم API node / smart connect باختيار runtime أولًا حسب meta.protocol؛
• إذا كان WireGuard هو الخيار الموصى به، فسيحاول WireGuard أولًا؛
• إذا فشلت بيانات WireGuard الوصفية، أو تخصيص العنوان، أو بدء runtime، أو handshake، أو فحص الاتصال، فسيعود إلى PandaVPN global المجمّع من SS payload؛
• ستستخدم بروتوكولات SS وOPENVPN والبروتوكولات غير المعروفة أو المفقودة PandaVPN global كخيار احتياطي؛
• mode auto لا يقبل معامل policy، وسيكون runtime الناتج دائمًا global.

يُنصح المستخدمون الجدد باستخدام:

panda mode auto
panda connect

direct-region هي الصيغة الموصى بها؛ bypass-region / bypass هي أسماء بديلة للتوافق.

مثال:

panda mode pandavpn direct-region in

وهي مكافئة للاسم البديل المتوافق:

panda mode pandavpn bypass-region in

يدعم الإصدار الجديد صياغة split profile أكثر اكتمالًا:

panda mode pandavpn split default direct proxy-region <cc>
panda mode pandavpn split default proxy direct-region <cc>

الـ token الشائعة:

أمثلة:

panda mode pandavpn split default direct proxy-region us custom-rules
panda mode pandavpn split default proxy direct-region in direct-lan custom-rules

لا يُنصح بعرض الأوامر الطويلة في وثائق المبتدئين؛ فهي مناسبة لوثائق split المتقدمة.

عرض جميع العقد:

panda node list

التحديث ثم العرض مرة أخرى:

panda node refresh
panda node list

الصيغة المختصرة:

panda no re
panda no list

عرض منطقة أو مجموعة معينة:

panda node list us
panda node list jp
panda node list de

عرض مجموعات العقد:

panda node group

عرض تفاصيل مجموعة معينة:

panda node group show us

ابحث عن العقد أولًا:

panda node list us

ثم اتصل:

panda connect --node 1822

يمكنك أيضًا الاتصال بالاسم:

panda connect --node "US Node"

الصيغة المختصرة:

panda no list us
panda conn --node 1822

سيستخدم panda connect آخر هدف.
إذا لم يكن هناك هدف سابق، فسيحاول global smart connect.

يتطلب Smart connect:

• أن تكون قد سجّلت الدخول؛
• أن يكون دليل العقد مخزّنًا مؤقتًا؛
• عند الحاجة، نفّذ أولًا panda node refresh.

الصيغة المختصرة:

panda conn

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

• لم يتم تسجيل الدخول بعد؛
• لم يتم تحديث دليل العقد؛
• لا توجد عقد متاحة للحساب الحالي؛
• الشبكة غير متاحة؛
• daemon غير قيد التشغيل؛
• الوضع الحالي غير متوافق مع العقدة الهدف؛
• في mode auto، فشل تشغيل البروتوكول الموصى به وفشل fallback أيضًا.

يوصى بالتحقق من:

panda account
panda node refresh
panda node list
panda mode
panda doctor
panda log --lines 200

panda status

إخراج منظم:

panda status --json

الصيغة المختصرة:

panda stat

doctor هو أمر تشخيصي للقراءة فقط، يُستخدم لعرض الحالات الأساسية الحالية لـ Panda CLI.

panda doctor
panda doctor --json

الصيغة المختصرة:

panda do

ركّز بشكل خاص على:

runtime
kill_switch
selected_node
vpn_dns
dns_lockdown
split_policy
system_proxy_state
vpn_routes
last_error

يُستخدم trace لمعرفة أي قاعدة وDNS action وroute سيستخدمها هدف معيّن.

panda trace example.com:443
panda trace 8.8.8.8:53 --json

ملاحظة: تتطلب قدرة trace الكاملة active PandaVPN packet runtime. عند عدم وجود runtime متوافق، يمكن فقط إجراء تحقق محدود أو الرجوع إلى legacy trace.

عادةً ما يحدث ذلك لأنك قمت بتثبيت service / LaunchDaemon الرسمي، ثم نفذت يدويًا:

sudo panda start

سيؤدي sudo panda start إلى تشغيل daemon unmanaged / خارج الإدارة، وقد يدير بالتزامن مع daemon الرسمي ما يلي:

• VPN route
• DNS
• TUN
• system proxy
• Kill-switch

مبدأ المعالجة هو: احتفظ بـ daemon واحد فقط.

المعالجة الشائعة على macOS / Linux:

panda disconnect
panda kill-switch off
sudo panda stop
panda repair
panda doctor

على Linux، إذا كنت تستخدم systemd service، فأعد تشغيل الخدمة الرسمية بعد ذلك:

sudo panda service restart
panda doctor

على macOS، إذا كنت تستخدم تثبيت .pkg، فعادةً يجب ترك LaunchDaemon / helper يدير daemon، ولا تستخدم sudo panda start لفترة طويلة كطريقة تشغيل يومية.

إذا كنت تريد فقط قطع اتصال VPN، فلا حاجة إلى الخروج من daemon:

panda disconnect
panda kill-switch off

إذا كنت تريد فعلاً إيقاف daemon:

sudo panda stop

للتحقق:

panda status

إذا ظهر panda daemon unavailable، فهذا يعني أن daemon الرئيسي قد توقف.

ملاحظة: قد تتم إدارة LaunchDaemon / helper المثبّت عبر macOS .pkg بواسطة النظام، ولا يُنصح المستخدمون العاديون بإيقاف الخدمة يدويًا بشكل متكرر.

panda log
panda log --lines 200
panda log --all

مسح logs:

panda log clear

تفعيل debug مؤقتًا:

panda log level debug dns,tcp --ttl 10m

استعادة الإعداد الافتراضي:

panda log level reset

في سيناريو no-tunnel IPv6، قد يتم block لـ awdl0 / llw0، مما يؤدي إلى عدم توفر AirDrop / Continuity مؤقتًا.
عادةً يعود الوضع بعد disconnect.

إذا بقي الأمر غير طبيعي، يُنصح بما يلي:

panda disconnect
panda kill-switch off
panda repair
panda doctor

يمكن للإصدارات المدعومة تكوين ذلك:

panda config tcp-fast-open auto
panda config tcp-fast-open on
panda config tcp-fast-open off

توضيح:

• يُوصى افتراضيًا باستخدام auto؛
• لن يحدث hot reconnect بعد التعديل؛
• يجب تنفيذ reconnect ليصبح الإعداد نافذًا على TCP socket الجديدة؛
• العُقد التي لا تدعم TFO ينبغي ألا يظهر عليها تراجع واضح في تأخير الاتصال.

إذا لم يتضمن الإصدار الحالي خيار الإعداد هذا، فاعتمد على panda config --help أو CLI help الفعلي.

يمكن فهم Privacy mode على أنه وضع أمان أكثر صرامة، ويوصى باعتباره مكافئًا لـ:

panda mode pandavpn global
panda kill-switch on

أو عند اختيار البروتوكول تلقائيًا بشكل افتراضي:

panda mode auto
panda kill-switch on

في Privacy mode، يوصى بالقيود التالية:

• لا يدعم proxy mode؛
• لا يدعم split mode؛
• يسمح فقط بدلالة VPN global؛
• يجب تمكين Kill-switch؛
• يتم حظر egress العادي.

panda repair أكثر شمولًا، وقد يصلح:

• VPN route
• DNS snapshot
• Kill-switch guard
• الحالات المتعلقة بـ system proxy

panda proxy repair يصلح بشكل أساسي system proxy drift للمستخدم الحالي.

panda repair
panda proxy repair

في Fresh install يكون الإعداد الافتراضي proxy system-proxy on.
إذا كان المستخدم قد حفظ off صراحةً، فسيتم الاحتفاظ بهذا الإعداد.

العرض أو الإعداد:

panda proxy system-proxy on
panda proxy system-proxy off
panda proxy system-proxy lock-on

ملاحظة: في mode auto وpandavpn وwireguard، سيتجاهل VPN runtime تفضيل system proxy المحفوظ؛ يظل VPN companion proxy متاحًا ويستخدم scoped egress.

Windows system proxy هو إعداد HKCU WinINET للمستخدم الحالي، ويتطلب per-user user-agent.
إذا كنت في جلسة SSH أو جلسة غير تفاعلية، فقد لا يتمكن proxy repair دائمًا من تشغيل user-agent تلقائيًا.

يوصى بالتالي:

panda proxy status
panda proxy repair
panda doctor

إذا بقي غير فعّال، يرجى إعادة المحاولة داخل جلسة تسجيل دخول سطح المكتب.

يدعم Linux Phase 1 بشكل أساسي GNOME gsettings.
قد تظهر بيئات مثل KDE / XFCE كـ unsupported.

لا يؤثر ذلك بالضرورة على PandaVPN packet runtime، لكنه قد يؤثر على تجربة system proxy mode.

تعني Kill-switch السماح للمرور فقط عبر TUN، بينما يتم حظر أي حركة مرور عادية أخرى.

proxy mode هو وضع proxy محلي مستقل، ولا يحتوي على packet VPN / TUN، كما لا يوفر حماية مكافئة لـ DNS والتوجيه. لذلك لا يدعم Kill-switch وضع standalone proxy mode.

عند الحاجة إلى Kill-switch، استخدم:

panda mode auto
panda kill-switch on

أو:

panda mode pandavpn global
panda kill-switch on

أو:

panda mode wireguard
panda kill-switch on

لا.

يغطي Auto-connect بشكل أساسي best-effort connect عند بدء daemon / service، وكذلك pending retry عندما لا تكون الشبكة متاحة مؤقتًا عند بدء التشغيل.

التفعيل:

panda config auto-connect on

الإيقاف:

panda config auto-connect off

إنه ليس آلية عامة لإعادة الاتصال تلقائيًا أثناء runtime.

تُستخدم Split rules لتحديد أن بعض أسماء النطاقات أو الكلمات المفتاحية أو regex أو IP تمر عبر proxy أو direct أو block.

ملفات القواعد:

split/rules/proxy.txt
split/rules/direct.txt
split/rules/block.txt

الأوامر الشائعة:

panda split rules list
panda split rules add proxy suffix:github.com
panda split rules add direct ip-cidr:10.0.0.0/8
panda split rules add block keyword:adservice

القيد المعروف حاليًا: بعد login، لن يتم wake تلقائيًا لـ pending auto-connect الذي ينتظر إعادة المحاولة.

يُوصى بتنفيذ الأمر يدويًا بعد login:

panda connect

عادةً لا تحتاج إلى ذلك. يتم hot-load لتغييرات إعدادات Split DNS.

الأوامر الشائعة:

panda split dns status
panda split dns local set 223.5.5.5 114.114.114.114
panda split dns policy tunnel-only
panda split dns fake-ip on

إذا كانت المنصة لا تدعم بعض مصادر local DNS، فسيعرض doctor warning.

في الإصدارات الجديدة، تمت ترقية Windows Kill-switch من daemon-held dynamic session إلى persistent WFP filters.
هذا يعني أن guard يمكن أن يبقى بعد خروج daemon بشكل غير طبيعي.

لكن persistent WFP لا يساوي boot-time filter، ولا تزال نافذة بدء التشغيل المبكرة جدًا ضمن نطاق hardening اللاحق.

تعني Kill-switch السماح للمرور فقط عبر TUN، بينما يتم حظر أي حركة مرور عادية أخرى.

proxy mode هو وضع proxy محلي مستقل، ولا يحتوي على packet VPN / TUN، كما لا يوفر حماية مكافئة لـ DNS والتوجيه. لذلك لا يدعم Kill-switch وضع standalone proxy mode.

عند الحاجة إلى Kill-switch، استخدم:

panda mode auto
panda kill-switch on

أو:

panda mode pandavpn global
panda kill-switch on

أو:

panda mode wireguard
panda kill-switch on

نعم.

يُسمح باستخدام mode auto + kill-switch on، لكن يجب أن يتم حل المسار النهائي إلى PandaVPN / WireGuard، ولا يجوز أن يقع على standalone proxy. أثناء الاتصال، إذا تم الرجوع من WireGuard إلى PandaVPN، يجب أيضًا إبقاء guard active، ولا يجب أن تظهر أي fail-open window.

موصى به:

panda mode auto
panda kill-switch on
panda connect
panda doctor

لا يُنصح بذلك.

Kill-switch خيار لتعزيز حماية الخصوصية، ولا يناسب وضعه في أقصر مسار قابل للاستخدام. الأسباب:

• disconnect لا يوقف Kill-switch؛
• بعد تفعيله قد يتم حظر الشبكة العادية؛
• يتعلق أيضًا بالوصول إلى LAN وDNS lockdown والجدار الناري واختلافات صلاحيات المنصة؛
• قد يظن المستخدمون الجدد خطأً أن الشبكة معطلة.

يوصى بأن يكمل المستخدمون الجدد أولًا:

panda login
panda node refresh
panda mode auto
panda connect
panda doctor

بعد التأكد من أن الاتصال يعمل بشكل طبيعي، فعّله عند الحاجة:

panda kill-switch on
panda doctor

لا.

هذا هو السلوك المتوقع. Kill-switch هو مفتاح أمان دائم، وdisconnect يقطع runtime الحالي فقط، ولن يوقف Kill-switch تلقائيًا.

إذا كنت تريد استعادة الوصول العادي إلى الشبكة، فيجب تنفيذ:

panda kill-switch off

في الوضع الصارم، سيحظر Kill-switch حركة مرور LAN / WAN العادية.
تدعم الإصدارات التي تحتوي على allow-lan تفعيل وصول LAN محدود:

panda kill-switch allow-lan on

لإيقاف السماح لـ LAN:

panda kill-switch allow-lan off

ملاحظة: يسمح allow-lan بـ private network / link-local / ULA unicast وv1 discovery، لكن يجب أن يظل LAN DNS محظورًا لتجنب تجاوز Panda DNS lockdown.