حلّ المجتمع

إصلاح المنطقة الزمنية لـ Jellyfin على ZimaOS: عيّن متغير البيئة TZ إلى منطقة IANA

A short November 2025 support thread where a new Jellyfin user in the United States saw TZ set to Europe/London. Zima-Jerry said to change the TZ environment variable to a valid region such as America/New_York. The original poster immediately confirmed the change worked.

الحل الأصلي بسيط ورسمي: تم تثبيت Jellyfin باستخدام متغير البيئة للحاوية TZ=Europe/London، بينما كان المستخدم يقيم في الولايات المتحدة. أخبره Zima-Jerry باستبدال القيمة بمعرّف مناسب للمنطقة الزمنية وفق معيار IANA، مثل America/New_York. غيّر المستخدم القيمة وأكد فورًا أنها نجحت.

هذه مشكلة في إعدادات الحاوية، وليست سببًا لإعادة تثبيت Jellyfin أو تغيير ساعة مضيف ZimaOS. تستمر أمثلة حاويات Jellyfin الحالية في استخدام متغير البيئة TZ مع قيم بصيغة المنطقة، مثل America/Los_Angeles.

إعدادات تطبيق Jellyfin في ZimaOS، وتُظهر ضبط متغير البيئة TZ على Europe/London
تظهر المشكلة الأصلية مباشرةً في إعدادات التطبيق: تم ضبط TZ في حاوية Jellyfin على منطقة غير صحيحة.

غيّر متغير البيئة TZ

افتح إعدادات تطبيق Jellyfin في ZimaOS، وابحث عن متغير البيئة المسمى TZ، ثم استبدل القيمة بمعرّف IANA الصحيح بصيغة المنطقة/المدينة.

تشمل الأمثلة:

  • America/New_York؛
  • America/Chicago؛
  • America/Denver؛
  • America/Los_Angeles؛
  • Europe/London؛
  • Asia/Tokyo.

استخدم أسماء المنطقة/المدينة، وليس إزاحة UTC ثابتة

تفهم المنطقة الزمنية وفق معيار IANA تغيّرات التوقيت الصيفي والتعديلات التاريخية على القواعد. وقد تكون قيمة ثابتة مثل UTC-5 غير صحيحة خلال جزء من السنة في المواقع التي تطبق التوقيت الصيفي.

احفظ إعدادات التطبيق ودَع الحاوية تُعاد تشغيلها

يتم تمرير متغيرات البيئة عند بدء تشغيل الحاوية. بعد تغيير TZ، احفظ إعدادات التطبيق ودَع Jellyfin يُعاد تشغيله أو إنشاؤه من جديد وفقًا لما يتطلبه ZimaOS.

بعد ذلك، تحقق من الوقت في سجلات Jellyfin والمهام المجدولة وأي واجهة مستخدم تعتمد على التواريخ.

لا تغيّر ساعة نظام ZimaOS لمجرد إصلاح حاوية واحدة

إذا كانت لوحة معلومات ZimaOS تعرض الوقت الصحيح بالفعل بينما لا يعرضه Jellyfin، فغيّر المنطقة الزمنية لحاوية Jellyfin أولًا. إذ إن إعدادات NTP/الوقت للمضيف ووقت العرض داخل الحاوية طبقتان منفصلتان.

لم تكن تعيينات المنافذ المخصصة في المصدر جزءًا من إصلاح TZ

إعدادات تطبيق Jellyfin في ZimaOS، وتُظهر تعيينات المنافذ بين المضيف والحاوية، بما في ذلك 8097 إلى 8096
كان المصدر يحتوي أيضًا على منافذ مخصصة، لكن Zima-Jerry لم يحدد تلك التعيينات باعتبارها سبب المنطقة الزمنية الخاطئة.

تعيينات أجهزة GPU مشكلة منفصلة في Jellyfin

إعدادات Jellyfin في ZimaOS، وتُظهر تعيينات GPU وأجهزة الفيديو، بما في ذلك /dev/dri
لا تؤثر أجهزة تحويل الترميز العتادي في متغير البيئة TZ؛ لذا استكشف أخطاءها بشكل منفصل.

تستخدم أمثلة Docker الحالية لـ Jellyfin نمط TZ نفسه

تتضمن وثائق حاويات Jellyfin الحالية إعدادات للبيئة مثل:

TZ=America/Los_Angeles

راجع نمط بيئة حاوية Jellyfin الحالي.

لماذا تهم المنطقة الزمنية إلى جانب عرض الساعة

يستخدم Jellyfin معلومات الوقت في السجلات والصيانة المجدولة ومهام المكتبة وسجل النشاط وغيرها من الوظائف التي تعتمد على التواريخ. لذلك، قد تجعل قيمة TZ الخاطئة الخادم السليم يبدو مربكًا، حتى عندما يعمل تشغيل الوسائط بشكل طبيعي.

بعد تغيير المتغير، تحقق من طابع زمني لمهمة مجدولة واحدة على الأقل أو من إدخال حديث في السجل، للتأكد من أن الحاوية نفسها، وليس المتصفح فقط، ترى المنطقة المقصودة الآن.

الأسئلة الشائعة حول المنطقة الزمنية في Jellyfin

هل أدى تغيير TZ إلى حل مشكلة المستخدم في المصدر؟

نعم. فقد رد المستخدم صراحةً بأن الأمر نجح.

هل ينبغي أن تكون القيمة EST أو PST؟

يفضّل استخدام منطقة وفق معيار IANA، مثل America/New_York أو America/Los_Angeles، حتى تتم معالجة قواعد التوقيت الصيفي بشكل صحيح.

هل تحتاج إعدادات منافذ Jellyfin أو GPU إلى التغيير لإصلاح المنطقة الزمنية؟

لا. فهذه الإعدادات منفصلة عن متغير البيئة TZ.