🎬 تثبيت Jellystat — إحصائيات لـ Jellyfin

انشر Jellystat على Ubuntu بـ Docker وPostgreSQL — لوحة إحصائيات وسجل مشاهدة لسيرفر Jellyfin الخاص بك، البديل ذاتي الاستضافة لـ Tautulli، على المنفذ 3044.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

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

سكريبت تثبيت آلي — أمر واحد ينشر Jellystat مع PostgreSQL. اربط سيرفر Jellyfin بمفتاح API بعد التثبيت.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/jellystat/jellystat-ubuntu.sh
chmod +x jellystat-ubuntu.sh
sudo bash jellystat-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/jellystat/jellystat-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x jellystat-ubuntu.sh

3 تشغيل المثبّت

يثبّت السكريبت Docker إن لزم، يُنشئ كلمة مرور لقاعدة البيانات وسر JWT، ويُشغّل Jellystat مع PostgreSQL 15 على المنفذ 3044.

sudo bash jellystat-ubuntu.sh

4 إنشاء حساب المسؤول وربط Jellyfin

افتح Jellystat، أنشئ حساب المسؤول، ثم اربط سيرفر Jellyfin بعنوانه ومفتاح API:

http://<your-server-ip>:3044

المنافذ المستخدمة

المنفذالغرض
3044Web UI (host → container 3000) — admin created on first visit
internalPostgreSQL 15 (jellystat-db, not published)
./dbAccumulated statistics (also ./backups)

نظرة عامة

Jellystat هو لوحة إحصائيات وسجل مشاهدة مجانية ومفتوحة المصدر لـ Jellyfin — إنه عملياً Tautulli لعالم Jellyfin. يتصل بسيرفر Jellyfin عبر واجهة API الرسمية، يسجّل كل حدث تشغيل، ويخزّن هذا السجل في قاعدة بيانات PostgreSQL خاصة به، مستقلة عن سجلات Jellyfin نفسها. يُصدر برخصة MIT، ويعرض لك الأكثر مشاهدة، وأكثر المستخدمين نشاطاً، وأوقات ذروة استخدام السيرفر، ويمنحك سجل تشغيل كاملاً قابلاً للبحث يستمر حتى بعد أن يُقلّم Jellyfin سجلاته الداخلية.

لماذا تستخدمه

لوحة تحكم Jellyfin نفسها تعرض ما يُشغَّل الآن لكنها تحتفظ بتفاصيل تاريخية قليلة جداً — يسد Jellystat هذه الفجوة بقاعدة بيانات إحصائيات مخصصة لا تُقلَّم أبداً. إذا كنت تُشغّل سيرفراً مشتركاً للعائلة أو مجتمع صغير، يخبرك Jellystat بأي المسلسلات والأفلام تُشاهَد فعلياً، ومن أثقل مستخدميك، وكيف يتغير الاستخدام بمرور الوقت، كل ذلك من بيانات تملكها بالكامل لأنها لا تغادر سيرفرك أبداً. إنه المكافئ ذاتي الاستضافة المباشر لـ Tautulli لـ Plex، مبني خصيصاً لواجهة Jellyfin بدلاً من كونه مُكيَّفاً من منظومة مختلفة.

متى تحتاجه

  • تُشغّل سيرفر Jellyfin مشتركاً وتريد معرفة أي محتوى يُشاهَد فعلياً مقابل ما يبقى دون استخدام
  • تريد إحصائيات مشاهدة تاريخية تستمر لما بعد ما تحتفظ به سجلات Jellyfin نفسها
  • تحتاج لتحديد أكثر مستخدميك نشاطاً أو أوقات الذروة لتخطيط سعة السيرفر
  • تريد سجل تشغيل قابل للبحث عبر جميع المستخدمين والمكتبات في لوحة واحدة
  • معتاد بالفعل على Tautulli مع Plex وتريد نفس التجربة لسيرفر Jellyfin
  • تحتاج بيانات استخدام لتقرر أي المكتبات أو المحتوى الأقل استخداماً يستحق الاحتفاظ به

من يحتاجه

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

حالات الاستخدام الشائعة

  • معرفة أي الأفلام والمسلسلات تُشاهَد أكثر عبر مكتبة Jellyfin بأكملها
  • تتبع سجل مشاهدة كل مستخدم، والأنواع المفضلة، وإجمالي ساعات المشاهدة
  • تحديد ساعات وأيام الذروة لتخطيط نوافذ صيانة السيرفر حول أوقات الحركة المنخفضة
  • البحث والتصفية في سجل تشغيل كامل يبقى بعد تقليم سجلات Jellyfin نفسها
  • مراقبة جلسات التشغيل النشطة في الوقت الفعلي إلى جانب الاتجاهات التاريخية
  • تصدير أو مراجعة الإحصائيات لتقرير أي محتوى أقل استخداماً يجب إزالته لتحرير مساحة التخزين

الميزات الرئيسية

  • مراقبة الجلسات التي تعرض التشغيل النشط حالياً عبر جميع المستخدمين والأجهزة
  • سجل تشغيل كامل مع بحث وتصفية، مخزَّن بشكل مستقل عن سجلات Jellyfin نفسها
  • إحصائيات لكل مكتبة ولكل مستخدم تغطي إجمالي التشغيلات ووقت المشاهدة ومعدلات الإكمال
  • نظرات عامة على نشاط المستخدمين تُبرز الحسابات الأكثر والأقل نشاطاً
  • مزامنة تلقائية لعناصر المكتبة حتى تبقى الإحصائيات محدثة مع تغيّر فهرس Jellyfin لديك
  • وظيفة نسخ احتياطي واستعادة مدمجة لقاعدة بيانات الإحصائيات نفسها
  • تكامل إضافة Jellyfin Statistics Plugin لجمع بيانات موسّع
  • مخططات لوحة التحكم للاتجاهات بمرور الوقت — أنماط المشاهدة اليومية والأسبوعية والشهرية

كيفية الاستخدام بعد التثبيت

  • افتح http://your-server-ip:3044 وأنشئ حساب مسؤول Jellystat عند الزيارة الأولى
  • أنشئ مفتاح API من قسم Dashboard → API Keys في سيرفر Jellyfin الخاص بك
  • أدخل عنوان سيرفر Jellyfin ومفتاح API في Jellystat لإنشاء الاتصال
  • شغّل مزامنة مكتبة أولية حتى يستورد Jellystat مستخدميك وفهرس الوسائط الحاليين
  • راجع لوحة التحكم للتأكد من تسجيل أحداث التشغيل عند حدوثها
  • تحقق من تبويب المستخدمين دورياً لرؤية نشاط كل مستخدم وتحديد أكثر المشاهدين نشاطاً
  • أعدّ نسخاً احتياطية مجدولة لقاعدة بيانات الإحصائيات حتى لا يُفقَد سجلك المتراكم
  • ضع Jellystat خلف وكيل عكسي مع HTTPS إذا كنت تخطط للتحقق من الإحصائيات عن بُعد

أفضل ممارسات الأمان

  • حافظ على سرية مفتاح API الخاص بـ Jellyfin — أي شخص يملكه يستطيع قراءة كامل بيانات استخدام وتشغيل سيرفرك
  • ضع Jellystat خلف وكيل عكسي مع HTTPS إذا كنت تكشفه خارج شبكتك المحلية
  • استخدم كلمة مرور قوية لحساب مسؤول Jellystat المُنشأ عند الزيارة الأولى
  • أبقِ قاعدة بيانات PostgreSQL على شبكة Docker الداخلية فقط — لا تنشر منفذها خارجياً أبداً
  • قيّد الوصول للمنفذ 3044 عند جدار الحماية واكشفه فقط عبر وكيل عكسي مُصادَق عليه إذا احتجت وصولاً عن بُعد
  • حافظ على تحديث صورة Jellystat Docker لتلقي إصلاحات الأخطاء وتصحيحات الأمان
  • انسخ قاعدة البيانات احتياطياً بانتظام، لأن سجل المشاهدة لا يمكن إعادة بنائه من Jellyfin وحده بعد تقليمه

المنافذ وإعدادات جدار الحماية

يستمع Jellystat على المنفذ 3044 على المضيف، المُعيَّن من المنفذ الداخلي 3000 للحاوية، والذي يخدم لوحة التحكم على الويب. تعمل قاعدة بيانات PostgreSQL 15 كحاوية منفصلة على شبكة Docker الداخلية ولا تُنشَر للمضيف، فلا يصل إليها سوى حاوية Jellystat نفسها. لا تكشف المنفذ 3044 مباشرة للإنترنت أبداً بدون وكيل عكسي يوفر TLS، لأن لوحة التحكم تكشف بيانات استخدام مفصلة عن مستخدميك ومكتبتك. احظر المنفذ 3044 في جدار حماية المضيف لحركة المرور الخارجية واسمح بالوصول فقط عبر وكيل عكسي أو VPN إذا كانت المشاهدة عن بُعد ضرورية.

النسخ الاحتياطي والصيانة

  • انسخ دليل ./db احتياطياً، الذي يحتوي وحدة بيانات PostgreSQL التي تضم كل الإحصائيات المُسجَّلة
  • استخدم ميزة النسخ الاحتياطي والاستعادة المدمجة في Jellystat لتصدير قاعدة بيانات الإحصائيات دورياً
  • انسخ دليل ./backups احتياطياً إذا كان سكريبت التثبيت يخزّن نسخاً مجدولة فيه
  • انسخ ملف docker-compose.yml احتياطياً مع كلمة مرور قاعدة البيانات وسر JWT المُنشأين حتى يمكن إعادة إنشاء المكدس بشكل مطابق
  • خزّن النسخ الاحتياطية بعيداً عن نفس القرص الذي عليه قاعدة البيانات الحية — لا ينبغي أن يمحو فشل قرص واحد سجل مشاهدتك بالكامل
  • اختبر الاستعادة دورياً بتحميل نسخة احتياطية في نسخة PostgreSQL جديدة والتحقق من ظهور الإحصائيات التاريخية بشكل صحيح

الأخطاء الشائعة

  • فقدان أو كشف مفتاح API الخاص بـ Jellyfin، الذي يمنح وصول قراءة لكامل بيانات استخدام سيرفرك
  • كشف المنفذ 3044 مباشرة للإنترنت بدون وكيل عكسي وHTTPS أمامه
  • نسيان نسخ وحدة ./db احتياطياً، بافتراض أن سجل المشاهدة يمكن استيراده لاحقاً من Jellyfin ببساطة
  • عدم إدراك أن Jellyfin يُقلّم سجل نشاطه بمرور الوقت، فتأخير ربط Jellystat يعني فقدان ذلك السجل المبكر نهائياً
  • نشر منفذ حاوية PostgreSQL خارجياً بدلاً من إبقائها على شبكة Docker الداخلية فقط
  • تشغيل المكدس بدون restart: unless-stopped، فيتوقف جمع الإحصائيات بعد إعادة تشغيل السيرفر حتى تُشغَّل يدوياً
  • افتراض أن Jellystat يسجّل السجل بأثر رجعي — فهو يتتبع النشاط فقط من لحظة إنشاء اتصال Jellyfin

استكشاف الأخطاء وإصلاحها

  • لوحة التحكم لا تعرض بيانات بعد ربط Jellyfin — تأكد من صحة مفتاح API وأن عنوان Jellyfin قابل للوصول من حاوية Jellystat
  • لا يمكن الوصول لواجهة الويب — تحقق من أن الحاوية تعمل بـ docker ps وأن المنفذ 3044 غير محظور بجدار الحماية
  • أخطاء اتصال قاعدة البيانات في السجلات — تحقق من أن حاوية PostgreSQL سليمة وأن كلمة مرور قاعدة البيانات المُنشأة تطابق ما يتوقعه Jellystat
  • الإحصائيات تتوقف عن التحديث — تأكد من أن مفتاح API الخاص بـ Jellyfin لم يُلغَ أو يُعاد إنشاؤه من جانب Jellyfin
  • عناصر مكتبة مفقودة من Jellystat — شغّل مزامنة مكتبة يدوية من إعدادات Jellystat لإعادة استيراد الفهرس الحالي
  • فشل النسخ الاحتياطي أو الاستعادة — تحقق من مساحة القرص على الوحدة المستضيفة لـ ./db وتأكد من امتلاك PostgreSQL صلاحيات كتابة لذلك المسار
  • بيانات تاريخية مفقودة لما قبل التثبيت — هذا متوقع، لأن Jellystat يسجّل فقط من لحظة الاتصال وتُقلَّم سجلات Jellyfin نفسها بمرور الوقت

البدائل

Tautulli هو الأداة الأقرب من حيث المقارنة لكنه مبني خصيصاً لـ Plex — إذا كان سيرفر وسائطك Plex بدلاً من Jellyfin، فـ Tautulli هو الخيار الطبيعي ولن يتصل Jellystat به إطلاقاً. لوحة تحكم Jellyfin المدمجة تعرض النشاط الحي لكنها تحتفظ بسجل قليل جداً، ما يجعل Jellystat إضافة ضرورية وليس بديلاً حقيقياً. Streamystats بديل أحدث في نفس المجال يستهدف إحصائيات Jellyfin بمكدس تقني مختلف. يحل Wizarr وJellyseerr مشكلات متجاورة لكن مختلفة — دعوات المستخدمين وطلبات المحتوى على التوالي — ويُشغَّلان عادة جنباً إلى جنب مع Jellystat وليس بدلاً منه، لأن كل واحد يغطي جزءاً مختلفاً من إدارة سيرفر Jellyfin المشترك.

متى لا تستخدمه

Jellystat غير مفيد إذا كان سيرفر وسائطك Plex بدلاً من Jellyfin — فهو يتحدث فقط واجهة Jellyfin، لذا يجب على مستخدمي Plex النظر إلى Tautulli بدلاً منه. إذا كنت الشخص الوحيد الذي يستخدم سيرفراً شخصياً صغيراً ولا يهمك اتجاهات الاستخدام أو المخططات التاريخية، تعرض لوحة تحكم Jellyfin المدمجة النشاط الحالي بالفعل بدون عبء تشغيل قاعدة بيانات ثانية. كما أنه ليس أداة طلب محتوى أو إدارة مستخدمين — لدعوة مستخدمين جدد، اقرنه بـ Wizarr، ولمنح المستخدمين إمكانية طلب أفلام ومسلسلات جديدة، اقرنه بـ Jellyseerr، لأن Jellystat نفسه يقتصر تماماً على الإحصائيات وسجل المشاهدة.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما هو Jellystat؟

لوحة إحصائيات وسجل مشاهدة لـ Jellyfin — إنه عملياً Tautulli لعالم Jellyfin. يسجّل كل تشغيل من سيرفرك ويعرض لك الأكثر مشاهدة، وأكثر مستخدميك نشاطاً، وأوقات ذروة السيرفر، وسجلاً كاملاً قابلاً للبحث، محتفظاً بقاعدة بياناته الخاصة حتى يستمر السجل حتى بعد أن يُقلّم Jellyfin سجلاته الخاصة.

كيف يتصل بـ Jellyfin؟

تُنشئ مفتاح API في لوحة تحكم مسؤول سيرفر Jellyfin الخاص بك، ثم تُدخل عنوان Jellyfin وذلك المفتاح في Jellystat بعد إنشاء حساب المسؤول الخاص به. من تلك اللحظة، يسجّل Jellystat النشاط من سيرفرك. حافظ على سرية مفتاح API، لأنه يمنح وصولاً لبيانات استخدام سيرفرك.

ما المنفذ الذي يستخدمه؟

المنفذ 3044 على المضيف، المُعيَّن من المنفذ الداخلي 3000 للحاوية، مع PostgreSQL على الشبكة الداخلية. تصفّح إلى 3044؛ المنفذ 3000 هو المنفذ داخل الحاوية. إذا وصلت إليه عن بُعد، ضعه خلف وكيل عكسي بـ TLS.

هل يعرض سجلاً من قبل تثبيته؟

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

ما الفرق بينه وبين Wizarr أو Jellyseerr؟

جميعها رفقاء لـ Jellyfin يحلّون مشكلات مختلفة. Jellystat يقتصر تماماً على الإحصائيات والسجل. Wizarr يتولى دعوة المستخدمين الجدد وتوجيههم. Jellyseerr يتيح للمستخدمين طلب محتوى جديد. كثيرون يُشغّلون الثلاثة معاً، كل واحد يغطي جزءاً مختلفاً من إدارة سيرفر وسائط مشترك.