دليل إعداد خدمة البروكسي العكسي Pinggy في ServBay

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

نظرة عامة

يوفر ServBay دعمًا مدمجًا لـ Pinggy، ما يجعل التثبيت والإدارة في غاية السهولة. يمكنك التحكم في نفق Pinggy مباشرة من واجهة ServBay الرسومية، وربط المواقع المحلية المستضافة على ServBay بعنوان URL عام للوصول عليه من الإنترنت.

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

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

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

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

خطوات التنفيذ

1. تثبيت حزمة Pinggy داخل ServBay

إذا كنت تستخدم Pinggy لأول مرة عبر ServBay، يجب عليك تثبيت الحزمة أولاً:

1. افتح تطبيق ServBay.

2. من الشريط الجانبي الأيسر، انقر على الحزم (Packages).

3. من قائمة الحزم المتاحة، ابحث أو اعثر على Pinggy.

4. انقر زر التثبيت بجوار Pinggy.

5. بعد انتهاء التثبيت، يمكنك محاولة تشغيل الخدمة من زر التبديل بجوار Pinggy. إذا فشل بدء الخدمة أو ظهرت الحالة غير طبيعية، فهذا أمر طبيعي في هذه المرحلة لأن Pinggy لم يُضبط بعد. سنكمل ضبط الإعدادات في الخطوات التالية.

   

2. الحصول على رمز وصول Pinggy الخاص بك

يستخدم Pinggy رمز الوصول للتحقق من حسابك وتفعيل خدمة النفق.

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

2. بعد تسجيل الدخول بنجاح، ستجد عادة رمز الوصول الخاص بك في قسم "Access token" بالصفحة الرئيسية للوحة التحكم.

3. انسخ هذا الرمز. هو عبارة عن سلسلة من الحروف، يرجى حفظها بأمان.

   

3. إعداد Pinggy داخل ServBay

بعد حصولك على رمز الوصول، عُد إلى تطبيق ServBay لإتمام الإعداد:

1. من الشريط الجانبي الأيسر في ServBay، اختر Tunnel.

2. من قائمة خدمات النفق، انقر على Pinggy.

   

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

   • في حقل الإدخال Auth Token، الصق بدقة رمز الوصول الذي نسخته من لوحة تحكم Pinggy.

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

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

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

   • لإعداد نفق جديد لموقع محلي آخر، انقر على رمز + (زائد) بجوار أي نفق موجود. ثم كرر الخطوة 4 لإعداد النفق الجديد.

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

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

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

1. بعد حفظ الإعدادات، سيحاول ServBay تشغيل خدمة Pinggy باستخدام الإعدادات الجديدة.
2. راقب مؤشر الحالة بجانب خدمة Pinggy في قائمة Tunnel. إذا كانت الإعدادات صحيحة واتصل Pinggy بنجاح بسيرفراته، يجب أن يتحول المؤشر إلى اللون الأخضر، مما يدل على أن الخدمة تعمل.
3. لكل نفق تم تشغيله بنجاح، إذا كان حقل External Domain فارغًا من قبل، سيظهر الآن عنوان URL عام خصصه Pinggy لك، مثل https://random-string.a.free.pinggy.link.
4. التحقق من الوصول:
   • انقر على رمز النسخ بجوار اسم النطاق الخارجي لنسخ العنوان العام.
   • أو، انقر على رمز المتصفح (عادة أيقونة بوصلة أو كرة أرضية) لفتح العنوان فورًا في متصفحك الافتراضي.
   • إذا كان كل شيء صحيحًا، ينبغي أن ترى موقعك المحلي عبر هذا الرابط من Pinggy.

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

من واجهة إعداد Pinggy في ServBay، يمكنك إدارة الأنفاق بسهولة:

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

ملاحظات هامة

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

الأسئلة المتكررة (FAQ)

• س: فشل بدء خدمة Pinggy ولم يتحول مؤشر الحالة إلى الأخضر، ماذا أفعل؟
  • ج: تأكد أولًا من صحة رمز الوصول المدخل تمامًا. ثانيًا تحقق من اتصالك بالإنترنت. راجع سجل عميل Pinggy (أيقونة السجل على يمين الخدمة) فقد تجد رسالة خطأ توضح المشكلة تحديدًا.
• س: لماذا يطلب مني ترك حقل "External Domain" فارغًا كمستخدم لخطة Pinggy المجانية؟
  • ج: هكذا تعمل الخدمة المجانية من Pinggy. ليس عليك إدخال نطاق خارجي بنفسك. عند نجاح النفق يستلم ServBay تلقائيًا عنوان URL عام مؤقت من خوادم Pinggy ويعرضه ضمن هذا الحقل.
• س: ما الفرق بين Pinggy وخدمات النفق الأخرى مثل Ngrok؟ أيّ منها أختار؟
  • ج: كل من Pinggy وNgrok من أدوات اختراق الشبكة المحلية الممتازة، لكنهما يختلفان في بعض الميزات، حدود الخطط المجانية، الأسعار، سهولة الإعداد وتوزيعة الخوادم. Pinggy معروف ببساطته وخفته. يمكنك اختيار الأداة الأنسب طبقًا لاحتياجاتك (هل تحتاج دعم لبروتوكولات معينة، نطاقات مخصصة، ميزانية... إلخ) وتفضيلاتك الشخصية. يوفر ServBay دعمًا لعدة أدوات مشابهة ليمنحك المرونة.

الخلاصة

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