إذا فشل تسجيل الدخول إلى Home Assistant فقط بعد إعادة تشغيل الوكيل العكسي، فاختبر تسجيل الدخول عبر شبكة LAN مباشرةً أولًا، وأبقِ قاعدة بيانات المستخدمين دون تغيير حتى تعزل مسار الوكيل.
قد تؤدي إعادة تشغيل الوكيل إلى تغيير عنوان الحاوية، أو معلومات العميل المُمرَّرة، أو معالجة WebSocket، أو هدف DNS، أو الخادم الخلفي الأساسي، من دون تغيير أي كلمة مرور في Home Assistant. لذلك، يُعد حذف الحسابات وإعادة ضبط الجلسات بالكامل من الإجراءات غير المناسبة كبداية. قارن عنوان Home Assistant المباشر باسم المضيف المعتاد عبر الوكيل، واحفظ أخطاء المتصفح والوكيل، وحدد ما إذا كان الفشل يحدث قبل المصادقة، أو أثناء طلب تسجيل الدخول، أو عند فتح الواجهة لاتصالها المستمر.
ابدأ بفصل مصادقة Home Assistant عن مسار الوكيل
استخدم الحساب المعروف بصحته نفسه عبر عنوان Home Assistant المحلي المباشر وعبر اسم المضيف العام أو الداخلي للوكيل. إذا نجح تسجيل الدخول المباشر بينما فشل مسار الوكيل، فمن المرجح أن الحساب وحالة المصادقة في Core سليمان بما يكفي لتركهما دون تغيير. وإذا فشل المساران، فأعد التحقيق إلى Home Assistant أو الحالة المستعادة أو بيانات الاعتماد نفسها.
أظهرت إحدى حالات تسجيل الدخول عبر وكيل عكسي اختلاف السلوك المباشر عن مسار Apache حتى تصحيح تفاصيل WebSocket والوكيل. ويُعد هذا النوع من المقارنة بين المسار المباشر ومسار الوكيل أكثر فائدة للتشخيص من تغيير كلمات المرور مرارًا.
سجّل رمز حالة HTTP، وتسلسل عمليات إعادة التوجيه، وخطأ وحدة تحكم المتصفح، واستجابة الخادم الأساسي للوكيل، والطابع الزمني المقابل في سجل Home Assistant قبل تغيير الإعدادات. فاستجابة 400 الناتجة عن وكيل غير موثوق، وفشل WebSocket، وإعادة التوجيه إلى مخطط غير صحيح، وكلمة المرور غير الصالحة، كلها أعطال مختلفة حتى إن عرضت الشاشة الرسالة العامة نفسها التي تفيد بتعذر الاتصال.
تترك أسباب الوكيل الأربعة مؤشرات مختلفة
تتمثل الفروع الشائعة في تغيّر عنوان مصدر الوكيل بحيث لم يعد يطابق قاعدة الوكلاء الموثوقين، أو تغيّر الرؤوس والمخطط المُمرَّرين، أو تعطل معالجة ترقية WebSocket، أو توجيه الطلبات إلى خادم Home Assistant خلفي غير صحيح. وقد تؤدي إعادة إنشاء حاوية الوكيل إلى تغيير أحد هذه العوامل بينما تظل نسخة Home Assistant نفسها مستقرة.
توضح حالة حديثة لاستكشاف أخطاء الوكيل العكسي أن Home Assistant كان يرفض حركة المرور المُمرَّرة حتى وُضع الوكيل المباشر في النطاق الموثوق الصحيح. ويُعد التحقق من هوية الوكيل الموثوق أكثر أمانًا من توسيع النطاق بشكل دائم: تحقق من عنوان الوكيل الذي يصل فعليًا إلى Home Assistant، ولا تثق إلا بهذا الحد.
استخدم المؤشرات أدناه وغيّر فرعًا واحدًا في كل مرة. لا تترك نطاقًا واسعًا للوكلاء الموثوقين بعد الاختبار؛ إذ يزيل ذلك حماية مهمة من عناوين العملاء المُمرَّرة والمزوّرة.
السبب 1: غيّرت إعادة التشغيل عنوان مصدر الوكيل
- المؤشر: تُرفض الطلبات فورًا، وتحدد سجلات Home Assistant وكيلًا عكسيًا غير موثوق.
- التحقق: قارن بين الشبكة الفرعية أو العنوان الخاص بحاوية الوكيل والنطاق الموثوق المُعدّ.
- إذا–فإن: إذا أدى استعادة النطاق الموثوق الضيق الصحيح إلى إصلاح تسجيل الدخول، فأبقِ حالة الحساب والجلسة دون تغيير.
السبب 2: لم يعد المضيف أو المخطط المُمرَّر يطابق المصدر العام
- المؤشر: تنتقل عمليات إعادة التوجيه بين HTTP وHTTPS أو بين أسماء مضيفين بديلة، أو تبدو ملفات تعريف الارتباط مرتبطة بمصدر غير متوقع.
- التحقق: قارن قيمة Host والمخطط المُمرَّر قبل إعادة التشغيل وبعدها.
- إذا–فإن: إذا أدى تصحيح هذه القيم إلى إصلاح دورة إعادة التوجيه وتسجيل الدخول، فكان الفشل في هوية الدخول وليس في مستخدمي Home Assistant.
السبب 3: تُحمّل صفحة تسجيل الدخول لكن تفشل ترقية WebSocket
- المؤشر: تُحمّل واجهة المستخدم الثابتة، ثم تنقطع الواجهة أو تعجز عن إكمال التهيئة.
- التحقق: افحص طلب WebSocket في المتصفح ورؤوس الترقية في الوكيل.
- إذا–فإن: إذا أبقى الوصول المباشر اتصال WebSocket مفتوحًا بينما لا يفعل اسم المضيف ذلك، فواصل التحقيق في طبقة الوكيل.
السبب 4: يوجّه الوكيل إلى خادم خلفي مختلف أو جديد
- المؤشر: يبدو الخادم مُعدًّا حديثًا، أو يختفي المستخدمون المعروفون، أو تختلف حالة خاصة بالخادم عند الوصول عبر الوكيل.
- التحقق: قارن عنوان الخادم الأساسي، وهوية النسخة، ومسار الإعدادات.
- إذا–فإن: إذا وصل الوكيل إلى الحاوية أو النسخة المستعادة الخطأ، فأصلح التوجيه قبل تعديل بيانات المصادقة.
استخدم سلوك WebSocket لتجنب تصنيف فشل الواجهة على أنه فشل تسجيل الدخول
تعتمد واجهة Home Assistant على اتصال WebSocket مستمر بعد تبادل HTTP الأولي. لذلك، قد يقدّم الوكيل صفحة تسجيل الدخول بنجاح، ثم يفشل بعد لحظات عند ترقية الاتصال أو إبقائه مفتوحًا. وغالبًا ما يصف المستخدمون هذا التسلسل بأنه فشل في تسجيل الدخول لأنه يحدث مباشرة بعد إرسال بيانات الاعتماد.
وصل إعداد وكيل عكسي لـ Home Assistant على Synology إلى مسار تسجيل الدخول، لكنه ظل يفشل حتى تصحيح معالجة ترقية WebSocket. ويساعد التحقق من سلوك ترقية WebSocket عبر الوكيل على تجنب إضاعة الوقت في إعادة ضبط المستخدمين عندما يكون مسار تسجيل الدخول عبر HTTP سليمًا بالفعل.
إذا فشل الاتصال، فتحقق من معالجة ترقية HTTP/1.1، والمهلات، وإنهاء TLS، واسم المضيف، وأي وسيط CDN أو برمجية وسيطة للمصادقة أمام الوكيل. أبقِ مجموعة التغييرات محدودة. ولا تضف رؤوسًا غير مرتبطة منسوخة من حزمة وكيل أخرى ما لم يوضح الطلب الفاشل سبب الحاجة إليها.
تحقق من الإصلاح عبر إعادتَي تشغيل للوكيل وعميل نظيف
بعد تطبيق الإصلاح المناسب، سجّل الدخول والخروج عبر اسم المضيف المعتاد، وافتح لوحة معلومات مدة كافية للتأكد من استقرار WebSocket، ثم كرر العملية من نافذة تصفح خاصة أو من عميل ثانٍ. بعد ذلك، أعد تشغيل الوكيل مرتين وأعد تشغيل مضيف الوكيل إذا كان عنوان الحاوية أو الشبكة جزءًا من السبب المشتبه فيه.
ينطبق مبدأ العزل نفسه في مقارنة ZimaSpace بين مساري Home Assistant عبر LAN وعن بُعد: حافظ على مسار التطبيق المحلي السليم أثناء اختبار طبقات DNS وTLS والوكيل والتوجيه الإضافية المستخدمة للوصول عن بُعد.
يُعد الاختبار ناجحًا عندما يصل تسجيل الدخول المباشر وعبر الوكيل إلى نسخة Home Assistant نفسها، ويكون عنوان الوكيل الضيق المتوقع موثوقًا، وتحافظ عمليات إعادة التوجيه على المخطط واسم المضيف المقصودين، ويظل WebSocket مستقرًا أثناء الاستخدام العادي، ولا تغيّر إعادة تشغيل الوكيل النتيجة. صعّد التحقيق إلى مصادقة Home Assistant فقط عندما يفشل الحساب المعروف بصحته نفسه عبر المسار المباشر أيضًا.
الدعم والنصائح
المزيد للقراءة

كيفية تحسين اتصالات قاعدة بيانات Home Assistant للحاويات المتزامنة
اضبط قاعدة بيانات Recorder الخارجية استنادًا إلى الاتصالات النشطة وزمن الاستجابة المُقاسَين، وليس عبر زيادة الحد الأقصى للاتصالات أو نسخ تجمّع اتصالات مضيف آخر.

كيفية منع تكرار المهام أو عمليات الاستيراد في Home Assistant
استخدم سجلات التتبّع ومفاتيح العمليات الفريدة لجعل عمليات الأتمتة والاستيراد آمنة عند إعادة المحاولة، من دون إنشاء إجراءات أو سجلات مكررة.

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

