الترويسات وإعادة كتابة المسار وخيارات HTTP
في هذه الصفحة 11 قسمًا
- قبل أن تبدأ
- ترويسات HTTP
- إضافة ترويسة
- اختر نوع الترويسة
- أضف الترويسة
- الحفظ
- مجموعات جاهزة
- الترويسات المقترحة
- القواعد
- ترويسة Host
- إعادة كتابة المسار
- حوّل «إعادة كتابة المسار؟» إلى «نعم»
- أدخل المسار المراد إضافته
- الحفظ
- مهلة HTTP
- HTTPS فقط؟
- تفعيل HTTP/3؟
- أمثلة
- السماح لتطبيق ويب على موقع آخر باستدعاء API الخاص بك
- انشر تطبيقًا يعمل تحت مسار فرعي
- الإعدادات نفسها عبر API
- استكشاف الأخطاء وإصلاحها
- صفحات ذات صلة
غيّر طريقة مرور طلبات HTTP واستجاباتها عبر النفق: أضف ترويسات ثابتة، وعيّن ترويسة Host التي تستلمها خدمتك، وضع مسارًا أمام كل طلب، واضبط مهلة الطلب، واختر HTTPS فقط أو HTTP/3 للعنوان العام.
قبل أن تبدأ #
- نفق HTTP. راجع HTTP / HTTPS.
- توجد الإعدادات في لوحة إعدادات النفق: افتح أنفاقي › HTTP وحدد الإعدادات في صف النفق.
| الإعداد | HTTP | بوابة MCP |
|---|---|---|
| الترويسات | نعم | – |
| إعادة كتابة المسار؟ | نعم | – |
| مهلة HTTP | نعم | نعم |
| HTTPS فقط؟ | نعم | نعم |
| تفعيل HTTP/3؟ | نعم | نعم |
لا يعيد أي من هذه الإعدادات تشغيل النفق. يُطبَّق التغيير على النفق العامل فور حفظه.
ترويسات HTTP #
يفتح الترويسات › إدارة نافذة ترويسات HTTP. وهي تضيف ترويسات ثابتة إلى الحركة التي تمر عبر النفق:
- ترويسات الطلب تصل إلى خدمتك المحلية مع كل طلب.
- ترويسات الاستجابة تصل إلى الزائر مع كل استجابة.
تُرسل القيم تمامًا كما تكتبها.
إضافة ترويسة #
-
اختر نوع الترويسة #
حدد ترويسات الطلب أو ترويسات الاستجابة أعلى النافذة. يعرض كل تبويب عدد الترويسات فيه.
-
أضف الترويسة #
حدد إضافة ترويسة واملأ الاسم والقيمة، أو حدد اسمًا تحت اقتراحات للحصول على صف بقيمة بداية معقولة. وللترويسة التي تعرفها النافذة، تشرح أيقونة المعلومات في الصف وظيفتها.
-
الحفظ #
حدد حفظ. ولإزالة ترويسة، حدد زر الإزالة في صفها، ثم حفظ.
مجموعات جاهزة #
في تبويب ترويسات الاستجابة، تضيف مجموعات جاهزة مجموعة ترويسات بخطوة واحدة. وتقول النافذة عندئذ «تمت إضافة NAME. تحقّق من القيم، ثم احفظ.» وتملأ المجموعة ترويسة موجودة في القائمة فقط إذا كانت قيمتها فارغة.
| المجموعة | الترويسات التي تضيفها | تُستخدم من أجل |
|---|---|---|
| السماح بـ CORS |
| تتيح لتطبيقات الويب على مواقع أخرى استدعاء هذا النفق. |
| ترويسات الأمان |
| HSTS وnosniff وحماية الإطارات وسياسة المُحيل. |
| إيقاف التخزين المؤقت | Cache-Control: no-store | تمنع المتصفحات والبروكسيات من تخزين الاستجابات مؤقتًا. |
| الإخفاء عن محركات البحث | X-Robots-Tag: noindex, nofollow | تطلب من محركات البحث عدم إدراج هذا العنوان. |
الترويسات المقترحة #
| الترويسة | النوع | ما تقوله النافذة عنها |
|---|---|---|
Host | الطلب | تستلم خدمتك اسم المضيف هذا بدل عنوان النفق. مفيد عندما يختار خادم ويب محلي الموقع حسب اسم المضيف. |
Authorization | الطلب | ترسل بيانات الاعتماد نفسها إلى خدمتك مع كل طلب. |
X-API-Key | الطلب | مفتاح ثابت للخدمات التي تتوقع مفتاحًا في ترويسة. |
X-Forwarded-Proto | الطلب | تخبر تطبيقك بأن الزوار يستخدمون HTTPS، فيبني روابط وعمليات إعادة توجيه بـ https://. |
Origin | الطلب | بعض الخدمات لا تقبل إلا الطلبات من أصل معروف. |
Access-Control-Allow-Origin | الاستجابة | أي المواقع يجوز لها استدعاء هذا النفق من المتصفح. * تسمح بأي موقع. |
Access-Control-Allow-Credentials | الاستجابة | تتيح للمتصفحات إرسال ملفات تعريف الارتباط. ولا تعمل مع Access-Control-Allow-Origin: *. |
Strict-Transport-Security | الاستجابة | تخبر المتصفحات بأن تستخدم HTTPS دائمًا لهذا العنوان. |
X-Frame-Options | الاستجابة | تمنع المواقع الأخرى من عرض صفحاتك داخل إطار. |
Content-Security-Policy | الاستجابة | تتحكم في المصادر التي يجوز للصفحات تحميل السكربتات والأنماط والصور منها. قد تعطّل السياسة الصارمة الصفحات، فاختبرها. |
Cache-Control | الاستجابة | no-store تمنع المتصفحات والبروكسيات من تخزين الاستجابات مؤقتًا. |
X-Robots-Tag | الاستجابة | تطلب من محركات البحث عدم إدراج هذا العنوان. |
تشمل الاقتراحات أيضًا User-Agent وAccept-Language وCache-Control للطلبات، وAccess-Control-Allow-Methods وAccess-Control-Allow-Headers وX-Content-Type-Options وReferrer-Policy وPermissions-Policy للاستجابات. ويمكنك كتابة أي اسم ترويسة آخر.
القواعد #
- يمكن أن تحتوي أسماء الترويسات على أحرف وأرقام وشرطات، مثل
X-Api-Key، وطولها حتى 256 حرفًا. - يمكن أن يظهر الاسم مرة واحدة في كل تبويب. والصف الثاني بالاسم نفسه يُرفض مع الرسالة «NAME موجودة بالفعل في هذه القائمة.»
- يحتاج الصف إلى اسم. ويُتجاهل الصف الفارغ عند الحفظ.
ترويسة Host #
تستلم خدمتك افتراضيًا عنوان النفق كاسم مضيف الطلب. لإرسال اسم مضيف آخر، أضف ترويسة الطلب Host في نافذة ترويسات HTTP وعيّن قيمتها إلى الاسم الذي تتوقعه خدمتك، مثل localhost أو shop.internal.
استخدم هذا عندما يختار خادم ويب محلي الموقع حسب اسم المضيف، مثل مضيف افتراضي في Apache أو nginx، أو IIS مع ربط المضيفات، أو خادم تطوير لا يجيب إلا عن localhost. راجع المضيفات الافتراضية لمثال كامل.
إعادة كتابة المسار #
تضيف إعادة كتابة المسار مسارًا أمام كل طلب قبل أن يصل إلى خدمتك المحلية. ويواصل الزوار استخدام العنوان القصير.
-
حوّل «إعادة كتابة المسار؟» إلى «نعم» #
تُفتح نافذة إعادة كتابة المسار.
-
أدخل المسار المراد إضافته #
اكتبه في المسار المُضاف، مثل
/apiأو/app/v2، أو حدد أحد مسارات شائعة. يبدأ المسار بشرطة مائلة؛ وإذا حذفتها تُضاف لك. ويعرض مربع مثال النتيجة لطلب تجريبي. -
الحفظ #
حدد حفظ.
مع /api كمسار:
| يفتح الزائر | تستلم خدمتك |
|---|---|
https://<YOUR_TUNNEL_ADDRESS>/orders?id=7 | /api/orders?id=7 |
للنفق مسار واحد، بطول حتى 200 حرف. ولا يجوز أن يحتوي مسافات ولا أن يكون / وحدها. لإزالته، حوّل إعادة كتابة المسار؟ إلى لا وأكّد إيقاف إعادة كتابة المسار؟: يُحذف المسار المحفوظ وتصل الطلبات إلى خدمتك بمسارها الأصلي.
مهلة HTTP #
يفتح مهلة HTTP › إدارة نافذة مهلة الطلب. المهلة هي المدة التي ينتظرها النفق لتجيب خدمتك عن طلب. وبعدها يتلقى الزائر خطأ مهلة.
| العنصر | القيم |
|---|---|
| المهلة | عدد صحيح من 1 إلى 600 ثانية. اتركه فارغًا لاستخدام افتراضي الخادم. |
| قيم جاهزة | افتراضي الخادم، 30 s، 1 min، 2 min، 5 min، 10 min |
ارفع المهلة للتقارير البطيئة أو الرفع الكبير أو الاستطلاع الطويل. واختر افتراضي الخادم للعودة إلى القيمة القياسية.
HTTPS فقط؟ #
حوّل HTTPS فقط؟ إلى نعم وأكّد تفعيل HTTPS فقط؟ لتقديم الرابط العام عبر HTTPS فقط. استخدمه لكل ما يحمل تسجيلات دخول أو بيانات شخصية، حتى لا يصل أحد إلى النفق عبر HTTP العادي.
تفعيل HTTP/3؟ #
حوّل تفعيل HTTP/3؟ إلى نعم لتتيح للعملاء الوصول إلى الرابط العام عبر HTTP/3. وتواصل العملاء التي لا تدعم HTTP/3 استخدام إصدارات HTTP الأقدم.
أمثلة #
السماح لتطبيق ويب على موقع آخر باستدعاء API الخاص بك #
تعمل واجهتك الأمامية على https://app.example.com وتستدعي API خلف نفق. افتح الترويسات › إدارة وانتقل إلى ترويسات الاستجابة وحدد السماح بـ CORS. استبدل * في Access-Control-Allow-Origin بـ https://app.example.com إذا كان ذلك الموقع وحده يستدعي API، ثم حدد حفظ.
انشر تطبيقًا يعمل تحت مسار فرعي #
يخدم خادم تطبيقك التطبيق تحت /app/v2، وتريد أن يفتح الزوار عنوان النفق المجرد. فعّل إعادة كتابة المسار؟ وأدخل /app/v2. الزائر الذي يفتح /login يصل إلى /app/v2/login في خدمتك.
الإعدادات نفسها عبر API #
هذه الإعدادات متاحة أيضًا تحت /api/v2/tunnels/<TUNNEL_ID>/: headers وhost-header وpath-rewrite وhttp-timeout وhttps-only وhttp3. راجع API.
استكشاف الأخطاء وإصلاحها #
«يمكن أن تحتوي أسماء الترويسات على أحرف وأرقام وشرطات، مثل X-Api-Key.»
يحتوي الاسم على حرف غير مسموح به في اسم ترويسة، مثل مسافة أو نقطتين. أدخل الاسم فقط في الاسم والباقي في القيمة.
«أضف اسمًا لهذه الترويسة، أو احذف الصف.»
في الصف قيمة بلا اسم. املأ الاسم أو احذف الصف.
«أدخل المسار فقط، دون http:// واسم المضيف.»
يقبل المسار المُضاف مسارًا مثل /api، لا رابطًا كاملًا.
«أدخل عددًا صحيحًا من 1 إلى 600، أو اختر «افتراضي الخادم».»
يجب أن تكون المهلة بين 1 و600 ثانية. للمهام الأطول، أجب عن الطلب أولًا ودع العميل يسأل عن النتيجة لاحقًا.
ترويسة CORS لا تعمل مع ملفات تعريف الارتباط
Access-Control-Allow-Credentials لا تعمل مع Access-Control-Allow-Origin: *. عيّن Access-Control-Allow-Origin إلى أصل الموقع المستدعي بالضبط.
خدمتي المحلية تستخدم HTTPS ويعرض النفق خطأ
هذه ليست مشكلة ترويسات. فعّل HTTPS المحلي؟، الذي يخبر النفق بأن خدمتك المحلية نفسها تستخدم HTTPS. راجع مرجع الإعدادات.