في أغلب البيوت قرص خارجي أو مجلد على الحاسوب فيه أفلام العائلة ومسلسلات الأطفال وتسجيلات المناسبات، وكل من يريد أن يشاهد شيئاً يسأل نفس الأسئلة: أين الفيلم؟ ولماذا لا يعمل على التلفاز؟ ولماذا الترجمة العربية حروف غريبة؟ ولماذا لا يتذكر الجهاز أين توقفت أمس؟ وقد يكون الحل الأول الذي يخطر لك أن تشارك المجلد على الشبكة، ولكنك سوف تكتشف بسرعة أن المجلد المشترك يعطيك ملفات فقط، أما ما تريده العائلة فهو مكتبة: أسماء وصور وقصص بالعربية، ومكان توقف لكل شخص، وحساب للأطفال لا يظهر فيه ما لا يناسبهم، وتشغيل يعمل على التلفاز والجوال والمتصفح دون أن يسأل أحد عن الترميز Codec.
وهذا بالضبط ما يقدمه سيرفر الوسائط Media Server، وأشهر خيار مفتوح المصدر بالكامل فيه هو Jellyfin. وقد شرحنا في ما هو الهوم لاب لماذا يستحق المختبر المنزلي أن يخدم البيت، وفي NAS جاهز أم تبنيه بنفسك أين تضع الأقراص، وفي مفاهيم الفيديو للمبتدئين ما هي الحاوية والترميز ومعدل البت. وفي هذا المقال سوف نبني على ذلك مكتبة حقيقية صغيرة من أفلام Blender المفتوحة، ونشغل عليها Jellyfin 12.4 في Docker، ونقيس كم يكلف التحويل Transcoding فعلاً، ونرى أين تتعطل الترجمة العربية وكيف تصلحها.
وسوف نناقش في هذا المقال:
- لماذا لا يكفي المجلد المشترك، وكيف يعمل Jellyfin من الداخل.
- التثبيت في Docker Compose بإصدار مثبت، ومعالج الإعداد الأول ولماذا لا تفتح السيرفر للإنترنت قبل أن تنهيه.
- تسمية المجلدات والملفات حتى يتعرف Jellyfin على كل فيلم ومسلسل، والبيانات الوصفية Metadata بالعربية.
- الترجمة العربية: ملف SRT بترميز قديم، وملف ASS ظهر مربعات فارغة، والحرق في الصورة Burn-in.
- كيف يقرر السيرفر بين التشغيل المباشر Direct Play والتحويل، مع أسباب حقيقية رجعت من السيرفر.
- تجربة تقيس ثواني المعالج لكل طريقة تشغيل، والتحويل بالعتاد Hardware Acceleration من التوثيق الرسمي.
- المستخدمون والرقابة الأبوية Parental Controls، والوصول من خارج البيت خلف Reverse Proxy، والنسخ الاحتياطي والتحديث.
لماذا سيرفر وسائط وليس مجلداً مشتركاً؟
المجلد المشترك عبر SMB أو NFS هو أبسط طريقة، وقد شرحناه في TrueNAS عملياً، وهو مناسب تماماً للملفات. ولكن التلفاز الذكي الذي يفتح ملف MKV من مجلد مشترك يعتمد على المشغل المدمج فيه، فإذا كان الصوت بصيغة لا يفهمها أو الترجمة بصيغة لا يرسمها فلن يعمل الملف، ولن يخبرك لماذا. ولا يوجد في المجلد المشترك اسم عربي للفيلم ولا صورة غلاف، ولا يتذكر أين توقف كل فرد من العائلة، ولا يستطيع أن يخفي فيلماً عن حساب الأطفال، لأنه ببساطة لا يعرف أن هذا الملف فيلم.
أما سيرفر الوسائط فيقرأ المجلد مرة واحدة ويبني منه مكتبة في قاعدة بيانات: يتعرف على كل فيلم من اسمه وسنته، ويجلب الوصف والصور من مزودي البيانات على الإنترنت، ويحفظ لكل مستخدم ما شاهده وأين توقف، ثم يقدم كل ذلك لتطبيقات على التلفاز والجوال والمتصفح. والأهم أنه يعرف قدرات كل جهاز، فإذا كان الملف لا يناسب الجهاز حوله إلى صيغة يفهمها أثناء المشاهدة، وهذه هي الميزة التي سوف نقضي فيها أغلب هذا المقال، لأنها أيضاً أغلى ما يفعله السيرفر.
وهناك ثلاثة أسماء في هذا المجال: Jellyfin وPlex وEmby. وسوف نقارنها بالقياس على نفس المكتبة في مقال مستقل، وما يهمنا الآن أن Jellyfin هو الوحيد المفتوح المصدر بالكامل برخصة GPL، ولا يطلب حساباً عند أي شركة، ولا يضع أي ميزة خلف اشتراك، وتشرح صفحة التعريف بالمشروع أنه بدأ في ديسمبر 2018 كتفرع من Emby عندما قررت الشركة إغلاق الإصدار 4 منه.
كيف يعمل Jellyfin من الداخل؟
Jellyfin برنامج واحد مكتوب بلغة C# على منصة .NET، يعمل كخدمة على السيرفر ويستمع على المنفذ 8096، ويتكون من أربعة أجزاء تحتاج أن تفهمها لأن كل مشكلة سوف تقابلها تقع في واحد منها:
- الفاحص Scanner: يمر على مجلدات المكتبة، ويقرأ كل ملف بأداة ffprobe ليعرف الحاوية والترميز والمدة والمسارات Streams، ويتعرف على اسم الفيلم من اسم الملف والمجلد.
- مزودو البيانات الوصفية Metadata Providers: بعد التعرف على الاسم يسأل مواقع مثل TMDB عن الوصف والصور والتصنيف العمري والممثلين، بلغة تحددها أنت.
- قاعدة البيانات: ملف SQLite باسم
jellyfin.dbداخل مجلد الإعداد، فيه كل المكتبة والمستخدمين وما شاهده كل واحد منهم. - المحول Transcoder: نسخة معدلة من FFmpeg اسمها jellyfin-ffmpeg، يشغلها السيرفر عندما لا يستطيع الجهاز تشغيل الملف كما هو.
والصورة التالية تبين كيف تتصل هذه الأجزاء بأجهزة البيت، ولاحظ أن كل جهاز قد يحصل على نفس الفيلم بطريقة مختلفة:

والقاعدة التي تحكم كل ما يلي بسيطة: كل تشغيل لا يحتاج فيه السيرفر إلى إعادة ترميز الصورة يكاد يكون مجانياً، وكل تشغيل يحتاج إليها يأخذ نوى المعالج Cores كاملة طوال مدة المشاهدة. ولذلك فالهدف من تنظيم المكتبة واختيار الأجهزة والإعدادات هو أن يبقى أغلب التشغيل في البيت من النوع الأول.
المتطلبات Requirements
- الجهاز: أي Mini PC أو NAS بمعالج x86 أو ARM حديث يكفي لمكتبة عائلية ما دام أغلب التشغيل مباشراً. أما إذا كنت تتوقع تحويلاً كثيراً فاختر معالج Intel فيه رسوميات مدمجة تدعم Quick Sync، وتشرح صفحة اختيار العتاد لماذا، وسوف نرى الأرقام في قسم القياس.
- الذاكرة RAM: استهلك Jellyfin في تجربتنا نحو 260 إلى 290 ميجابايت بعد الإقلاع، ووصل إلى نحو 520 ميجابايت أثناء التشغيل. لذلك فإن 2 GB للسيرفر وحده تكفي، والباقي للنظام وللخدمات الأخرى.
- التخزين: الأفلام نفسها على قرص كبير، ومجلدا الإعداد
/configوالمؤقت/cacheعلى SSD، لأن قاعدة البيانات والصور المصغرة وأجزاء التحويل كلها قراءة وكتابة صغيرة متكررة. - النظام: Linux مع Docker Engine، فالتوثيق الرسمي في صفحة ال Container يقول صراحة إن تشغيل Jellyfin داخل Container على Windows أو macOS غير مدعوم، وإن التحويل بالعتاد لا يعمل فيه. وإذا لم يكن Docker مثبتاً فقد شرحنا ذلك في تثبيت Docker على Ubuntu.
التثبيت بـ Docker Compose
سوف نستخدم ال Image الرسمي jellyfin/jellyfin، وهو مبني على Debian ومعه jellyfin-ffmpeg. والتوثيق يذكر أن الوسم latest ينتقل تلقائياً إلى كل إصدار جديد حتى الإصدارات الرئيسية، ولذلك سوف نثبت الوسم على رقم الإصدار 12.4، والسبب أن Jellyfin يعدل قاعدة البيانات عند كل ترقية ولا يمكن الرجوع إلى إصدار أقدم إلا من نسخة احتياطية، كما سوف نرى في قسم التحديث. والملف التالي هو نفس الملف الذي شغلنا به التجربة:
services:
jellyfin:
image: jellyfin/jellyfin:12.4
container_name: jellyfin
ports:
- "8096:8096/tcp"
volumes:
- jellyfin-config:/config
- jellyfin-cache:/cache
- type: bind
source: /srv/media
target: /media
read_only: true
- type: bind # Arabic fonts for subtitles: browser fallback + burn-in
source: /srv/fonts
target: /fallback_fonts
read_only: true
- type: bind
source: /srv/fonts
target: /usr/local/share/fonts/custom
read_only: true
environment:
- TZ=Asia/Riyadh
restart: unless-stopped
volumes:
jellyfin-config:
jellyfin-cache:في الإعداد أعلاه لاحظ التالي:
- مجلد الأفلام مربوط بالخيار
read_only: true، والسبب أن Jellyfin لا يحتاج أن يكتب في مكتبتك لكي يعرضها، وإذا حدث خطأ في إضافة Plugin أو ثغرة في السيرفر فلن يستطيع أحد أن يحذف أفلامك من خلاله. وقد كانت أخطر ثغرة أغلقها الإصدار 12.0 تسمح بالضبط بحذف المجلدات من السيرفر، كما ذكرنا في خبر Jellyfin 12. - مجلد الخطوط مربوط مرتين: مرة في
/fallback_fontsليرسله السيرفر للمتصفح، ومرة في/usr/local/share/fonts/customليستخدمه FFmpeg عند حرق الترجمة. ولن تفهم لماذا نحتاجه حتى تصل إلى قسم الترجمة، حيث ظهرت لنا الترجمة العربية مربعات فارغة بدونه. - لا يوجد منفذ 7359 UDP الذي يذكره التوثيق، لأنه للاكتشاف التلقائي في الشبكة المحلية فقط، ويمكنك إضافته إذا أردت أن تجد التطبيقات السيرفر وحدها.
- المنطقة الزمنية
TZتؤثر على أوقات السجلات ومواعيد المهام المجدولة وجدول الوصول للأطفال كما سوف نرى.
الآن نقوم بتشغيل السيرفر ومتابعة السجل:
docker compose up -d
docker logs -f jellyfinوالمخرج سوف يكون كما يلي، وقد حذفنا أسطر الترحيل المتكررة من الوسط:
[13:04:36.485] [INF] [11] Main: Jellyfin version: 12.4.0
[13:04:36.505] [INF] [11] Main: Processor count: 8
[13:04:36.505] [INF] [11] Main: Program data path: /config
[13:04:36.505] [INF] [11] Main: Cache path: /cache
[13:04:36.549] [INF] [11] Jellyfin.Server.Startup: Storage path `/config/data` (Fixed) successfully checked with 724GiB free which is over the minimum of 2GiB.
[13:04:36.934] [WRN] [6] Microsoft.Extensions.Diagnostics.HealthChecks.DefaultHealthCheckService: Health check StartupCheck with status Degraded completed after 3.9609ms with message 'Server is still starting up.'
[13:04:36.968] [INF] [11] Jellyfin.Database.Providers.Sqlite.SqliteDatabaseProvider: SQLite connection string: Data Source=/config/data/jellyfin.db;Cache=Private;Default Timeout=60;Pooling=True
[13:04:37.224] [INF] [11] Jellyfin.Server.Migrations.JellyfinMigrationService: System initialization detected. Seed data. Startup mode is: MediaServer
[13:04:58.814] [INF] [6] MediaBrowser.MediaEncoding.Encoder.MediaEncoder: Found ffmpeg version "8.1.3"
[13:05:01.277] [INF] [6] Main: Startup complete 0:00:26.5334683وفي المخرج أعلاه لاحظ التالي:
- السطر الخاص بالمساحة يفحص أن في مجلدات البيانات 2 GB فارغة على الأقل، ولن يبدأ السيرفر إذا كان القرص ممتلئاً، وهذا فحص مفيد لأن قاعدة بيانات SQLite التي تمتلئ أثناء الكتابة قد تتلف.
- فحص الصحة Health Check يرجع
Degradedطوال فترة الإقلاع، ثمHealthyبعدها. والمسار/healthهو ما تستخدمه أداة المراقبة أو ال Reverse Proxy لمعرفة أن السيرفر جاهز. - الإقلاع الأول أخذ 26.5 ثانية لأنه أنشأ قاعدة البيانات ونفذ كل خطوات الترحيل Migrations، وعندما أعدنا تشغيل ال Container لاحقاً أصبح
Startup complete 0:00:08.38. - السيرفر وجد FFmpeg بالإصدار 8.1.3 الخاص به، وفي نفس الدقيقة يطبع قائمة المرمزات المتاحة، ومنها
h264_qsvوhevc_vaapiوh264_nvenc، ولكن وجودها في القائمة لا يعني أن الجهاز يدعمها، فهذه تحتاج بطاقة رسوميات وإعداداً كما سوف نرى.
معالج الإعداد الأول Setup Wizard
عند فتح http://server:8096 للمرة الأولى يظهر معالج الإعداد، وقد ظهر لنا بالعربية مباشرة لأن المتصفح كان بالعربية، وفيه تختار اسم السيرفر ولغة العرض، ثم تنشئ حساب المدير، ثم تضيف المكتبات، ثم تختار لغة البيانات الوصفية والدولة. والصورة التالية الصفحة الأولى منه كما ظهرت في التجربة:

وقد نفذنا المعالج في التجربة عبر الواجهة البرمجية API نفسها التي تستدعيها الصفحة، لنرى ما يحدث خلفها. ولاحظ أن السيرفر اقترح اسم المستخدم root لأن ال Container يعمل بمستخدم root افتراضياً، ولا تقم بقبول هذا الاقتراح، فاسم المدير الذي يمكن تخمينه نصف كلمة المرور:
curl -s http://127.0.0.1:8096/Startup/User
curl -s -X POST http://127.0.0.1:8096/Startup/Configuration -H 'Content-Type: application/json' \
-d '{"UICulture":"ar","MetadataCountryCode":"SA","PreferredMetadataLanguage":"ar"}'{"Name":"root"}تنظيم المجلدات والتسمية Naming
أكثر سبب لمكتبة تظهر فيها الأفلام بأسماء خاطئة أو صور لأفلام أخرى هو اسم الملف. فالفاحص لا يرى الفيلم، وإنما يرى نصاً مثل Sintel.2010.720p.cut.mkv ويحاول أن يستخرج منه الاسم والسنة، ثم يبحث بهما عند مزود البيانات. وتشرح صفحة تسمية الأفلام القاعدة: مجلد لكل فيلم باسم Movie Name (year)، والملف داخله بنفس الاسم، وكل ملف إضافي يبدأ بنفس الاسم ثم لاحقة تشرح نوعه. أما المسلسلات فتشرح صفحة المسلسلات أنها تحتاج مجلداً للمسلسل، ومجلداً لكل موسم، ورقم الموسم والحلقة بالشكل S01E01 في اسم كل ملف.
والمكتبة التي بنيناها للتجربة صغيرة ولكنها تغطي الحالات التي تقابلها في البيت: فيلم له ترجمة في TMDB، وفيلم ليس له ترجمة، وفيلم معه ملفات ترجمة خارجية وإعلان، ومسلسل باسم عربي لا يعرفه أي مزود بيانات:
/srv/media
├── movies
│ ├── Big Buck Bunny (2008)
│ │ └── Big Buck Bunny (2008).mov
│ └── Sintel (2010)
│ ├── Sintel (2010).mkv
│ ├── Sintel (2010).ar.srt
│ ├── Sintel (2010).Arabic Styled.ar.ass
│ └── trailers
│ └── Sintel trailer.mp4
└── shows
└── محاضرات الشبكات (2026)
└── Season 01
├── محاضرات الشبكات S01E01.mkv
└── محاضرات الشبكات S01E02.mkvوالصورة التالية تشرح كل جزء من هذه الأسماء وماذا فعل به Jellyfin في التجربة:

وقد استخدمنا ملفات مفتوحة من مؤسسة Blender برخصة CC BY 3.0: فيلم Sintel وقد قصصنا منه أول ست دقائق بدقة 720p مع صوت AC3 بست قنوات كما هو في النسخة الأصلية، وإعلان Big Buck Bunny بدقة 1080p وصوت AAC بست قنوات. أما حلقتا المسلسل فهما ملفان ولدناهما بأداة FFmpeg، لأن ما يهمنا فيهما هو الاسم العربي فقط.
إضافة المكتبات وأول فحص
أضفنا مكتبتين: «الأفلام» من نوع Movies على /media/movies، و«المسلسلات» من نوع Shows على /media/shows، ثم طلبنا الفحص. وأخذ الفحص 29.5 ثانية لأربعة ملفات، أغلبها في جلب البيانات والصور من الإنترنت وفي مهام ما بعد الفحص، وظهر في السجل "Scan Media Library" Completed after 0 minute(s) and 28 seconds. ثم سألنا السيرفر عما وجده:
curl -s -H "Authorization: MediaBrowser Token=\"$TOKEN\"" \
"http://127.0.0.1:8096/Items?Recursive=true&IncludeItemTypes=Movie,Series,Episode&Fields=OriginalTitle,ProductionYear,ProviderIds,OfficialRating"والنتيجة بعد تحويل JSON إلى أسطر كانت كما يلي:
Episode | محاضرات الشبكات S01E01 | | | | {} | /media/shows/محاضرات الشبكات (2026)/Season 01/محاضرات الشبكات S01E01.mkv
Episode | محاضرات الشبكات S01E02 | | | | {} | /media/shows/محاضرات الشبكات (2026)/Season 01/محاضرات الشبكات S01E02.mkv
Movie | أرنب كبير | Big Buck Bunny | 2008 | G | {"Imdb":"tt1254207","Tmdb":"10378"} | /media/movies/Big Buck Bunny (2008)/Big Buck Bunny (2008).mov
Series | محاضرات الشبكات | | 2026 | | {} | /media/shows/محاضرات الشبكات (2026)
Movie | Sintel | Sintel | 2010 | PG | {"Imdb":"tt1727587","Tmdb":"45745"} | /media/movies/Sintel (2010)/Sintel (2010).mkvوفي المخرج أعلاه لاحظ التالي:
- الفيلمان تمت مطابقتهما بشكل صحيح، وكل واحد له معرف في TMDB وIMDb، وهذا ما تريده لكل ملف في مكتبتك.
- الفيلم الأول ظهر بعنوان عربي «أرنب كبير» ووصف عربي، لأن متطوعين ترجموا بياناته في TMDB، أما Sintel فبقي بالإنجليزية لأنه لا توجد له ترجمة عربية هناك. لذلك فلغة البيانات الوصفية العربية لا تعني أن كل المكتبة سوف تصبح بالعربية، وإنما تعني أن كل ما له ترجمة سوف يظهر بها.
- المسلسل العربي لم يطابق أي شيء، فأخذ Jellyfin الاسم من المجلد والسنة من القوسين، وأخذ اسم كل حلقة من اسم الملف. وهذا هو السلوك الصحيح لتسجيلات العائلة والمحاضرات: الاسم العربي في المجلد يكفي.
- التصنيف العمري
GوPGجاء من TMDB بالتصنيف الأمريكي، وسوف نحتاجه في الرقابة الأبوية.
والصورة التالية صفحة الفيلم الأول في واجهة الويب بعد الفحص، بالعنوان والوصف والأنواع والغلاف بالعربية:

وقد يتساءل البعض: ماذا لو طابق Jellyfin فيلماً بفيلم آخر يحمل نفس الاسم؟ والإجابة أن الحل الأقوى من أي تعديل يدوي هو أن تضع المعرف في اسم المجلد، مثل Sintel (2010) [tmdbid-45745]، كما تذكر صفحة التسمية، وعندها لا يبحث السيرفر بالاسم أصلاً. أما إذا كانت المكتبة مرتبة بطريقتك الخاصة وتريد التحكم الكامل بالبيانات، فيقرأ Jellyfin ملفات NFO بجانب كل فيلم، وهي نفس الصيغة التي تستخدمها Kodi.
الترجمة العربية: SRT وASS والخطوط
هذا القسم هو الذي لن تجده في أغلب الشروحات، لأنه لا يظهر إلا مع اللغة العربية. وقد واجهتنا فيه ثلاث حالات مختلفة، والصورة التالية تلخصها قبل التفاصيل:

ملف SRT بترميز Windows-1256
ملف الترجمة العربية الرسمي لفيلم Sintel منشور في مجلد الترجمات على موقع Blender، وعندما فتحناه وجدنا أن الأداة file تقول عنه:
sintel_ar.srt: ISO-8859 text, with CRLF line terminatorsأي أنه ليس UTF-8، وإنما مكتوب بالترميز القديم Windows-1256 الذي كانت تستخدمه برامج الترجمة العربية على Windows. وإذا عرضته كما هو تظهر حروف مثل ��� ����� ����، وهي المشكلة التي يعرفها كل من شاهد فيلماً مترجماً على مشغل قديم. وبعد أن وضعنا الملف باسم Sintel (2010).ar.srt بجانب الفيلم، طلبنا من Jellyfin الترجمة كما يرسلها للأجهزة:
curl -s -H "Authorization: MediaBrowser Token=\"$TOKEN\"" \
"http://127.0.0.1:8096/Videos/$ID/$ID/Subtitles/0/0/Stream.srt" | head -81
00:01:47,250 --> 00:01:50,500
هذا النصل يملك ماضى مظلم
2
00:01:51,800 --> 00:01:55,800
لقد سفكت العديد من دماء الأبرياء.أي أن Jellyfin اكتشف الترميز وحوله إلى UTF-8 قبل أن يرسله، فظهرت الترجمة في المتصفح صحيحة ومتصلة، كما في اللقطة التالية من تشغيل حقيقي في Chrome:

ولكن لا تعتمد على ذلك، والسبب أن نفس الملف سوف يفتحه تطبيق آخر غير Jellyfin، مثل VLC من المجلد المشترك أو مشغل التلفاز إذا شغل الملف مباشرة، وهذه لا تكتشف الترميز دائماً. لذلك فالأسلم أن تحول كل ملفات الترجمة العربية القديمة إلى UTF-8 مرة واحدة:
iconv -f CP1256 -t UTF-8 sintel_ar.srt > "Sintel (2010).ar.srt"
file "Sintel (2010).ar.srt"ترجمة ASS ظهرت مربعات فارغة
صيغة ASS أغنى من SRT، فهي تحمل الخط واللون والحجم والموضع، وتستخدم كثيراً في الترجمات المنسقة. وقد حولنا نفس الترجمة إلى ASS بخط IBM Plex Sans Arabic ولون أصفر، ووضعناها باسم Sintel (2010).Arabic Styled.ar.ass، وفهم Jellyfin من الاسم أن اللغة عربية وأن عنوان المسار Arabic Styled، كما تشرح صفحة التسمية: كل نص في الاسم لا يفهمه كلغة أو علامة يصبح عنواناً. ثم شغلنا الفيلم في المتصفح، فظهرت الترجمة كما في الصورة التالية:

والسبب أن المتصفح لا يرسم ترجمة ASS بخطوطه كما يفعل مع SRT، وإنما تحمل واجهة Jellyfin مكتبة libass مترجمة إلى WebAssembly ترسم الترجمة في Canvas فوق الفيديو، ووجدنا في الصفحة العنصر CANVAS.libassjs-canvas، وهذه المكتبة لا ترى خطوط النظام، وإنما الخطوط التي يرسلها لها السيرفر فقط. وإذا لم يجد الخط المطلوب ولا خطاً احتياطياً فيه حروف عربية، رسمت مربعاً لكل حرف. والحل في إعدادات التشغيل Playback: تضع مجلد الخطوط الذي ربطناه في /fallback_fonts وتفعل الخطوط الاحتياطية Fallback Fonts، وفعلنا ذلك عبر الواجهة البرمجية ثم تحققنا أن السيرفر يرى الخطوط:
curl -s -H "Authorization: MediaBrowser Token=\"$TOKEN\"" http://127.0.0.1:8096/FallbackFont/Fonts[{"Name":"IBMPlexSansArabic-Regular.ttf","Size":235924,...},{"Name":"IBMPlexSansArabic-Bold.ttf","Size":246992,...}]وبعد إعادة تشغيل الفيلم ظهرت الترجمة كما يجب، بالخط واللون المحددين في الملف:

الحرق في الصورة Burn-in: الحل الأخير
بعض التلفازات القديمة وأجهزة البث الرخيصة لا ترسم ترجمة ASS أبداً، وعندها لا يبقى إلا أن يرسم السيرفر الترجمة داخل الصورة نفسها، وهذا يعني إعادة ترميز الفيديو كله. وقد طلبنا ذلك من السيرفر بملف قدرات Device Profile لتلفاز لا يقبل إلا MP4 وAAC ويطلب حرق كل الترجمات، فرجع بهذا السبب:
TranscodeReasons=ContainerNotSupported,AudioCodecNotSupported,SubtitleCodecNotSupportedثم شغلنا التحويل مرتين على الدقائق الست كاملة، مرة دون ترجمة ومرة مع حرق ترجمة ASS، وكانت النتيجة 312 ثانية من وقت المعالج دون ترجمة، و423 ثانية مع الحرق، أي زيادة بنحو 35%، ونزلت سرعة التحويل من 3.15 ضعف زمن الفيديو إلى 1.76. وفي سجل FFmpeg تجد المرشح Filter الذي أضافه السيرفر:
subtitles=f='/media/movies/Sintel (2010)/Sintel (2010).Arabic Styled.ar.ass':charenc=utf-8:fontsdir='/config/data/attachments/4d/4d9bae7b-a369-f704-2226-5cc2c7634e95'ولاحظ أن مكتبة libass داخل FFmpeg مبنية مع HarfBuzz وFriBidi، وهما ما يشبك الحروف العربية ويرتبها من اليمين لليسار، ولذلك ظهر الإطار التالي الذي استخرجناه من أحد أجزاء التحويل صحيحاً، وبالخط الذي وضعناه في /usr/local/share/fonts/custom:

والخلاصة العملية أن ترتيب الحلول من الأرخص إلى الأغلى هو: SRT بترميز UTF-8 أولاً، ثم ASS مع خط احتياطي، ثم الحرق فقط للجهاز الذي لا يستطيع غير ذلك.
Direct Play أم Transcode؟ كيف يقرر Jellyfin
كل تطبيق يتصل بـ Jellyfin يرسل معه وصفاً لقدراته اسمه ملف الجهاز Device Profile: أي حاويات يقبل، وأي ترميزات للصورة والصوت، وكم قناة صوت، وأي صيغ ترجمة يرسمها بنفسه، وما أعلى معدل بت. ويقارن السيرفر هذا الوصف بالملف، ويختار أخف طريقة ممكنة. وتشرح صفحة التحويل أربع طرق مرتبة من الأخف إلى الأثقل:
- التشغيل المباشر Direct Play: يرسل السيرفر الملف كما هو، ولا يعمل المعالج تقريباً.
- إعادة التغليف Remux: الحاوية لا تناسب الجهاز، فينقل السيرفر الصورة والصوت إلى حاوية أخرى دون أي ترميز.
- البث المباشر Direct Stream: الصورة كما هي، والصوت فقط يعاد ترميزه.
- التحويل Transcode: الصورة نفسها يعاد ترميزها، وهذا هو الثقيل.

ولكي نرى القرار بأعيننا، أرسلنا إلى المسار /Items/{id}/PlaybackInfo ملف قدرات لجهاز بسيط يقبل H.264 وAAC بقناتين فقط، وهو وصف قريب من كثير من أجهزة البث الرخيصة. والملف كاملاً في مجلد التجربة باسم prof-basic.json، وأهم ما فيه:
{"DeviceProfile":{"Name":"lab-basic","MaxStreamingBitrate":20000000,
"DirectPlayProfiles":[{"Container":"mp4,mkv,mov","Type":"Video","VideoCodec":"h264","AudioCodec":"aac"}],
"TranscodingProfiles":[{"Container":"ts","Type":"Video","VideoCodec":"h264","AudioCodec":"aac","Protocol":"hls","Context":"Streaming","MaxAudioChannels":"2"}],
"CodecProfiles":[{"Type":"VideoAudio","Codec":"aac","Conditions":[{"Condition":"LessThanEqual","Property":"AudioChannels","Value":"2","IsRequired":true}]}]}}ورجع السيرفر لإعلان Big Buck Bunny بما يلي:
DirectPlay: false DirectStream: false Transcoding: true
Reasons: TranscodeReasons=AudioChannelsNotSupported
URL: /videos/40ee5c18-0e6d-5bb9-2bae-a3ccc6107f28/master.m3u8?DeviceId=hl2-lab-1&MediaSourceId=40ee5c180e6d5bb92baea3ccc6107f28&VideoCodec=h264&AudioCodec=aac&AudioStreamIndex=1&VideoBitrate=19571395&AudioBitrate=428605&MaxFramerate=25&SegmentContainer=ts&...أي أن الصورة H.264 مناسبة تماماً، ولكن الصوت بست قنوات والجهاز يقبل قناتين، فلم يعد التشغيل المباشر ممكناً. وهذا مثال مهم، لأن كثيراً من الناس يظنون أن الصورة هي سبب التحويل دائماً، بينما يكون السبب في أحيان كثيرة الصوت أو الترجمة. ثم اختبرنا نفس الشيء بمتصفح Chrome حقيقي على فيلم Sintel، وصوته AC3 الذي لا يشغله المتصفح، فاختار السيرفر Direct Stream، وظهر في سجل FFmpeg:
Stream mapping:
Stream #0:0 -> #0:0 (copy)
Stream #0:1 -> #0:1 (ac3 (native) -> aac (libfdk_aac))
frame= 888 fps=439 q=-1.0 size=N/A time=00:00:31.06 bitrate=N/A speed=15.4x elapsed=0:00:02.02والمهم في هذا المخرج كلمة copy للصورة، أي أنها تنتقل كما هي، أما الصوت فيحول من AC3 إلى AAC بقناتين، وكانت السرعة 15.4 ضعف زمن الفيديو، أي أن هذا النوع من التحويل لا يكاد يشعر به السيرفر. وفي نفس السجل تجد -af "volume=2"، وهذا تعزيز الصوت الذي يضيفه Jellyfin عند تحويل ست قنوات إلى قناتين حتى لا يظهر الحوار منخفضاً، وتشرحه صفحة خفض القنوات Downmix.
/Sessions. فإذا كان السبب الصوت فقط فالحل غالباً إعداد في التطبيق، أما إذا كان الترميز أو الدقة فالحل في الملف أو في العتاد.تجربة: كم يكلف التحويل فعلاً؟
لكي نحول الكلام عن «ثقل» التحويل إلى أرقام، كتبنا سكربتاً صغيراً بلغة JavaScript يتصرف مثل جهاز يشاهد الفيديو بأسرع ما يمكن: يطلب قائمة HLS من السيرفر، ثم يحمل كل الأجزاء Segments بالترتيب، ويقيس ثلاثة أشياء: الزمن حتى أول جزء، أي ما ينتظره المشاهد قبل أن تظهر الصورة، والزمن الكلي، وثواني المعالج التي استهلكها ال Container كله، ويقرؤها من عداد cgroup قبل التجربة وبعدها. وتقييد التحويل Throttling موقوف في الإعداد الافتراضي لهذا الإصدار، فيعمل FFmpeg بأقصى سرعته ونرى كلفته الحقيقية. والسكربت كاملاً في ملف jf-measure.mjs، وأهم سطرين فيه:
const cpu = () => +execFileSync('docker', ['exec', CT, 'cat', '/sys/fs/cgroup/cpuacct/cpuacct.usage']).toString() / 1000;
const master = await (await fetch(`${J}/Videos/${item}/master.m3u8?MediaSourceId=${item}&PlaySessionId=${ps}&DeviceId=hl2-measure&ApiKey=${TOKEN}&${qs}`)).text();وقد أصابنا في المحاولة الأولى خطأ يستحق الذكر: كتبنا المسار /sys/fs/cgroup/cpu.stat كما في الأنظمة الحديثة التي تستخدم cgroup v2، فرجع الأمر بالخطأ No such file or directory، والسبب أن النظام كان يستخدم cgroup v1، كما في WSL2 وبعض التوزيعات القديمة، وفيه العداد في cpuacct.usage بالنانوثانية. لذلك تحقق من نسخة cgroup قبل أن تعتمد على أي سكربت قياس، فالمسار يختلف بينهما. ثم شغلنا خمسة أنواع من الطلبات على نفس الإعلان بدقة 1080p ومدته 33 ثانية:
B=40ee5c180e6d5bb92baea3ccc6107f28
node jf-measure.mjs direct-play $B static
node jf-measure.mjs remux-audio $B "VideoCodec=h264&AudioCodec=aac&TranscodingMaxAudioChannels=2&SegmentContainer=ts&AllowVideoStreamCopy=true&AllowAudioStreamCopy=false&AudioBitrate=192000"
node jf-measure.mjs transcode-720p $B "VideoCodec=h264&AudioCodec=aac&TranscodingMaxAudioChannels=2&SegmentContainer=ts&MaxWidth=1280&VideoBitrate=2000000&AudioBitrate=128000&AllowVideoStreamCopy=false"
node jf-measure.mjs transcode-1080p $B "VideoCodec=h264&AudioCodec=aac&TranscodingMaxAudioChannels=2&SegmentContainer=ts&VideoBitrate=4000000&AudioBitrate=128000&AllowVideoStreamCopy=false"
node jf-measure.mjs transcode-hevc-1080p $B "VideoCodec=hevc&AudioCodec=aac&TranscodingMaxAudioChannels=2&SegmentContainer=mp4&VideoBitrate=4000000&AudioBitrate=128000&AllowVideoStreamCopy=false"والمخرج سوف يكون كما يلي:
direct-play: first=0.16s total=2.0s bytes=30.9MB segs=0 avgCores=0.68 cpuSec=1.4
remux-audio: first=0.55s total=1.4s bytes=30.7MB segs=6 avgCores=1.52 cpuSec=2.2
transcode-720p: first=2.77s total=11.6s bytes=4.7MB segs=11 avgCores=3.26 cpuSec=37.9
transcode-1080p: first=3.73s total=11.7s bytes=5.3MB segs=11 avgCores=2.96 cpuSec=34.5
transcode-hevc-1080p: first=14.56s total=55.1s bytes=4.1MB segs=11 avgCores=1.98 cpuSec=109.1
وفي هذه الأرقام لاحظ التالي:
- التشغيل المباشر وإعادة التغليف كلفتهما ثانية أو ثانيتان من المعالج لمقطع كامل، أي لا شيء تقريباً، وفي الثاني ستة أجزاء فقط لأن الصورة المنسوخة لا تقطع إلا عند الإطارات المفتاحية Keyframes الموجودة أصلاً في الملف.
- التحويل إلى H.264 بدقة 720p استهلك 37.9 ثانية من المعالج لكل 33 ثانية من الفيديو، أي أكثر من نواة كاملة لكل مشاهد طوال وقت المشاهدة. وفي سجل FFmpeg ظهرت السرعة
speed=2.88xوfps= 73، فهذا المعالج بثمانية خيوط يتحمل نحو مشاهدين أو ثلاثة بهذه الطريقة قبل أن يبدأ التقطيع. - طلب التحويل بمعدل 4 ميجابت ولم نحدد العرض، ومع ذلك ظهر في سجل FFmpeg المرشح
scale=trunc(min(max(iw\,ih*a)\,1280)/2)*2، أي أن السيرفر خفض الدقة إلى 1280 بنفسه. وهذا ما تقوله صفحة التحويل: الدقة الناتجة يحددها السيرفر من معدل البت والترميز وقيود الجهاز، ولا يوجد إعداد يفرضها يدوياً. - التحويل إلى HEVC هو الحالة التي يجب أن تخيفك: 109 ثوان من المعالج، وأول جزء بعد 14.6 ثانية، والسرعة في السجل
speed=0.594x، أي أن السيرفر يصنع 0.6 ثانية من الفيديو في كل ثانية، والمشاهد سوف يرى دائرة التحميل كل بضع ثوان مهما انتظر.
وقد يتساءل البعض: من يطلب HEVC أصلاً؟ والإجابة أن بعض التطبيقات تطلبه عندما يكون الاتصال ضعيفاً لأنه يعطي نفس الجودة بحجم أقل، وهنا يصبح الجهاز الذي يحاول أن يوفر الإنترنت هو نفسه سبب التقطيع. ولهذا السبب فالمعالج وحده يكفي لبيت أغلب أجهزته تشغل الملفات مباشرة، أما إذا كانت المكتبة كبيرة والأجهزة متنوعة فالتحويل بالعتاد ليس رفاهية.
التحويل بالعتاد Hardware Acceleration
التحويل بالعتاد يعني أن تقوم وحدة ترميز مخصصة داخل بطاقة الرسوميات أو داخل الرسوميات المدمجة في المعالج بفك الترميز وإعادته، بدلاً من نوى المعالج. وتشرح صفحة التحويل بالعتاد أن Jellyfin يدعم Intel Quick Sync وNVIDIA NVENC وAMD AMF وVA-API وApple VideoToolbox وRockchip، وأن التحويل يمر بمراحل: فك الترميز، ثم إزالة التشابك عند الحاجة، ثم تغيير الحجم، ثم تحويل HDR إلى SDR، ثم حرق الترجمة، ثم الترميز. وكلما بقيت كل هذه المراحل على بطاقة الرسوميات كان التحويل أسرع، أما إذا رجعت مرحلة واحدة إلى المعالج، مثل حرق الترجمة في بعض الحالات، فتسمى هذه الحالة تسريعاً جزئياً Partial Acceleration، ويرتفع استهلاك المعالج من جديد.
وقبل أن تبدأ يجب أن تعرف أن التحويل بالعتاد يحتاج Linux يرى بطاقة الرسوميات مباشرة، وتقول صفحة Intel صراحة إن QSV غير متاح في Docker على Windows ولا في WSL2. وما يلي من التوثيق الرسمي، وهو ما تحتاجه لكي تختار العتاد وتجهزه:
- Intel هو الخيار الأفضل للبيت: لا يوجد حد لعدد جلسات الترميز المتزامنة كما في NVENC، والرسوميات المدمجة لا تستهلك كهرباء تذكر. ويشترط التوثيق الجيل السادس Skylake لترميز HEVC بثمانية بت، والجيل السابع Kaby Lake لـ HEVC بعشرة بت، والجيل الحادي عشر Tiger Lake لفك ترميز AV1، ومعالجات Arc أو Meteor Lake لترميز AV1.
- ابتعد عن H.264 بعشرة بت: يذكر التوثيق أن فك ترميزه بالعتاد غير مدعوم على Intel وNVIDIA وAMD، فيرجع إلى المعالج.
- المجلد المؤقت على SSD أو RAM: أجزاء التحويل تكتب وتقرأ باستمرار، وقد وجدنا في التجربة 50.9 ميجابايت من الأجزاء في
/cache/transcodesبعد بضع تجارب فقط.
وفي Docker على Linux يكفي أن تمرر جهاز الرسوميات إلى ال Container وتضيف مجموعة render، والمثال التالي من صفحة Intel نفسها:
services:
jellyfin:
image: jellyfin/jellyfin
user: 1000:1000
group_add:
- '122' # Change this to match your "render" host group id and remove this comment
network_mode: 'host'
volumes:
- /path/to/config:/config
- /path/to/cache:/cache
- /path/to/media:/media
devices:
- /dev/dri/renderD128:/dev/dri/renderD128ثم تتحقق من داخل ال Container أن الترميزات ظاهرة بالأمر الذي يذكره التوثيق، قبل أن تختار طريقة التسريع في لوحة التحكم:
docker exec -it jellyfin /usr/lib/jellyfin-ffmpeg/vainfoوإذا كان Jellyfin يعمل في Proxmox فقد شرحنا في LXC في Proxmox كيف تمرر نفس الجهاز إلى Container من نوع LXC، وهي الطريقة الأكثر انتشاراً في المختبرات المنزلية. أما إذا كنت تريد أن تقلل الحاجة إلى التحويل من الأساس، فالحل أن تجهز الملفات مسبقاً بصيغة تناسب أجهزتك، كما شرحنا في تحويل مكتبة الفيديو تلقائياً مع Tdarr.
المستخدمون والرقابة الأبوية Parental Controls
لكل فرد في البيت حساب مستقل، وهذا ليس ترفاً، فالحساب هو ما يحفظ ما شاهده كل شخص وأين توقف، وهو ما يسمح بأن ترى الأم قائمة «تابع المشاهدة» الخاصة بها وليس بالأطفال. وتشرح صفحة إدارة المستخدمين ثلاثة أنواع من القيود: المكتبات التي يراها المستخدم، والأجهزة التي يدخل منها، والرقابة الأبوية بالتصنيف العمري والوسوم وجدول الوقت. وقد أنشأنا حساباً للأطفال باسم kids وطبقنا عليه سياسة Policy كاملة:
p.MaxParentalRating = 10;
p.BlockUnratedItems = ["Movie", "Series"];
p.EnableContentDownloading = false;
p.AccessSchedules = [{ "DayOfWeek": "Everyday", "StartHour": 16, "EndHour": 20 }];ثم سألنا السيرفر عما يراه كل حساب:
kids sees 2
Movie أرنب كبير G
Movie Sintel PG
admin sees 3
Movie أرنب كبير G
Series محاضرات الشبكات (no rating)
Movie Sintel PG
kids login now: 403وفي هذا المخرج ثلاث نتائج تستحق الوقوف عندها:
- المسلسل الذي لا تصنيف له اختفى عن الأطفال، بسبب
BlockUnratedItems. وهذا مهم في البيت تحديداً، لأن تسجيلات العائلة ومقاطع YouTube المحفوظة لا تصنيف لها، وإذا لم تحجب ما لا تصنيف له فسوف يرى الأطفال كل شيء غير مصنف. - فيلم Sintel وتصنيفه PG بقي ظاهراً مع أننا ظننا أن الحد 10 يعني ما يناسب الأطفال. والسبب أن التصنيفات في هذا الإصدار تحولت إلى درجات، وقائمتها كما رجعت من المسار
/Localization/ParentalRatingsهيApproved=0ثم10و13و14و21، والتصنيف PG يقع عند الدرجة 10. وعندما غيرنا الحد إلى 0 أصبح حساب الأطفال يرى فيلماً واحداً فقط هو «أرنب كبير». لذلك لا تختر الحد من الرقم، وإنما جرب الحساب بنفسك بعد كل تغيير. - محاولة الدخول بحساب الأطفال الساعة 13:32 رجعت بالرمز 403، وفي السجل:
Authentication request for "kids" is not allowed at this time due parental restrictions، لأن الجدول يسمح بالدخول بين الرابعة والثامنة مساءً فقط. ولاحظ أن الرفض حدث قبل التحقق من كلمة المرور.
والصورة التالية صفحة الرقابة الأبوية لنفس الحساب في لوحة التحكم:

وهنا يجب أن نقول بوضوح ما لا تفعله هذه القيود: هي تخفي المحتوى داخل Jellyfin فقط، ولا تحمي الملفات إذا كانت نفس المكتبة مشاركة على الشبكة بمجلد مفتوح، ولا تمنع الطفل من الدخول بحساب أحد الوالدين إذا كانت كلمة مروره محفوظة في التلفاز. لذلك اجعل لكل جهاز في غرفة الأطفال حسابهم فقط، وإذا كنت تريد حماية أوسع تشمل الإنترنت كله فهذا موضوع مقال حماية الأطفال بفلترة DNS في نفس المرحلة، وتجده في البطاقات آخر المقال.
الوصول من خارج البيت: Reverse Proxy
إذا أردت أن تشاهد مكتبتك من خارج البيت فأمامك طرق كثيرة شرحناها في تشغيل خادمك من إنترنت المنزل، وأكثرها أماناً للعائلة ألا تفتح أي منفذ، وأن تدخل عبر WireGuard، لأن Jellyfin سوف يرى جهازك كأنه في البيت. أما إذا قررت أن تنشره باسم نطاق مع HTTPS، فتوصي صفحة ال Reverse Proxy بثلاثة أمور: أن يسمح ال Proxy بال WebSockets، وألا تكتب الروابط كاملة في سجلاته لأن Jellyfin يرسل أحياناً مفتاح الدخول في الرابط باسم api_key، وأن تضيف عنوان ال Proxy في قائمة Known Proxies. وقد اختبرنا الثالث تحديداً لأنه الأكثر نسياناً، فشغلنا Caddy أمام Jellyfin بهذا الملف:
jellyfin.home.arpa {
tls internal
reverse_proxy jellyfin:8096
log {
output stdout
format filter {
request>uri query {
replace ApiKey REDACTED
replace api_key REDACTED
}
}
}
}واستخدمنا tls internal لأن الاسم داخلي ولا يمكن الحصول له على شهادة عامة، أما مع نطاقك الحقيقي فيكفي أن تحذف هذا السطر ليحصل Caddy على شهادة Let's Encrypt بنفسه، كما في مثال Caddy في توثيق Jellyfin. ولاحظ قسم log الذي يستبدل مفتاح الدخول في السجل بكلمة REDACTED. ثم أرسلنا عبر ال Proxy طلب دخول برأس مزور X-Forwarded-For: 203.0.113.50، كما يفعل من يحاول أن يخفي عنوانه، وقرأنا ما سجله Jellyfin:

قبل إضافة Known Proxies سجل Jellyfin كل الطلبات من عنوان Caddy نفسه 172.25.0.3، وهذا يعني أن قيود الشبكة المحلية لا معنى لها، فكل من يأتي من الإنترنت يبدو كأنه في البيت، وأن حظر العناوين بعد محاولات الدخول الفاشلة سوف يحظر ال Proxy نفسه فيحظر الجميع. ثم أضفنا العنوان، ولم يتغير شيء حتى أعدنا تشغيل Jellyfin، وهذه ملاحظة مهمة لأن إعدادات الشبكة تحتاج إعادة تشغيل، وبعدها ظهر العنوان الحقيقي للجهاز 172.25.0.1. ولاحظ أن العنوان المزور 203.0.113.50 لم يظهر أبداً، لأن Caddy يستبدل الرأس القادم من جهاز لا يثق به برأس جديد فيه العنوان الحقيقي.
النسخ الاحتياطي Backup والاستعادة
هناك شيئان مختلفان تماماً في سيرفر الوسائط: الأفلام نفسها، وهي كبيرة ومهمة ويجب أن تكون في نظام النسخ الاحتياطي العام للبيت كما شرحنا في قاعدة 3-2-1، وبيانات Jellyfin، وهي صغيرة ولكنها تحمل كل ما بنيته: المستخدمون وكلمات المرور وما شاهده كل شخص والمكتبات والإعدادات. وتشرح صفحة النسخ الاحتياطي أن النسخ المدمج أضيف في الإصدار 10.11 ويعمل والسيرفر يعمل، فاختبرناه:
curl -s -X POST -H "Content-Type: application/json" -H "Authorization: MediaBrowser Token=\"$TOKEN\"" \
http://127.0.0.1:8096/Backup/Create -d '{"Metadata":true,"Trickplay":false,"Subtitles":true,"Database":true}'{"ServerVersion":"12.4.0.0","BackupEngineVersion":"0.2.0","DateCreated":"2026-11-18T10:50:11.4664987+00:00","Path":"/config/data/backups/jellyfin-backup-20261118135011.zip","Options":{"Metadata":true,"Trickplay":false,"Subtitles":true,"Database":true}}أخذ إنشاء النسخة 4.1 ثانية، وحجم الملف 4.9 ميجابايت لمكتبتنا الصغيرة، وعندما فتحناه وجدنا جداول قاعدة البيانات محفوظة كملفات JSON مثل Database/Users.json وDatabase/AccessSchedules.json، ومعها مجلد البيانات الوصفية وملف manifest.json. ولكن لاحظ مكانها: داخل /config/data/backups، أي داخل نفس ال Volume الذي تحاول حمايته، فإذا تلف القرص ضاعت النسخة معه. لذلك يجب أن تنسخ هذا المجلد إلى مكان آخر، كما شرحنا في النسخة خارج السيرفر. وللاستعادة تختار النسخة من لوحة التحكم، أو تشغل السيرفر بالخيار --restore-archive مع مسار الملف.
أما الطريقة اليدوية فتشترط أن توقف السيرفر أولاً، لأن نسخ قاعدة بيانات SQLite وهي مفتوحة قد يعطيك ملفاً لا يصلح للاستعادة:
docker compose stop jellyfin
docker run --rm -v jellyfin-config:/config:ro -v "$PWD":/backup alpine \
tar czf /backup/jellyfin-config-$(date +%F)-12.4.tgz -C / config
docker compose start jellyfinولا تنسخ مجلد /cache، فكل ما فيه يعاد توليده، وقد كان أكبر ما فيه في تجربتنا أجزاء التحويل في /cache/transcodes، وتنظفها مهمة مجدولة باسم Clean Transcode Directory.
التحديث Upgrade إلى إصدار أحدث
أهم جملة في توثيق النسخ الاحتياطي هي أن Jellyfin لا يملك طريقة للرجوع إلى إصدار أقدم: بمجرد أن يبدأ الإصدار الجديد ينفذ ترحيل قاعدة البيانات، ولا تعمل البيانات بعدها مع الإصدار القديم. ولذلك فخطوات التحديث كما يلي:
- اقرأ ملاحظات الإصدار في صفحة الإصدارات، وخاصة أي تغيير في التطبيقات أو الإضافات.
- خذ نسخة احتياطية، ويفضل اليدوية مع إيقاف السيرفر، وضع رقم الإصدار في اسم الملف.
- غير الوسم في ملف compose إلى الإصدار الجديد، ثم نفذ
docker compose pullوdocker compose up -d. - تابع السجل حتى يظهر
Startup complete، ثم جرب تشغيل فيلم من التلفاز والجوال، لأن بعض التطبيقات القديمة قد تتوقف بعد التحديثات الكبيرة، كما حدث مع الإصدار 12.0 الذي حذف المسارات القديمة.
أخطاء شائعة
- أسماء ملفات كما جاءت من التنزيل:
movie.2010.1080p.x264-GROUP.mkvفي مجلد واحد مع عشرين فيلماً، فيطابق الفاحص بعضها خطأً. مجلد لكل فيلم واسم وسنة يحلان أغلب المشكلة. - ترجمات عربية بترميز قديم: تعمل في Jellyfin وتظهر مشوهة في كل مكان آخر. حولها إلى UTF-8 مرة واحدة.
- لا يوجد خط عربي للترجمة المنسقة: تظهر ترجمة ASS مربعات فارغة في المتصفح. ضع خطاً في مجلد الخطوط الاحتياطية.
- الظن بأن المعالج يكفي لكل شيء: مشاهد واحد بتحويل HEVC كان أبطأ من زمن الفيديو في تجربتنا.
- الوسم latest في ملف compose: ينقلك إلى إصدار رئيسي جديد دون أن تختار، ولا رجوع إلا من نسخة احتياطية.
- Reverse Proxy دون Known Proxies: كل الطلبات تبدو من نفس العنوان، فلا تعمل قيود الشبكة ولا الحظر. وتذكر أن هذا الإعداد يحتاج إعادة تشغيل.
- حساب الأطفال دون حجب ما لا تصنيف له: تسجيلات العائلة والمقاطع المحفوظة لا تصنيف لها، فتظهر لهم كلها.
- مكتبة الأفلام مربوطة للكتابة: لا يحتاج Jellyfin إلى الكتابة فيها، فاربطها للقراءة فقط.
قائمة تحقق Checklist قبل أن تعطي الرابط للعائلة
| البند | كيف تتحقق |
|---|---|
| إصدار مثبت | الوسم في compose رقم إصدار مثل 12.4 وليس latest |
| المكتبة للقراءة فقط | read_only: true على مجلد الوسائط |
| كل فيلم مطابق | لا توجد أفلام دون معرف TMDB في المكتبة، وأي حالة غامضة فيها المعرف في اسم المجلد |
| الترجمة العربية | ملفات SRT بترميز UTF-8، وخط عربي في مجلد الخطوط الاحتياطية، وتجربة ملف ASS واحد |
| طريقة التشغيل على كل جهاز | شغل فيلماً من التلفاز والجوال والمتصفح وانظر في لوحة التحكم: Direct Play أم تحويل؟ |
| حسابات العائلة | حساب لكل فرد، وحساب الأطفال بحد تصنيف مجرب وحجب ما لا تصنيف له وجدول وقت |
| الوصول من الخارج | عبر VPN، أو Reverse Proxy مع HTTPS وKnown Proxies وسجل لا يكتب مفاتيح الدخول |
| النسخ الاحتياطي | نسخة من /config خارج القرص نفسه، وتجربة استعادة واحدة على الأقل |
تدريب عملي
- أرسل إلى المسار
/Items/{id}/PlaybackInfoملف القدراتprof-basic.jsonمرة لكل فيلم في مكتبتك، واكتب لكل فيلم طريقة التشغيل والسبب. ثم غير في الملفMaxAudioChannelsإلى 6 وأعد التجربة، ولاحظ أي الأفلام انتقلت إلى Direct Play. - شغل
jf-measure.mjsعلى أكبر فيلم عندك بطلب تحويل إلى 720p، واقسم ثواني المعالج على مدة الفيلم، فهذا هو عدد النوى التي يأخذها كل مشاهد يحتاج التحويل في بيتك.
الخلاصة
- Jellyfin يحول مجلد الأفلام إلى مكتبة لها أسماء وصور وحسابات وأماكن توقف، ويختار لكل جهاز أخف طريقة تشغيل، وهو مفتوح المصدر بالكامل دون حساب أو اشتراك.
- التسمية هي أساس كل شيء: مجلد لكل فيلم باسمه وسنته، والمسلسلات بمواسم وأرقام حلقات، والأسماء العربية تعمل لما لا يعرفه مزودو البيانات.
- البيانات بالعربية تظهر لكل ما له ترجمة في TMDB فقط، فظهر «أرنب كبير» بالعربية وبقي Sintel بالإنجليزية.
- الترجمة العربية تحتاج ترميز UTF-8 لملفات SRT، وخطاً عربياً في مجلد الخطوط الاحتياطية لملفات ASS، والحرق في الصورة كلف 35% زيادة في المعالج.
- في قياسنا كلف التشغيل المباشر ثانية واحدة من المعالج، والتحويل إلى 720p نحو 38 ثانية لكل 33 ثانية من الفيديو، وتحويل HEVC كان أبطأ من الفيديو نفسه، فالتحويل بالعتاد ضروري إذا كثرت الأجهزة التي تحتاجه.
- حساب الأطفال يحتاج تجربة فعلية بعد كل تغيير، والوصول من الخارج يحتاج Known Proxies، والنسخ الاحتياطي المدمج يحفظ داخل نفس ال Volume فانسخه إلى خارجه.
- وفي المقالات التالية من هذه المرحلة نقارن Jellyfin وPlex وEmby بالقياس على نفس المكتبة، ثم ننتقل إلى الصور مع Immich، ثم الموسيقى والكتب الصوتية.
دليلJellyfin أم Plex أم Emby؟ مقارنة على نفس المكتبةشغلنا Jellyfin وPlex على نفس الجهاز والملفات وقسنا الإقلاع والذاكرة والتحويل، وقرأنا الأسعار والحسابات من الصفحات الرسمية، لتعرف أي سيرفر وسائط يناسب بيتك ولماذا.
دليلصورك العائلية بعيداً عن Google Photos مع Immichكيف تنقل صور العائلة إلى سيرفرك مع Immich، وماذا يحدث فعلاً عند التعرف على الوجوه والبحث بالعربية على المعالج، وكيف تحمي الصور بنسخة احتياطية حقيقية.
دليلموسيقاك وكتبك الصوتية مع Navidrome وAudiobookshelfكيف تحول مجلد الموسيقى والكتب الصوتية إلى خدمتين على سيرفر البيت، ولماذا ظهرت العناوين العربية مشوهة وفشل البحث العربي في التطبيقات، وكيف ينتقل مكان توقفك في الكتاب بين الأجهزة.
دليلحماية الأطفال على الإنترنت: فلترة المحتوى بالـ DNSكيف تحجب المحتوى غير المناسب وتفرض البحث الآمن وتنظم وقت YouTube لأجهزة الأطفال عبر DNS، مع اختبار حقيقي لما يتجاوز هذه الفلترة.
دليلتحويل مكتبة الفيديو Transcoding تلقائياً مع Tdarrكيف تحول أرشيف فيديو كاملاً إلى HEVC أو AV1 بأداة Tdarr دون أن تخاطر بالأصل، بتجربة كشفت أربعة أعطال قبل أن تلمس المكتبة الحقيقية.
دليلNAS جاهز أم تبنيه بنفسك؟ ما الذي تكسبه وما تخسرهكيف تقرر بين جهاز NAS جاهز وجهاز تبنيه بنفسك، بأرقام الشركات وأسعارها الرسمية وما تعلمناه من هجمات الفدية.سجل التحديثات
18 نوفمبر 2026: كتابة الدليل واختباره على Jellyfin 12.4.0 بال Image الرسمي jellyfin/jellyfin:12.4 وjellyfin-ffmpeg 8.1.3، مع Caddy 2.11.9 أمامه.