كيفية معرفة ما إذا كان خطأ Home Assistant صادرًا عن العميل أم الخادم

اشتبِه في وجود خطأ في عميل Home Assistant عندما يفشل أحد العملاء بينما ينجح عميل آخر عبر المسار نفسه على الخادم نفسه؛ واشتبِه في الخادم عندما تفشل العملية نفسها في كل مكان.

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

أجرِ أولًا اختبارًا بالمسار نفسه مع عميل مختلف

افتح عنوان URL نفسه لـ Home Assistant والصفحة نفسها من متصفح ثانٍ، أو ملف شخصي خاص، أو التطبيق المرافق، أو جهاز آخر على الشبكة نفسها. إذا فشل أحد العملاء بينما عمل الثاني فورًا، فقد أثبت الخادم بالفعل أنه قادر على تنفيذ العملية عبر ذلك المسار، ما يجعل ذاكرة التخزين المؤقت، والتخزين المحلي، وإضافات المتصفح، وموارد الواجهة الأمامية المخصصة، أو عرض العميل هي الفروع الأرجح.

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

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

عادةً ما تتغير أخطاء جهة العميل مع ذاكرة التخزين المؤقت أو المتصفح أو حالة الواجهة الأمامية الآمنة

غالبًا ما تترك أعطال العميل نمطًا مميزًا: متصفح واحد يتوقف بسبب موارد قديمة، أو بطاقة مخصصة تُطلق خطأ JavaScript، أو يتصرف التطبيق المرافق بشكل مختلف عن متصفح نظيف. قد يؤدي التحديث القسري، أو الملف الشخصي الخاص، أو أدوات مطوري المتصفح إلى تغيير النتيجة من دون إعادة تشغيل Home Assistant.

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

عندما يؤدي الوضع الآمن أو إزالة مورد واجهة أمامية تابع لجهة خارجية إلى تغيير الصفحة، أبقِ التحقيق ضمن البطاقات المخصصة أو السمات أو موارد المتصفح. لا تُعد إنشاء Recorder أو تستبدل SSD بسبب عطل يقتصر على JavaScript. وعلى العكس، إذا أبلغ العميل عن استجابة 500 من الخادم أو فقد كل جهاز الإجراء نفسه للكيان، فانتقل إلى الطبقة الأدنى.

تتكرر أخطاء جهة الخادم عبر العملاء وتظهر في سجلات Core أو التكامل

عادةً ما يستمر عطل جهة الخادم رغم تغيير العملاء لأن الطلب يصل إلى العملية الخلفية المعطلة نفسها. ومن أمثلته إلقاء تكامل استثناءً، أو فشل الوصول إلى قاعدة البيانات، أو إرجاع إجراء أتمتة خطأً، أو عدم توفر Core. قد يعرض المتصفح رسالة عامة، لكن سطر السجل المقابل في Home Assistant يحدد الجهة المسؤولة على الخادم.

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

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

Featured

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

ZimaCube2

$799.00 - $2,499.00

Buy Now

تقع أخطاء الوكيل وDNS وWebSocket بين العميل والخادم

أكثر الثنائيات المضللة شيوعًا هي اعتبار كل مشكلة ليست من جهة العميل مشكلةً في خادم Home Assistant. فقد يتعطل وكيل عكسي، أو محلل DNS، أو شبكة VPN، أو نقطة نهاية TLS، أو ترقية WebSocket بعد مغادرة المتصفح للجهاز وقبل معالجة Core للطلب. وقد يجعل هذا المسار الوسيط عنوان URL واحدًا يفشل بينما يعمل العنوان المحلي المباشر.

يوضح دليل مستقل لإعداد وكيل عكسي لـ Home Assistant أن المسار العام يضيف ترويسات العميل المُمرَّرة وطبقة ترقية WebSocket لا يستخدمها الوصول المباشر عبر الشبكة المحلية. وقد يفشل مسار الدخول الإضافي هذا بينما يظل خادم Home Assistant نفسه قابلًا للوصول مباشرةً.

قارن بين عنوان IP المحلي المباشر أو اسم المضيف وبين عنوان URL المعتاد للوكيل من العميل نفسه. إذا نجح الوصول المباشر وفشل الوكيل، فأبقِ Core كما هي وتحقق من DNS وTLS وذاكرة التخزين المؤقت للوكيل والترويسات المُمرَّرة وWebSocket. وإذا فشل كلاهما بالطريقة نفسها وتوافقت سجلات الخادم، فارجع إلى داخل Home Assistant.

استخدم مصفوفة ثنائية في اثنين قبل إعادة تشغيل الخادم

اختبر العميل A والعميل B مقابل المسار 1، ثم اختبر العميل A والعميل B مقابل المسار 2. سجّل حالة تحميل الصفحة، واستجابة API، وحالة WebSocket، وخطأ وحدة تحكم المتصفح، ومدخل سجل Home Assistant المطابق. تفصل هذه المصفوفة البسيطة بين أنماط الفشل الخاصة بالعميل فقط، أو بالمسار فقط، أو بالخادم بأكمله، مع عدد أقل من التغييرات التخريبية.

يستخدم تحليل ZimaSpace حول سلوك Home Assistant عبر الشبكة المحلية مقابل الاتصال البعيد فصل المسارات نفسه عندما تتغير سرعة الاستجابة المتصورة بين العملاء أو مسارات الدخول.

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