إعداد الوكيل العكسي في ServBay: ربط مواقع الشبكة الداخلية أو الخارجية ببيئة التطوير المحلية الخاصة بك

يعد ServBay بيئة تطوير ويب متكاملة صُممت خصيصًا لنظام macOS، وتدعم عدة لغات برمجة بما في ذلك PHP، Node.js، Python، Go، Java، بالإضافة إلى قواعد بيانات مثل MySQL، PostgreSQL، MongoDB، Redis، وغيرها. بجانب استضافة مشاريع الكود المحلية، يقدم ServBay أيضًا ميزة قوية للوكيل العكسي، حيث يمكنك بسهولة ربط مواقع ويب موجودة على الشبكة الداخلية أو الأجهزة الافتراضية أو الحاويات أو حتى على خوادم بعيدة ببيئة ServBay المحلية، مما يسهل عملية التطوير والتصحيح والوصول الموحد.

سيوضح لك هذا الدليل كيفية إعداد وكيل عكسي في ServBay لربط مواقع الشبكة الداخلية أو أي عناوين مواقع متاحة ببيئتك المحلية، لتسهيل الإدارة ورفع كفاءة التطوير.

لمحة عامة

يعمل خادم الوكيل العكسي على استقبال الطلبات من العميل (المتصفح مثلًا) ثم يُعيد توجيهها إلى خادم أو أكثر في الخلفية (في هذا السياق: الموقع الداخلي أو البعيد الذي ترغب بربطه). تستخدم ServBay خادم الويب المدمج (Caddy أو Nginx) لتحقيق هذه الوظيفة.

وتتجلى أهمية الوكيل العكسي في بيئة التطوير المحلية في النقاط التالية:

• نقطة دخول موحدة: يمكنك زيارة جميع الموارد الداخلية أو الخارجية من خلال نطاق ServBay المحلي، دون الحاجة لتذكر عناوين IP أو منافذ معقدة.
• تبسيط إعدادات SSL: يمكن الاستفادة من أداة إدارة SSL المدمجة في ServBay (مثل ServBay CA أو ACME) لتوفير الوصول عبر HTTPS للمواقع الموكَلة، حتى وإن كانت تدعم HTTP فقط.
• تصحيح محلي سلس: يمكنك تصحيح تطبيقات الويب البعيدة أو الداخلية من بيئة المتصفح المحلية لديك.
• تجاوز قيود الشبكة: في بعض الحالات، يمكنك الوصول بسهولة إلى موارد الشركة الداخلية أو الشبكات المحمية من بيئتك المحلية (بشرط أن يكون جهاز ServBay قادرًا على الوصول لعنوان الهدف المحدد).

الشروط المسبقة

قبل بدء إعداد الوكيل العكسي، تأكد من تحقق الشروط التالية:

1. تثبيت وتشغيل ServBay: يجب أن يكون تطبيق ServBay مثبتًا على جهازك بنظام macOS ويعمل بطريقة صحيحة.
2. إمكانية الوصول لموقع الهدف: الموقع الداخلي أو البعيد الذي ترغب بربطه يعمل فعليًا، وجهاز الماك الخاص بك الذي يشغل ServBay يمكنه الوصول إليه عبر الشبكة (IP/اسم نطاق والمنفذ). على سبيل المثال، إذا كان الهدف 192.168.1.100:8080، تأكد من إمكانية الوصول إليه عبر الماك من خلال ping وفتح المنفذ المطلوب.

خطوات إضافة موقع وكيل عكسي

فيما يلي الخطوات التفصيلية لإعداد موقع وكيل عكسي ضمن ServBay:

الخطوة 1: فتح واجهة إدارة ServBay

اذهب إلى مجلد التطبيقات في macOS، وابحث عن أيقونة ServBay وقم بتشغيل التطبيق.

الخطوة 2: الانتقال لإدارة المواقع

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

الخطوة 3: إضافة موقع جديد

في أسفل صفحة إدارة المواقع، ابحث عن زر + واضغط عليه. ستظهر لك استمارة جديدة في الجانب الأيمن لتكوين موقع جديد.

الخطوة 4: إعداد خيارات الوكيل العكسي للموقع

في نموذج الموقع الجديد، يجب ملأ المعلومات الأساسية التالية لتعريف سلوك الوكيل العكسي:

1. الاسم (Name): اختر اسمًا واضحًا وسهل التمييز لموقع الوكيل العكسي، مثل: Internal Backend Proxy.
2. النطاق (Domain): أدخل اسم النطاق الذي تود الوصول من خلاله للموقع الموكّل داخليًا. مثال: backend.servbay.demo أو proxy.to.local. عادةً ما يضيف ServBay تلقائيًا هذا النطاق إلى ملف hosts بالنظام لتوجيهه إلى 127.0.0.1 أو ::1.
3. البروتوكول (Protocol): اختر البروتوكول المدعوم، عادةً HTTP/HTTPS لدعم كليهما، وسيتولى ServBay إدارة SSL تلقائيًا بحسب الإعدادات.
4. طريقة طلب شهادة SSL:
   • ServBay CA (موصى بها للتطوير المحلي): عند التحديد، سيستخدم ServBay مرجعه المدمج لإصدار شهادات SSL تلقائيًا لنطاقك. قد تحتاج لتثبيت شهادة ServBay CA كموثوقة في النظام/المتصفح لتجنب تنبيهات الأمان.
   • ACME (Let's Encrypt): اختر هذا الخيار إذا كان النطاق عامًا وقابل للوصول من الإنترنت من أجل استخراج شهادة مجانية عامة.
   • يدوي (Manual): في حال لديك بالفعل ملفات شهادة SSL (.crt, .key, .ca-bundle) يمكنك رفعها وتكوينها يدويًا. للتطوير المحلي أو ربط مواقع داخلية، يوصى بشدة باستخدام ServBay CA.
5. نوع الموقع (Website Type): اختر وكيل عكسي (Reverse Proxy)، وهي الإعداد الرئيسي لتحقيق وظيفة الوكيل.
6. هدف الوكيل (Proxy Target): أدخل العنوان الكامل لموقعك الداخلي أو البعيد المستهدف، على شكل IP:Port أو عنوان URL كامل.
   • مثال 1 (IP:Port): 192.168.1.100:8080
   • مثال 2 (عنوان URL بالبروتوكول): http://192.168.1.100:8080
   • مثال 3 (اسم مضيف داخلي): backend.internal:8443 (شريطة تمكن جهاز ServBay من تفسير هذا الاسم)
   • مثال 4 (رابط بعيد): https://api.example.com احرص أن يكون العنوان المدرج قابلاً للوصول المباشر من جهاز ServBay.

الخطوة 5: إكمال وحفظ الإعداد

بعد ملء جميع الحقول الضرورية، اضغط زر إضافة (Add) أسفل الاستمارة. سيقوم ServBay تلقائياً بحفظ إعداداتك وإنتاج قواعد الوكيل العكسي الملائمة في خادم الويب (Caddy أو Nginx).

عند نجاح الحفظ، ستجد موقع الوكيل العكسي الجديد مدرجًا في قائمة المواقع.

الخطوة 6: الوصول للموقع الموكّل عكسيًا

عند إتمام الإعداد، افتح متصفح الإنترنت وأدخل اسم النطاق الذي حددته في الخطوة الرابعة (مثلًا: proxy.to.local أو backend.servbay.demo) للوصول للموقع الداخلي أو البعيد عبر الوكيل العكسي.

إذا استعملت ServBay CA واخترت HTTPS، قد تظهر لك رسالة تحذير من الشهادة أول مرة (إذا لم تكن قد وضعت ServBay CA في قائمة الشهادات الموثوقة بعد).

الخطوة 7: أدوات إدارة سريعة للمواقع

يتيح لك ServBay عدة أزرار سريعة لإدارة كل موقع:

1. فتح مجلد الموقع بواسطة IDE: بالنسبة لمواقع الوكيل العكسي، قد لا تحتاج لهذا الزر غالبًا لعدم وجود مجلد محلي للموقع.
2. فتح الموقع في المتصفح: يساعدك على الوصول للموقع بسرعة عبر متصفحك الافتراضي.
3. عرض سجلات الموقع: لمراجعة سجلات الوصول والأخطاء لخادم الويب (Caddy/Nginx)، وهو أمر بالغ الأهمية خلال التصحيح.
4. إيقاف/تشغيل الموقع: تمكين أو تعطيل تكوين الوكيل العكسي مؤقتًا.
5. حذف الموقع: لمسح موقع الوكيل العكسي نهائيًا من ServBay.

الأسئلة الشائعة وحلولها (FAQ)

س: الموقع غير قابل للوصول والمتصفح يعرض خطأ.

• تحقق من حالة ServBay: تأكد أن تطبيق ServBay قيد التشغيل وأن خادم الويب (Caddy/Nginx) قد تم تشغيله.
• راجع تحليل النطاق: تحقق أن اسم النطاق الذي تستخدمه يُوجه بشكل صحيح إلى جهاز ServBay (عادةً ServBay يضبط ملف hosts تلقائيًا، لكن يمكنك المراجعة يدويًا).
• استعرض سجل الموقع في ServBay: بالضغط على زر "عرض السجلات"، اطلع على سجل خادم الويب الخاص بالموقع. هنا ستجد طلبات العملاء وسجلات محاولات الاتصال بهدف الوكيل وأي أخطاء تساعد في تحديد السبب.
• تحقق من جدار الحماية/برامج الأمان: تأكد أن جدار حماية macOS أو البرامج الأمنية لا تعطل استماع ServBay على المنفذين 80 أو 443، أو تمنعه من الوصول لهدف الوكيل المحدد.

س: جهاز ServBay يمكنه الوصول لهدف الوكيل، لكن تظهر أخطاء عند الوصول عبر النطاق المحلي في المتصفح.

• تحقق من صيغة هدف الوكيل: تأكد من أن العنوان المدرج كهدف في إعدادات ServBay مكتوب بصيغة صحيحة وأن الجهاز قادر فعلًا على الوصول إليه. جرب استخدام الأمر curl [عنوان هدف الوكيل] في الطرفية للاختبار.
• فحص إعدادات الخادم الهدف: بعض خوادم الخلفية قد تتطلب قيمة محددة لرأس Host في الطلبات. افتراضيًا، يقوم ServBay بنقل رأس Host الأصلي إلى الخلفية. إذا كان الخادم يتطلب نطاقًا مختلفًا عما أدخلته في ServBay، قد تحدث أخطاء. يمكنك تعديل رؤوس الطلب المتقدمة من إعدادات ServBay المتقدمة (يتطلب غالبًا تحرير ملفات Caddyfile أو Nginx يدويًا).
• مراجعة جدار حماية الخادم الهدف: حتى لو كان جهازك يصل لـ IP والمنفذ بنجاح، قد يقيد جدار الحماية الخاص بالخادم اتصالاته بمصادر محددة فقط. تأكد من السماح للاتصالات من جهاز ServBay.

س: تظهر رسالة تحذير من الشهادة عند زيارة الموقع عبر HTTPS.

• استعمال ServBay CA: هذا طبيعي، حيث أن ServBay CA تعتبر مرجعًا خاصًا وليست معتمدة افتراضيًا من المتصفحات. ستحتاج لإضافة شهادة ServBay CA كموثوقة في النظام أو المتصفح من الإعدادات.
• استعمال ACME (Let's Encrypt): تأكد أن اسم النطاق مُوجَّه بشكل صحيح لجهاز ServBay، وأنك طلبت الشهادة من خلال منصة إدارة SSL في ServBay. لمزيد من التفاصيل ابحث في سجل ServBay عن أية رسائل خطأ أثناء الطلب.

س: كيف أربط هدفًا يتطلب رؤوس أو ملفات تعريف ارتباط خاصة؟

التهيئة الأساسية للوكيل العكسي في ServBay تقوم عادة بتحويل معظم معلومات الطلب، لكن في بعض السيناريوهات المعقدة—مثل الحاجة لإضافة رؤوس مخصصة، أو تعديل رؤوس الاستجابة، أو إدارة ملفات تعريف الارتباط، أو إعادة كتابة المسارات—ينبغي الانتقال لإعدادات ServBay المتقدمة وتحرير ملفات Caddyfile أو Nginx يدويًا للحصول على قواعد وكيل عكسي مخصصة. هذه العملية تتطلب إلمامًا مسبقًا بقواعد Caddy أو Nginx.

الخلاصة

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