عندما يتعطل Jellyfin لمستخدم واحد أو على جهاز واحد فقط، لا تبدأ بتغيير الخادم بأكمله. اختبر الحساب المتأثر على جهاز معروف بأنه يعمل، واختبر حسابًا معروفًا بأنه يعمل على الجهاز المتأثر.
ينشئ هذان الاختباران مصفوفة تشخيص بسيطة. إذا انتقلت المشكلة مع الحساب، فتحقق من أذونات المستخدم وحالة الجلسة. وإذا انتقلت مع الجهاز، فتحقق من عنوان الخادم المحفوظ، وحالة التطبيق، ومسار الترميز، وDNS، ومسار الشبكة. وإذا ظهرت المشكلة مع عنصر وسائط واحد بغض النظر عن الحساب، فانتقل إلى توافق التشغيل بدلًا من اعتبار المستخدم أو الجهاز سبب المشكلة.
أجرِ اختبار الحساب والجهاز اثنين في اثنين
استخدم الخادم نفسه، وحاول استخدام عنصر الوسائط نفسه متى أمكن. اختبر المستخدم المتأثر على جهاز يعمل، ثم اختبر مستخدمًا يعمل على الجهاز المتأثر. تجنب تغيير كلمات المرور أو إعادة تثبيت التطبيقات أو مسح ذاكرات التخزين المؤقت إلى أن تعرف أي جانب تتبعه الأعراض.
إذا فشل كلا المستخدمين على جهاز واحد، يصبح الجهاز أو مسار شبكته الاحتمال الأرجح. وإذا فشل مستخدم واحد على عدة أجهزة، يصبح الحساب الاحتمال الأرجح. وإذا فشل اقتران مستخدم-جهاز واحد فقط، فستكون حالة الجلسة المخزنة مؤقتًا أو إعداد خاص بالعميل أرجح من انقطاع شامل في الخادم.
سجّل الفشل بدقة: هل رُفض تسجيل الدخول، أم اختفت المكتبة، أم مُنع التشغيل، أم يتوقف البث مؤقتًا، أم يتعذر الوصول إلى الخادم؟ عبارة «يتعطل Jellyfin» واسعة جدًا لإصلاح المشكلة؛ فكل نتيجة ظاهرة تقود إلى فحص تالٍ مختلف.
إذا انتقلت المشكلة مع المستخدم، فتحقق من الأذونات والوصول عن بُعد
افتح مستخدم Jellyfin المتأثر وقارن وصوله إلى المكتبات، وأذونات تشغيل الوسائط، وأذونات تحويل الترميز، وإذن الاتصال عن بُعد بحساب يعمل. غيّر فرقًا مؤكدًا واحدًا في كل مرة.
يوثّق Jellyfin عناصر التحكم في التشغيل على مستوى المستخدم، بما في ذلك السماح بتشغيل الوسائط والسماح بالتشغيل الذي يتطلب تحويل الترميز. أذونات تشغيل المستخدم في Jellyfin
إذا كان المستخدم يعمل داخل الشبكة المحلية ولا يعمل عن بُعد، فتحقق من إذن الوصول عن بُعد للحساب ومن تصنيف شبكة الخادم قبل إعادة ضبط بيانات الاعتماد. قد يكون الرفض المقتصر على الوصول عن بُعد سياسة صحيحة، وليس فشلًا في المصادقة.
إذا انتقلت المشكلة مع الجهاز، فأعد ضبط حالة العميل فقط
تحقق أولًا من عنوان الخادم المحفوظ، بما في ذلك المخطط واسم المضيف والمنفذ وأي مسار فرعي للوكيل العكسي. قارنه حرفيًا بعميل يعمل. قد يؤدي عنوان IP مباشر قديم أو مسار فرعي مفقود إلى فشل جهاز واحد رغم سلامة الخادم.
إذا كان العنوان صحيحًا، فسجّل الخروج ثم سجّل الدخول مجددًا قبل مسح جميع بيانات التطبيق. بعد ذلك حدّث العميل إذا كان قديمًا بشكل ملحوظ. أعد التثبيت فقط بعد فشل الخطوات الأضيق نطاقًا، لأن مسح كل شيء يزيل الأدلة التي قد توضح ما إذا كان رمز جلسة أو إدخال خادم محفوظ هو سبب المشكلة.
بالنسبة إلى الأجهزة البعيدة، يمكن أن يساعد مسار الوصول إلى Jellyfin عن بُعد في مقارنة اسم المضيف المقصود أو مسار النفق بالعنوان المحفوظ على العميل المتعطل.
إذا نجح تسجيل الدخول لكن فشل التشغيل، فقارن مسار التشغيل
شغّل الملف نفسه من جهاز يعمل ومن جهاز متعطل، وراقب لوحة معلومات Jellyfin. لاحظ ما إذا كان كل عميل يشغّل الوسائط مباشرة، أو يعيد تغليفها، أو يشغّلها مباشرة عبر تدفق، أو يحوّل ترميزها، ولاحظ ما إذا كانت الترجمة مفعّلة.
توضح وثائق برامج الترميز في Jellyfin أن الحاويات أو الصوت أو الفيديو أو الترجمات غير المدعومة قد تفرض مسارات تحويل مختلفة على العملاء المختلفين. توافق برامج الترميز لدى العميل ولهذا قد يفشل تلفاز واحد في تشغيل عنوان يعمل بشكل مثالي في عميل سطح المكتب.
إذا كان الجهاز المتعطل وحده يفعّل تحويل الترميز، فتحقق من سجل FFmpeg ومن إذن تحويل الترميز للمستخدم قبل تغيير ملف الوسائط. وإذا استخدم العميلان وضع التشغيل نفسه لكن فشل أحدهما فقط، فتابع فحص شبكة الجهاز وحالة التطبيق.
تحقق من DNS ومسار الشبكة للجهاز المتعطل فقط
عندما يتعذر الوصول إلى الخادم بدلًا من ظهور خطأ في التشغيل، قارن تحليل DNS ومسار الاتصال من الجهاز المتعطل بجهاز يعمل على الشبكة نفسها. اختبر اسم المضيف المقصود أولًا؛ ولا تفترض أن عنوان IP المباشر مكافئ له عندما يعتمد TLS أو توجيه الوكيل العكسي على اسم المضيف.
يشير دليل استكشاف أخطاء Jellyfin وإصلاحها إلى أن الغياب الكامل لسجلات حركة الويب المطابقة يعني عادةً أن الطلب لم يصل إلى الخادم. مؤشر استكشاف أخطاء الشبكة
إذا لم يُنشئ الجهاز المتعطل أي إدخال في سجل الخادم، فأصلح DNS أو إمكانية الوصول إلى شبكة Wi‑Fi/VLAN أو حالة VPN أو الثقة في الشهادة أو العنوان المحفوظ على طبقة العميل. وإذا سجّل Jellyfin الطلب وأعاد خطأً في التطبيق، فارجع في المصفوفة إلى سلوك الحساب أو التشغيل.
تحقق من الإصلاح باستخدام المستخدم والجهاز وملف الوسائط الأصلي
بعد تغيير الطبقة التي حددتها، عُد إلى التركيبة الأصلية نفسها وأعد تنفيذ الإجراء الذي فشل. لا يثبت نجاح حساب مسؤول على حاسوب محمول آخر أن مستخدم المنزل المتأثر على التلفاز قد أُصلحت مشكلته.
ثم أعد تشغيل العميل أو أعد اتصاله مرة واحدة حتى تستمر الحالة الناجحة بعد بدء جلسة جديدة. وإذا شمل الإصلاح الوصول عن بُعد، فأعد الاختبار من شبكة خارجية بدلًا من الاختبار والجهاز لا يزال على الشبكة المحلية فقط.
توقف عندما ينجح اقتران الحساب والجهاز الأصلي وتظل عناصر التحكم تعمل بصورة طبيعية. صعّد المشكلة مع نتائج المصفوفة، وإصدار العميل، وإصدار الخادم، وعنوان URL للخادم، ووضع التشغيل، ومقتطف السجل ذي الصلة إذا استمر الفشل المعزول نفسه.
الدعم والنصائح
المزيد للقراءة

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

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

متى ينبغي إعادة بناء Home Assistant بدلًا من إصلاحه؟
أصلح أولًا أصغر طبقة معطّلة في Home Assistant، ثم استعد الحالة المعروفة بأنها سليمة، ولا تُعِد البناء إلا عندما يتعذّر الوثوق بالإعدادات الدائمة.

