دليل تكوين خدمة الوكيل العكسي Ngrok في ServBay

يُعد Ngrok أداة قوية تتيح لك عرض خدمات الويب المحلية بأمان على الإنترنت العام. من خلال دمجه مع ServBay، يمكنك إنشاء نفق عام آمن لموقعك المطوّر محليًا بسهولة، وهذا مثالي لعروض المشاريع، اختبار Webhook أو مشاركة نتائج التطوير مع أعضاء الفريق خارج المؤسسة. يوضح هذا الدليل كيفية إعداد واستخدام خدمة الوكيل العكسي Ngrok في ServBay خطوة بخطوة.

نظرة عامة

يقدم ServBay دعمًا مدمجًا لـ Ngrok، ما يُبسّط عملية التثبيت والإعداد. يمكنك إدارة أنفاق Ngrok مباشرة من واجهة ServBay الرسومية وربط أي موقع محلي مستضاف على ServBay بعنوان URL عام مؤقت.

سيناريوهات الاستخدام

• عرض العملاء: عرض المواقع قيد التطوير التي تعمل على جهاز الكمبيوتر المحلي الخاص بك للعملاء.
• تطوير Webhook: اختبار خدمات طرف ثالث تتطلب عنوان رد نداء عام (مثل بوابات الدفع وواجهات API).
• اختبار تطبيقات الجوال: السماح للأجهزة المحمولة بالوصول إلى API خلفية محلية عبر عنوان عام.
• تطوير تعاوني: مشاركة البيئة المحلية مؤقتًا مع أعضاء الفريق.

المتطلبات الأساسية

1. تثبيت ServBay: تأكد من أن ServBay تم تثبيته ويعمل بنجاح على نظام macOS الخاص بك.
2. حساب Ngrok: تحتاج إلى حساب Ngrok. يمكنك زيارة الموقع الرسمي لـ Ngrok للتسجيل مجانًا أو باشتراك مدفوع.
3. موقع محلي: يجب أن يكون لديك موقع واحد على الأقل مضاف ويعمل في ServBay، مثل servbay.demo.

خطوات الإعداد

1. تثبيت حزمة Ngrok في ServBay

قبل الاستخدام الأول لـ Ngrok، عليك تثبيته من خلال ServBay:

1. افتح تطبيق ServBay.
2. في الشريط الجانبي الأيسر، انقر على الحزم (Packages).
3. في قائمة الحزم، ابحث عن Ngrok.
4. انقر على زر التثبيت بجوار Ngrok.
5. بعد الانتهاء من التثبيت، حاول تشغيل Ngrok من خلال الضغط على مفتاح التشغيل بجانبه. من المتوقع ظهور فشل في التشغيل أو حالة غير طبيعية لأن Ngrok لم يُضبط بعد؛ هذا سلوك طبيعي وسيتم معالجته في الخطوات التالية.

2. الحصول على Ngrok Authtoken الخاص بك

يستخدم Ngrok Authtoken للتحقق من هويتك وتخويل استخدام الخدمة.

1. انتقل إلى لوحة تحكم Ngrok وسجّل الدخول لحسابك.

2. بعد تسجيل الدخول، ابحث في القائمة الجانبية عن Your Authtoken (من "Getting Started" -> "Your Authtoken").

3. انسخ Authtoken الخاص بك. إنه سلسلة طويلة من الأحرف، احفظها بشكل آمن.

   

3. تكوين Ngrok في ServBay

بعد الحصول على Authtoken، عد إلى ServBay لمتابعة الإعداد:

1. من الشريط الجانبي الأيسر في ServBay، انقر على Tunnel.

2. من قائمة خدمات النفق، اختر ngrok.

   

3. Auth Token (رمز التفويض):

   • الصق Authtoken المنسوخ في حقل الإدخال المخصص لـ Auth Token.

4. تكوين النفق (النطاق المحلي والنطاق الخارجي): يتيح لك ServBay إنشاء أنفاق Ngrok متعددة لمواقعك المحلية.

   • Local Domain (الموقع المحلي):
     • اختر الموقع المحلي الذي تريد نشره للعامة بواسطة Ngrok من القائمة المنسدلة. يتم تحديث هذه القائمة تلقائيًا حسب المواقع المضافة في ServBay، مثل servbay.test أو servbay.demo.
   • External Domain (النطاق الخارجي):
     • لمستخدمي Ngrok المجانيين: يرجى ترك هذا الحقل فارغًا. سيقوم Ngrok تلقائيًا بإنشاء عنوان URL عشوائي عام ينتهي عادة بـ .ngrok-free.app (أو لاحقة نطاق مجانية أخرى). سيظهر هذا الـ URL بمجرد نجاح تشغيل النفق في ServBay تلقائيًا.
     • لمستخدمي Ngrok المدفوعين: إذا كان لديك نطاقات مخصصة أو محجوزة تم تهيئتها بحسابك في Ngrok، يمكنك إدخال النطاق الخارجي المطلوب هنا.

5. إضافة المزيد من الأنفاق:

   • لإنشاء أنفاق إضافية لمواقع محلية أخرى، انقر على زر + بجوار الأنفاق الحالية وأعد تنفيذ الخطوة 4 لتكوين الموقع المحلي والنطاق الخارجي الجديدين.

6. حفظ الإعدادات:

   • بعد الانتهاء من جميع التعديلات، انقر على زر حفظ (Save) الموجود في الركن السفلي الأيمن.

4. تشغيل والتحقق من خدمة Ngrok

1. عند حفظ الإعدادات، سيحاول ServBay تشغيل خدمة Ngrok باستخدام الإعداد الجديد.
2. راقب مؤشر الحالة بجوار خدمة ngrok. إذا كان كل شيء مضبوطًا بشكل صحيح وتم الاتصال بنجاح، يتحول المؤشر إلى اللون الأخضر للدلالة على أن الخدمة تعمل.
3. في كل سجل نفق ناجح، سيعرض حقل External Domain (إذا تُرك فارغًا من قبل) عنوان URL العام الذي منحته Ngrok.
4. التحقق من الوصول:
   • يمكنك نسخ عنوان الـ URL بالنقر على أيقونة النسخ بجانبه.
   • أو الضغط على أيقونة المتصفح (عادة شكل بوصلة أو كرة أرضية) لفتح العنوان العام مباشرة في المتصفح الافتراضي.
   • إذا تمت العملية بنجاح، عليك أن تكون قادرًا على الوصول لموقعك المحلي عبر عنوان Ngrok.

5. إدارة أنفاق Ngrok

ضمن واجهة إدارة Ngrok في ServBay:

• نسخ النطاق الخارجي: اضغط على أيقونة النسخ لسهولة المشاركة.
• الفتح في المتصفح: انقر على أيقونة المتصفح للاختبار السريع.
• إضافة نفق: انقر على أيقونة +.
• حذف نفق: انقر على أيقونة - لإزالة تكوينات الأنفاق غير المرغوبة.
• إيقاف الخدمة: يمكنك تبديل مفتاح خدمة ngrok لإيقافها بالكامل. ويمكن إعادة تشغيلها عند الحاجة.

ملاحظات هامة

• قيود النسخة المجانية من Ngrok: تولّد النسخة المجانية من Ngrok نطاقات خارجية عشوائية وديناميكية قد تتغير مع كل إعادة تشغيل للخدمة أو النفق. توجد أيضًا حدود على عدد الاتصالات، النطاق الترددي ومدة الاستخدام. للحصول على نطاق ثابت ووظائف متقدمة، يُنصح بالترقية إلى خطة مدفوعة.
• حالة المواقع المحلية: تأكد أن الموقع المحلي المختار في Local Domain يعمل بشكل طبيعي على ServBay (أي أن إصدار PHP أو خادم الويب كـ Nginx/Apache نشط والإعدادات صحيحة). يقوم Ngrok فقط بتمرير الحركة ولا يمكنه تشغيل أو إصلاح خدماتك المحلية.
• الجدران النارية: تأكد أن جدار الحماية في macOS أو أي برامج أمان طرف ثالث لا يمنع اتصال ServBay أو Ngrok بالإنترنت.
• HTTPS: يدعم Ngrok افتراضيًا تشفير HTTPS للأنفاق، وهو أمر مفيد جدًا في تطوير واختبار تطبيقات الويب الحديثة.

الأسئلة الشائعة (FAQ)

• س: فشل تشغيل خدمة Ngrok ويكون مؤشر الحالة أحمر أو برتقالي، ماذا أفعل؟
  • ج: تحقق أولاً أن Authtoken تم إدخاله بشكل صحيح. ثم تأكد من وجود اتصال إنترنت عندك وإمكانية الوصول لموقع Ngrok الرسمي. راجع سجل Ngrok (يوجد رمز log بجانب الخدمة) لمزيد من التفاصيل حول الخطأ.
• س: أنا مستخدم نسخة Ngrok المجانية، لماذا حقل External Domain فارغ أو يظهر رسالة "Leave blank if you're a free user"؟
  • ج: هذا طبيعي لمستخدمي النسخة المجانية. لا حاجة لإدخال أي قيمة في هذا الحقل. عند تشغيل النفق بنجاح، سيجلب ServBay عنوان URL العام العشوائي من Ngrok تلقائيًا ويعرضه هناك.
• س: هل يمكنني استخدام Ngrok مع خدمات أنفاق أخرى مثل frp أو Cloudflared معًا؟
  • ج: يسمح لك ServBay بتثبيت وإعداد عدة خدمات أنفاق. عادة يمكنك اختيار تفعيل واحدة أو أكثر بناءً على احتياجك. لكن تشغيل عدة خدمات أنفاق على نفس الموقع المحلي قد يعقّد الإعداد أو يؤدي إلى تعارضات، لذا كن حذرًا.

الخلاصة

توفر لك تكامل ServBay مع Ngrok تجربة سهلة وفعّالة لنشر بيئة التطوير المحلية على macOS على الإنترنت العام. سواءً للعروض السريعة، اختبار Webhook أو التعاون مع الآخرين، يجمع هذا التكامل بين الأمان وسهولة الاستخدام. تذكر تهيئة النطاق الخارجي بما يناسب نوع حسابك في Ngrok (مجاني أو مدفوع) والتأكد من أن خدماتك المحلية تعمل بشكل جيد دائمًا.