هل يمكن لـ Home Assistant العمل خلف وكيل عكسي على مسار فرعي؟

يمكن تشغيل Home Assistant خلف وكيل عكسي، لكن تقديمه بشكل موثوق من مسار فرعي مُعاد كتابته لا يُعد عمومًا حدًا لنشر مدعومًا.

قد تعيد صفحة على example.com/homeassistant شفرة HTML، بينما تظل الطلبات اللاحقة تستهدف أصولًا نسبية للجذر، أو مسارات المصادقة، أو WebSockets، أو استدعاءات التكامل. اختبر أكثر من الشاشة الأولى: استخدم متصفحًا جديدًا، وسجّل الدخول، وافتح لوحة معلومات مباشرة، وأعد تحميل مسار متداخل، وأكمل استدعاءً واحدًا. إذا أسقطت أي طبقة البادئة، فانقل Home Assistant إلى اسم مضيف خاص به بدلًا من إضافة المزيد من عمليات إعادة الكتابة.

افصل دعم الوكيل العكسي عن دعم المسارات الفرعية

يمكن للوكيل العكسي إنهاء TLS وإعادة توجيه طلب موجّه إلى جذر اسم مضيف إلى Home Assistant. أما المسار الفرعي فيضيف متطلبًا مختلفًا: يجب أن يحافظ كل عنوان URL مُنشأ، وأصل، واستدعاء API، وWebSocket، وإعادة توجيه، واستدعاء تكامل على بادئة تفهمها الواجهة باستمرار. ولا يثبت النجاح على مستوى الوكيل وجود عقد التطبيق هذا.

تصل اختبارات مجتمع Home Assistant إلى حكم مباشر مفاده أن التطبيق لا يدعم النشر تحت بادئة URL. والإجابة المعتمدة بشأن وضع Home Assistant في مسار فرعي توصي بنطاق فرعي بغض النظر عن خيار الوكيل.

يعني PASS لدعم الوكيل العكسي أن Home Assistant يعمل في جذر اسم مضيف مخصص مع إعادة توجيه صحيحة. ويعني FAIL للمسار الفرعي المقترح أن مسارًا واحدًا أو أكثر من مسارات التطبيق يفقد البادئة. لا تدمج الحكمين في ادعاء أن الوكلاء العكسية غير متوافقة بحد ذاتها.

استخدم أصول الواجهة كأول اختبار منخفض المخاطر

افتح المسار الفرعي المقترح في ملف متصفح خاص وافحص طلبات الشبكة قبل تغيير Home Assistant. إذا حُمّلت الوثيقة الأساسية، لكن طلبت JavaScript أو الأيقونات أو البيانات الوصفية أو الترجمات مسارات من جذر اسم المضيف، فقد فشل التصميم بالفعل في أول اختبار فاصل قابل للعكس.

أعادت محاولة موثقة لإعادة كتابة المسار الصفحة الرئيسية، بينما طلبت موارد الواجهة عناوين URL مسبوقة بشرطة مائلة من دون بادئة Home Assistant. إن فشل الأصول النسبية للجذر هو عدم تطابق في مسار التطبيق، وليس ملفًا مفقودًا على الوكيل.

يعني PASS أن كل موارد الواجهة تُعاد بنجاح تحت المسار المقصود. ويعني FAIL ظهور استجابات 404 أو طلبات لمسارات الجذر. توقف عند هذه النقطة واختبر اسم مضيف مخصصًا؛ فاستبدال نص جسم الاستجابة هش، لأن إصدارات الواجهة المستقبلية قد تضيف مسارات جديدة لا تغطيها إعادة الكتابة.

اختبر WebSockets والمصادقة والمسارات المتداخلة

غلاف لوحة معلومات ثابت ليس جلسة مكتملة. سجّل الدخول من ملف تعريف نظيف، وراقب تحديثات الكيانات عدة دقائق، وأنعش عنوان URL للوحة معلومات متداخلة، وسجّل الخروج، ثم سجّل الدخول مجددًا. بعد ذلك افحص ما إذا كانت ترقيات HTTP والرموز وعمليات إعادة التوجيه وإعادة تحميل المسارات تحافظ على المصدر والمسار العامين نفسيهما.

يعتمد Home Assistant بدرجة كبيرة على WebSockets لاتصالات الواجهة المباشرة، لذلك يجب أن يحافظ الوكيل على مسار الترقية والرؤوس. وتوضح تجربة أحد المشغلين بشأن التعامل مع WebSockets عبر الوكيل العكسي سبب عدم كفاية تحميل HTML وحده لاختبار التوافق.

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

Featured

ZimaCube 2 سحابة شخصية منزلية NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

اختر اسم مضيف مخصصًا كحد مستقر

انشر Home Assistant في جذر اسم مضيف مخصص مثل ha.example.com، ثم وجّه ذلك الاسم عبر الوكيل العكسي إلى الخدمة الداخلية. يحافظ هذا على مصدر عام واحد من دون مطالبة التطبيق بفهم بادئة مسار. ويمكن لشبكة VPN خاصة أو نفق أن يوفر حد الجذر النظيف نفسه من دون كشف الخدمة للعامة.

عندما ينقطع مسار بعيد موجود بعد تغييرات الشبكة، تحقّق من DNS والعنوان العام وNAT والنفق وتوجيه الوكيل كلٌّ على حدة. يوفر تشخيص ZimaSpace بشأن الوصول البعيد بعد تغيير جهاز التوجيه فحصًا مجاورًا لذلك المسار.

ينجح البديل عندما يتمكن متصفح نظيف من تحميل الأصول، وإنشاء WebSocket، والمصادقة، وتحديث المسارات المتداخلة، والوصول إلى Home Assistant بعد إعادة تشغيل الوكيل. أبقِ المسار القديم متاحًا فقط للمدة اللازمة للتراجع عن تغييرات DNS أو الوكيل؛ ولا تشغّل عنواني URL عامين ملتبسين إلى أجل غير محدد.

توقف عندما تصمد الجلسة الكاملة أمام إعادة التشغيل

أعد تشغيل الوكيل وHome Assistant مرة واحدة، ثم كرر الاختبار الكامل من الشبكة المحلية ومن الشبكة البعيدة المقصودة. أكّد اسم الشهادة، وعنوان العميل المُمرَّر، وحد الوكيل الموثوق، وتسجيل الدخول، والحالة المباشرة، وتسجيل الخروج، واستدعاء تكامل واحدًا. هذا هو عبء العمل الأصلي، وليس فحصًا مختصرًا لصفحة ثابتة.

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

صعّد المشكلة عندما يظل تصميم اسم المضيف الجذري فاشلًا، لأن السبب المتبقي يُرجّح أن يكون ثقة الوكيل أو إعادة توجيه WebSocket أو DNS أو الشهادة أو التوجيه، لا دعم المسار الأساسي. لا تكشف Home Assistant مباشرة عبر منفذ غير محمي لمجرد الحفاظ على شكل URL المطلوب.