الأسئلة الشائعة حول ServBay

قد يواجه المطورون بعض المشكلات أثناء استخدام بيئة تطوير الويب المحلية ServBay. يهدف هذا الدليل للإجابة عن سؤالين شائعين: كيفية ترقية ServBay Runtime وكيفية إصلاح مشكلات الوصول لمواقع ServBay المحلية عند استخدام أدوات بروكسي مثل ClashX Pro.

كيف يمكنني ترقية ServBay Runtime؟

يعد ServBay Runtime المكوّن الأساسي لـ ServBay، وهو ضروري لضمان التشغيل المستقر لـ ServBay والخدمات التي يديرها. عند إصدار نسخة جديدة، سيعرض ServBay للمستخدم إشعار ترقية عند بدء التشغيل. تساعدك التحديثات الدورية لـ Runtime على تحسين الأداء والاستقرار الكلي وضمان التوافق.

لترقية ServBay Runtime، اتبع الخطوات التالية:

1. افتح تطبيق ServBay.
2. في الشريط الجانبي الأيسر لنافذة ServBay، اختر الحزم > الخدمات العامة.
3. في لوحة الجانب الأيمن، ابحث عن إدخال ServBay Runtime.
4. إذا كان هناك تحديث متاح لـ ServBay Runtime، ستظهر لك إشارة ترقية باللون الأصفر أو زر ترقية. انقر على زر الترقية الأصفر.
5. سيبدأ ServBay في تحميل وتثبيت أحدث إصدار من Runtime. يرجى الانتظار حتى تكتمل عملية الترقية.

بعد إتمام الترقية، سيعمل ServBay Runtime بأحدث إصدار، مما يوفر أداءً واستقرارًا أعلى.

لماذا لا يمكن الوصول إلى المواقع المحلية في ServBay بعد استخدام ClashX Pro (أو أدوات بروكسي أخرى)؟

يستخدم العديد من المطورين ServBay لتطوير التطبيقات واختبارها محليًا، وغالبًا ما يتم ضبط أسماء نطاقات مخصصة مثل (servbay.demo, myproject.servbay.demo وغيرها) والتي تُشير عادةً إلى عنوان الحلقة المحلية 127.0.0.1.

عند استخدامك لـ ClashX Pro أو بعض أدوات VPN/البروكسي الأخرى مثل Surge وQuantumult X وغيرها، قد تقوم هذه الأدوات باعتراض أو إعادة توجيه طلبات DNS وتجبر كل عمليات تحليل أسماء النطاقات على المرور عبر سيرفر البروكسي الخاص بها. يؤدي هذا لعدم استخدام نظام التشغيل وملف hosts المحلي (الذي تعتمد عليه عناوين ServBay المخصصة)، مما يمنع المواقع المحلية المضبوطة في ServBay من التحليل الصحيح إلى عنوان IP المحلي، وكنتيجة لذلك لن تتمكن من الوصول إلى موقعك المحلي.

لحل هذه المشكلة، يجب عليك إضافة قاعدة في إعدادات أداة البروكسي لديك لتخبرها بعدم تمرير طلبات نطاقات التطوير المحلية الخاصة بك عبر البروكسي أو منع اعتراض طلبات DNS الخاصة بها. غالبًا ما يتم ذلك عبر إعدادات مثل "تجاوز البروكسي" أو "تجاهل البروكسي" أو "القائمة البيضاء" أو "قائمة الاستثناءات".

على سبيل المثال، مع ClashX Pro، اتبع الخطوات التالية:

1. افتح تطبيق ClashX Pro.
2. ابحث عن أيقونة ClashX Pro في شريط قوائم macOS وانقر عليها، ثم اختر المزيد من الإعدادات.
3. في نافذة الإعدادات المفتوحة، انتقل إلى علامة التبويب عام.
4. ابحث عن مربع الإدخال المسمى تجاهل إعدادات البروكسي لهذه المضيفات والنطاقات (أو مسمى مشابه).
5. أضف نطاقات التطوير المحلية الخاصة بك إلى هذه القائمة. لتغطية النطاقات الشائعة في ServBay، يُنصح بإضافة localhost, 127.0.0.1، بالإضافة إلى النطاقات التي تستخدمها أو النطاقات الفرعية بطرفية عامة. على سبيل المثال، إذا كنت تعتمد .servbay.demo كلاحقة لنطاقاتك المحلية، يمكنك إضافة *.servbay.demo. عادةً ما يتم فصل الإدخالات بفواصل (,) أو سطور جديدة. قد تبدو إعداداتك كالتالي:

   localhost, 127.0.0.1, *.servbay.demo, yourproject.servbay.demo

6. احفظ الإعدادات، وبحسب تعليمات ClashX Pro قد يكون عليك إعادة تحميل أو تطبيق التغييرات ليتم تفعيلها.

(توضيح: إعداد Ignore proxy hosts & domains في ClashX Pro)

بعد إتمام هذه الإعدادات، لن يتداخل ClashX Pro مع تحليل هذه النطاقات المحلية، وينبغي أن تتمكن من الوصول إلى مواقع ServBay المحلية بشكل طبيعي. إذا استمرت المشكلة، تحقق من أن اسم النطاق مضبوط بالشكل الصحيح في إعدادات المواقع داخل ServBay، وأن جميع الخدمات المرتبطة (مثل Caddy أو Nginx) تعمل بشكل سليم. يمكنك أيضًا التشخيص عبر الطرفية باستخدام الأمرين ping yourproject.servbay.demo أو dig yourproject.servbay.demo للتحقق من تحليل النطاق.