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

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

المبدأ التقني

يقوم Ngrok بإنشاء اتصال نفق مشفر، مما يتيح خدمات محلية مستضافة خلف NAT/جدار ناري أن يتم عرضها عبر اسم مجال عام. في سياق تطبيق ServBay، تتيح هذه الخطة للمطورين نشر خدمات الويب المحلية في الوقت الفعلي لسهولة التعاون بين الفرق والاختبار عن بُعد.

تجهيز البيئة

1. تثبيت عميل Ngrok

اتبع الخطوات التالية لإكمال نشر أداة CLI لـ Ngrok:

1. زيارة صفحة التنزيل الرسمية للحصول على حزمة التثبيت المناسبة للنظام

2. فك الضغط والتوزيع في دليل PATH للنظام (كمثال لنظام macOS ARM):

   sudo unzip ~/Downloads/ngrok-v3-stable-darwin-arm64.zip -d /usr/local/bin

3. تحقق من سلامة التثبيت:

   ngrok version
   # ngrok version 3.5.0

إعداد النفق

شرح المعلمات الأساسية

هيكل الأمر القياسي لتنفيذ خريطة الخدمة هو كما يلي:

ngrok http --domain=<NGROK_DOMAIN> <LOCAL_ENDPOINT> \
  --request-header-add='host: <VIRTUAL_HOST>'

مكونات المعلمة	شرح الوظيفة
http	إعلان نفق بروتوكول HTTP
--domain	تحديد اسم النطاق الثابت المخصص من قبل Ngrok (يجب استبداله باسم المجال الفعلي)
<LOCAL_ENDPOINT>	عنوان خدمة ServBay المحلية (افتراضيًا https://servbay.host)
--request-header-add	إعادة كتابة رأس Host لضمان توجيه الطلبات بشكل صحيح

مثال على الإعداد

افترض أنك بحاجة إلى خريطة الخدمة المحلية servbay.local إلى اسم المجال العام cunning-lacewing-fresh.ngrok-free.app. نفذ الأمر:

ngrok http --domain=cunning-lacewing-fresh.ngrok-free.app https://servbay.local \
  --request-header-add='host: servbay.local'

بعد التنفيذ الناجح، ستظهر حالة النفق في الطرفية، بما في ذلك عنوان الوصول العام ومراقبة حركة المرور في الوقت الفعلي.

التحقق من الخدمة

بعد الانتهاء من الإعداد، تحقق من ذلك باتباع الخطوات التالية:

4. الوصول إلى اسم نطاق Ngrok عبر المتصفح:

   https://cunning-lacewing-fresh.ngrok-free.app

5. النتيجة المتوقعة:

   • عرض محتوى الويب الذي يتطابق مع الخدمة المحلية
   • علامة أمان اتصال HTTPS فعالة
   • زمن الاستجابة في النطاق المعقول (عادةً <500ms)

صورة: الصفحة التي تم الوصول إليها عبر Ngrok

تقنيات متقدمة

6. إدارة النطاقات:

   • تقديم طلب لنطاق مخصص عبر لوحة تحكم Ngrok
   • يمكن لمستخدمي الشركات ربط النطاقات الخاصة بهم (يتطلب ترقية الخطة المدفوعة)

7. تعيين خدمات متعددة:

   # تعيين خدمات HTTP/HTTPS في وقت واحد
   ngrok http --domain=your-domain.ngrok.app 80
   ngrok tls --domain=your-domain.ngrok.app 443

8. أوامر التشخيص:

   ngrok config check    # تحقق من ملف الإعدادات
   ngrok logs            # عرض السجلات في الوقت الفعلي

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

الظاهرة	الحلول
انتهاء المهلة في الاتصال	تحقق من حالة خدمة ServBay وحالة منفذها
خطأ في شهادة HTTPS	تأكد من أن إعدادات --request-header-add صحيحة
انقطاع متقطع	تحقق من استقرار الشبكة، يفضل استخدام اتصال سلكي

ملخص الحل

من خلال خطة وكيل Ngrok، يمكن للمطورين بسرعة إنشاء قناة وصول عامة آمنة في بيئة ServBay. تتمتع هذه الإعدادات بالميزات التالية:

• تحويل الخدمة دون تعديل الشيفرة
• دعم مراقبة حركة المرور وتحليلها في الوقت الفعلي
• توفير حماية أمان على مستوى المؤسسات (يتطلب إعداد سياسات الوصول)

يُنصح باستخدام خطة Ngrok المدفوعة في بيئات الإنتاج للحصول على ضمان خدمة أكثر استقرارًا.