إنشاء نفق HTTP
في هذه الصفحة 10 أقسام
يمنح نفق HTTP تطبيق ويب أو واجهة API أو مستقبِل webhook على جهازك عنوانًا عامًا بـ HTTPS. توفّر Localtonet الشهادة، لذا يمكن أن تبقى خدمتك المحلية على HTTP عادي.
قبل أن تبدأ #
- عميل Localtonet مثبّت على الجهاز ومتصل باستخدام AuthToken. إن لم يكن كذلك، فاتبع البدء السريع.
- خدمة الويب لديك تعمل وتعرف منفذها، مثل
3000. - لاستخدام نطاق فرعي مخصص أو نطاق مخصص: يلزم وجود رصيد في حسابك. وللحصول على نطاق مخصص تحتاج أيضًا إلى نطاق أضفته في مدير DNS. راجع النطاقات المخصصة.
الخطوات #
-
افتح صفحة HTTP #
افتح أنفاقي › HTTP ثم اختر إنشاء نفق HTTP لفتح النموذج.
-
اختر نوع الرابط #
نوع الرابط العنوان الذي تحصل عليه المتطلبات نطاق فرعي عشوائي اسم يُنشأ تلقائيًا على النطاق المحدد، مثل https://<RANDOM_NAME>.localto.net.لا شيء إضافي نطاق فرعي مخصص الاسم الذي تكتبه في النطاق الفرعي، مثل https://myapp.localto.net. يُسمح بالحروف والأرقام والشرطات.الرصيد نطاق مخصص نطاق خاص بك تختاره في النطاق. رصيد ونطاق في مدير DNS -
اختر الجهاز والمنطقة #
في توكن الجهاز اختر التوكن الذي يستخدمه تطبيق Localtonet على جهازك. وفي منطقة الخادم اختر منطقة قريبة من جهازك لتقليل زمن الاستجابة.
-
أدخل العنوان المحلي #
الحقل ما تدخله النطاق localto.netأو أحد نطاقاتك الخاصة. عند اختيار نطاق مخصص تحتوي القائمة على نطاقاتك أنت فقط.النطاق الفرعي لـ نطاق فرعي مخصص فقط: الاسم الذي يسبق النطاق. عنوان IP المحلي عنوان الخدمة على جهازك. استخدم 127.0.0.1لهذا الجهاز. يقبل النموذج عنوان IPv4 أو IPv6 أوlocalhost.المنفذ المحلي المنفذ الذي تستمع عليه خدمتك المحلية، من 1 إلى 65535. اختر إنشاء النفق. يظهر النفق ضمن أنفاقك باسم
Tunnel #متبوعًا برقمه. -
شغّل النفق #
اختر زر التشغيل في عمود الإجراءات. عند تشغيل النفق يصبح عنوانه في عمود الرابط رابطًا قابلًا للنقر. افتحه في المتصفح. أصبحت الطلبات إلى هذا العنوان تصل الآن إلى الخدمة على جهازك.
إذا كان تطبيق Localtonet الخاص بذلك التوكن غير متصل، يُعلمك مربع حوار بذلك. شغّل التطبيق، أو اختر التشغيل على أي حال فيبدأ النفق بالعمل عند اتصال التطبيق.
عنوانك العام #
- العنوان هو
https://متبوعًا باسم المضيف في عمود الرابط. - يحتفظ نفق HTTP بنطاقه الفرعي إلى أن تحذف النفق. لا يغيّره الإيقاف والتشغيل.
- لا يحتوي العنوان على رقم منفذ. يفتحه الزوار كما يفتحون أي موقع ويب آخر.
- تمر اتصالات WebSocket عبر نفق HTTP.
HTTPS والشهادات #
يصل الزوار إلى نفق HTTP عبر HTTPS بشهادة توفّرها Localtonet وتجدّدها. ينتهي TLS عند خادم Localtonet. ومن هناك يسافر الطلب عبر النفق إلى جهازك، ثم يمرّره تطبيق Localtonet إلى خدمتك.
| الإعداد | ما يفعله | متى تستخدمه |
|---|---|---|
| HTTPS فقط؟ | يقدّم الرابط العام عبر HTTPS فقط. يُعاد توجيه أي طلب إلى http:// إلى العنوان نفسه على https://. وعند إيقافه يستجيب العنوان على البروتوكولين. | فعّله لأي شيء يحمل بيانات تسجيل دخول أو بيانات خاصة. |
| تفعيل HTTP/3؟ | يتيح للعملاء الوصول إلى الرابط العام عبر HTTP/3. يكون مفعّلًا في النفق الجديد. | أوقفه فقط إذا واجه عميل مشكلة مع HTTP/3. |
| HTTPS المحلي؟ | يطلب من تطبيق Localtonet الاتصال بخدمتك المحلية عبر TLS. يقبل التطبيق شهادة الخدمة المحلية كما هي، لذا تعمل الشهادة الموقّعة ذاتيًا. | فعّله عندما تستخدم خدمتك المحلية HTTPS بنفسها، مثل خادم تطوير على https://localhost:5001. |
| الاتصال القديم؟ | يوصّل النفق بالطريقة القديمة بدلًا من الطريقة العادية. | جرّبه إذا تعذّر اتصال النفق بالطريقة العادية. |
تجد هذه المفاتيح ضمن الإعدادات في لوحة إعدادات النفق. يؤدي تغيير HTTPS المحلي؟ أو الاتصال القديم؟ في نفق قيد التشغيل إلى إعادة تشغيله، لذا يجب أن يكون تطبيق Localtonet متصلًا.
هل تحتاج إلى تشفير حتى خدمتك أنت؟ مع نفق HTTP تفكّ Localtonet تشفير الحركة عند خادمها. استخدم نفق TLS عندما يجب أن تقدّم خدمتك شهادتها الخاصة.
ترويسة Host #
تتلقى خدمتك اسم المضيف الذي استخدمه الزائر، وهو عنوان النفق. تختار بعض خوادم الويب المحلية الموقع حسب اسم المضيف فترد بموقع خاطئ أو بخطأ. في هذه الحالة افتح الترويسات في إعدادات النفق وأضف ترويسة طلب باسم Host بالاسم الذي يتوقعه خادمك. عندها تتلقى خدمتك هذا الاسم بدلًا من عنوان النفق. راجع الترويسات وإعادة الكتابة والمضيفات الافتراضية.
إعدادات نفق HTTP #
اختر زر الإعدادات في عمود الإجراءات لفتح لوحة إعدادات النفق. ضمن تفاصيل النفق يمكنك إعادة تسمية النفق وتغيير عنوان IP المحلي والمنفذ المحلي. يسرد الجدول ما يقدمه نفق HTTP أيضًا وأين يُشرح.
| الإعداد | ما يفعله | اقرأ المزيد |
|---|---|---|
| موازنة الحمل | وزّع الحركة على عدة أجهزة أو استخدم هدفًا احتياطيًا. | موازنة الحمل |
| عرض أمر SSH | شغّل هذا النفق عبر SSH العادي دون تثبيت تطبيق Localtonet. | SSH دون تثبيت |
| HTTPS فقط؟، تفعيل HTTP/3؟، HTTPS المحلي؟، الاتصال القديم؟ | كيف يتصل الزوار وخدمتك. | هذه الصفحة، أعلاه |
| إعادة كتابة المسار؟ | غيّر مسار الطلب قبل أن يصل إلى خدمتك المحلية. | الترويسات وإعادة الكتابة |
| الترويسات | أدر ترويسات طلبات واستجابات HTTP المخصصة لهذا النفق. | الترويسات وإعادة الكتابة |
| مهلة HTTP | حدّد المدة التي ينتظرها الخادم للحصول على استجابة من تطبيقك المحلي، من 1 إلى 600 ثانية. | الترويسات وإعادة الكتابة |
| المصادقة الأساسية؟ | اطلب من الزوار اسم مستخدم وكلمة مرور. | التحكم في الوصول |
| قيود IP | تحكّم في عناوين IP للعملاء المسموح لها بالوصول إلى هذا النفق. | التحكم في الوصول |
| مزوّدو SSO | يسجّل الزوار الدخول عبر أحد مزوّدي الهوية لديك قبل أن يتمكنوا من فتح النفق. يدير الزر SSO أعلى الصفحة المزوّدين. | تسجيل الدخول الموحّد |
| زر WAF في عمود الإجراءات | يفتح إعداد WAF. يبيّن الزر ما إذا كان جدار حماية تطبيقات الويب غير مهيّأ أو نشطًا أو غير نشط. | جدار حماية تطبيقات الويب |
| تاريخ الانتهاء، حدود السرعة، حد النطاق الترددي، استخدام النطاق الترددي، حركة النطاق الترددي | أوقف النفق في تاريخ معيّن، وحدّد سرعته، وحدّد حجم بياناته، وصفّر عدّاد البيانات، وتابع الحركة عبر الزمن. | الحدود وانتهاء الصلاحية |
| سجل الطلبات، سجل النشاط، صحة النفق | افحص الطلبات، وراجع عمليات التشغيل والإيقاف وتغييرات الإعدادات، وتابع فحوصات الصحة. | السجلات والفحص |
| الوسائط | مرّر هذا النفق عبر شبكة محددة على جهازك. | اختيار الشبكة |
| المنفذ الصادر | استخدم منافذ صادرة ثابتة لاتصال تطبيق Localtonet بالخادم، لجدران الحماية الصارمة. | المنافذ |
| ملاحظة النفق | احفظ ملاحظة خاصة تساعدك على التعرف على هذا النفق. | مرجع الإعدادات |
لا يظهر مزوّدو SSO للنفق الذي ينتمي إلى فريق.
أمثلة #
مشاركة تطبيق ويب #
يعمل تطبيقك على الحاسوب نفسه الذي يعمل عليه عميل Localtonet ويستمع إلى المنفذ 3000.
| الحقل | القيمة |
|---|---|
| نوع الرابط | نطاق فرعي عشوائي |
| النطاق | localto.net |
| عنوان IP المحلي | 127.0.0.1 |
| المنفذ المحلي | 3000 |
أنشئ النفق وشغّله وأرسل العنوان الموجود في عمود الرابط إلى من تريد أن يروا التطبيق. ولطلب كلمة مرور منهم أولًا، فعّل المصادقة الأساسية؟.
إذا كان التطبيق يعمل على جهاز آخر في شبكتك، فأدخل عنوان ذلك الجهاز في عنوان IP المحلي، مثل 192.168.1.20. يجب أن يتمكن الجهاز الذي يشغّل عميل Localtonet من الوصول إليه.
استقبال webhooks #
يحتاج مزوّد webhook إلى عنوان HTTPS عام يرسل إليه الأحداث. أنشئ نفق HTTP إلى منفذ المستقبِل لديك، وشغّله، ثم أدخل عند المزوّد عنوان النفق مضافًا إليه مسار نقطة النهاية لديك:
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>اختبره من أي حاسوب:
curl -X POST https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH> \
-H "Content-Type: application/json" \
-d '{"event":"test"}'لمعرفة ما وصل، اختر الأيقونة في عمود Webhooks الخاص بالنفق (عرض سجلات الطلبات والاستجابات). يجب تشغيل النفق أولًا. راجع السجلات والفحص.
في الخطة المجانية، أضف رصيدًا قبل أن تعتمد على webhooks. تحصل الطلبات الموجهة إلى نفق HTTP لحساب مجاني على صفحة تحذير أولًا، ولا يستطيع مزوّد webhook تجاوزها بالنقر. راجع القسم التالي.
صفحة التحذير في الخطة المجانية #
عندما لا يملك الحساب رصيدًا، يرى الزائر الذي يفتح نفق HTTP الخاص به لأول مرة صفحة من Localtonet بعنوان "You are about to navigate to:" مع الزرين Cancel وVisit Site. الغرض من الصفحة ردع إساءة الاستخدام. يخزّن Visit Site ملف تعريف ارتباط في متصفح الزائر ويفتح موقعك. وما دام المتصفح يحتفظ بهذا الملف فلا يُسأل مرة أخرى.
تذكر الصفحة نفسها طريقتين لإزالتها:
- أرسل ترويسة طلب باسم
localtonet-skip-warningبأي قيمة. يناسب هذا نصوصك البرمجية وعملاء API الخاصين بك. - أضف رصيدًا إلى حسابك. راجع الخطط والرصيد.
curl -H "localtonet-skip-warning: 1" https://<YOUR_SUBDOMAIN>.localto.net/استكشاف الأخطاء وإصلاحها #
يقول مربع الحوار إن التوكن غير متصل، أو تظهر لي رسالة «تطبيق Localtonet الخاص بـ AuthToken … غير متصل.»
عميل Localtonet الذي يستخدم توكن هذا النفق لا يعمل أو لا يستطيع الوصول إلى Localtonet. شغّل العميل على الجهاز الذي يحمل التوكن نفسه. يشغّل مربع الحوار النفق تلقائيًا بمجرد اتصال التطبيق. أما مع التشغيل على أي حال فيُفعَّل النفق ويبدأ العمل لاحقًا.
«شغّل تطبيق Localtonet أو حدّثه.»
تعذّر تشغيل النفق على الجهاز. تأكد من أن العميل يعمل، وثبّت الإصدار الحالي من صفحة التنزيلات إذا كان قديمًا.
يعرض المتصفح "Tunnel Recently Started or Stopped"
وصل الطلب إلى Localtonet، لكن النفق لا يقبل اتصالات. فقد بدأ تشغيله للتو أو هو متوقف. تحقّق من أنه قيد التشغيل ومن أن عمود الاتصال يعرض مفعّل، ثم أعد تحميل الصفحة.
يعرض المتصفح صفحة خطأ من Localtonet تذكر عنواني المحلي
تذكر الصفحة أن الحركة نُقلت عبر النفق إلى وكيل Localtonet، لكن الوكيل فشل في الاتصال بالخدمة الأصلية عند عنوان IP والمنفذ المحليين لديك. العنوان الرئيسي هو الخطأ، مثل ConnectionRefused. لا شيء يستمع على ذلك العنوان. شغّل خدمتك، ثم تحقّق من عنوان IP المحلي والمنفذ المحلي ضمن تفاصيل النفق. يمكنك اختبار الخدمة على الجهاز نفسه بفتح العنوان المحلي في المتصفح.
«تحتاج إلى شراء رصيد لاستخدام هذه الميزة.»
يتطلب نطاق فرعي مخصص ونطاق مخصص وجود رصيد. استخدم نطاق فرعي عشوائي، أو أضف رصيدًا ضمن الرصيد.
«تحتاج إلى رصيد إجمالي قدره … لإنشاء نفق آخر من هذا النوع.»
لا يغطي رصيدك نفقًا آخر. في الخطة المجانية يمكنك إنشاء نفق واحد فقط في المجموع، مهما كان نوعه. احذف نفقك الحالي قبل إنشاء آخر، أو أضف رصيدًا.
«… موجود بالفعل.» أو «… غير مسموح به.»
نفق آخر يستخدم هذا النطاق الفرعي، أو أن الاسم محجوز لدى Localtonet. اختر نطاقًا فرعيًا مختلفًا.
«تحذير! ليس لديك أي نطاق!»
اخترت نطاق مخصص لكنك لم تضف نطاقًا بعد. أضفه أولًا في مدير DNS. وإذا ظهرت لك رسالة «… مستخدم بالفعل بواسطة نفق آخر.» فهذا النطاق تابع بالفعل لأحد أنفاقك. يمكن لنطاق مخصص واحد أن يخدم نفقًا واحدًا.
«حدّث حد النطاق الترددي أو امسح استخدام النطاق الترددي.» أو «حدّث تاريخ الانتهاء.»
بلغ النفق حد النطاق الترددي الخاص به أو تاريخ انتهائه ولا يمكنه البدء. غيّر الحد أو التاريخ في إعدادات النفق، أو صفّر العدّاد عبر استخدام النطاق الترددي. راجع الحدود والانتهاء.
«تحقّق من اتصال الجهاز.»
غيّرت إعدادًا يعيد تشغيل النفق القيد التشغيل بينما كان تطبيق Localtonet غير متصل. وصّل التطبيق ثم احفظ الإعداد مرة أخرى، أو أوقف النفق أولًا.
يرد تطبيقي بالموقع الخاطئ، أو ينشئ روابط وعمليات إعادة توجيه بـ http://
يقرر تطبيقك بناءً على اسم المضيف أو المخطط الذي يتلقاه. ضمن الترويسات، أضف ترويسة طلب Host إذا كان التطبيق يتوقع اسم مضيف ثابتًا. وأضف ترويسة طلب X-Forwarded-Proto بالقيمة https لإخبار التطبيق بأن الزوار يستخدمون HTTPS، فيُنشئ روابط وعمليات إعادة توجيه بـ https://.