📊 تثبيت Tautulli — مراقبة وإحصائيات سيرفر Plex وبث الوسائط على Docker

نشر منصة Tautulli على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة عالمياً لمراقبة نشاط سيرفر Plex Media Server، وتتبع جلسات المشاهدة الحية، وإرسال تنبيهات ديسكورد وتيليجرام على المنفذ 8182.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Tautulli على المنفذ 8182 مع مجلد التخزين الدائم والربط مع سيرفر Plex وتنبيهات القنوات جاهزاً.
عرض على GitHub

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

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

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

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

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

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

chmod +x tautulli-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم للإعدادات (`./config`) وتشغيل حاوية Tautulli الرسمية على المنفذ 8182 (المحول من 8181 الداخلي).

sudo bash tautulli-ubuntu.sh

4 الربط مع Plex وضبط التنبيهات

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8182. أكمل معالج الإعداد بتسجيل الدخول بحساب Plex.tv، واربط سيرفرك، واضبط إشعارات ديسكورد أو تيليجرام لمتابعة نشاط المشاهدة.

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

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

المنفذالغرض
8182Web Dashboard (host → container 8181)

نظرة عامة

تعد Tautulli (المعروفة سابقاً باسم PlexPy) المنصة مفتوحة المصدر الرائدة لمراقبة وتحليل وإرسال إشعارات خوادم Plex Media Server. تعمل المنصة عبر المنفذ 8182 (المحول من 8181 الداخلي)، وتتصل بسيرفر Plex لمراقبة جلسات البث المباشرة في الوقت الفعلي. وتعرض تفاصيل البث الدقيقة (التشغيل المباشر Direct Play مقابل إعادة الترميز Transcoding، ونوع التشفير، واستهلاك السرعة، وعناوين IP للمستخدمين)، وتسجل تاريخ المشاهدات التفصيلي لكل مستخدم، مع إرسال إشعارات فورية عبر Discord وTelegram وSlack.

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

توفر لوحة تحكم Plex الأساسية معلومات لحظية محدودة وتفتقر لسجل المشاهدات التاريخي، وتفاصيل أداء إعادة الترميز، ونظام الإشعارات المخصص. يمنح Tautulli مديري خوادم Plex رؤية استثنائية: معرفة من يشاهد المحتوى، وتحديد الأجهزة التي تسبب ضغطاً على المعالج بإعادة الترميز غير الضرورية، وإرسال تنبيهات تلقائية في Discord فور إضافة أفلام جديدة، ومراقبة استهلاك سرعة الإنترنت على مدار الشهور.

متى تحتاجه

  • تمتلك خادم Plex Media Server وتريد مراقبة لحظية وإحصائيات دقيقة لتاريخ المشاهدات
  • تريد معرفة من يشاهد المحتوى، والأجهزة المستخدمة، وما إذا كان الفيديو يعمل مباشرة أو يعاد ترميزه
  • تريد إرسال تنبيهات فورية عبر Discord أو Telegram فور إضافة أفلام ومسلسلات جديدة للمكتبة
  • تحتاج إلى رسوم بيانية لاستهلاك سرعة الرفع وحجم البث المتزامن لتحسين أداء السيرفر
  • تريد إيقاف جلسات البث المتوقفة مؤقتاً أو غير المصرح بها تلقائياً عبر سكريبتات مخصصة

من يحتاجه

  • مديرو خوادم Plex Media Server لمتابعة مكتبات العائلة والأصدقاء ومراقبة استهلاك السيرفر
  • أصحاب السيرفرات المنزلية لتحسين كفاءة كروت الشاشة في معالجة الفيديو (Hardware Transcoding)
  • عشاق الميديا للحصول على إحصائيات بصرية حول أكثر الأفلام والمسلسلات والموسيقى مشاهدة
  • مديرو الشبكات لمتابعة استهلاك سرعة الرفع (Upload Bandwidth) في أوقات الذروة المسائية
  • المطورون لربط أحداث المشاهدة في سيرفر Plex مع أنظمة الأتمتة في Home Assistant أو مجتمعات Discord

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

  • مراقبة 5 جلسات بث متزامنة والتحقق من سبب إعادة ترميز فيديو بدقة 4K إلى 1080p
  • إرسال إعلان تلقائي لقناة Discord فور اكتمال تنزيل فيلم جديد في Plex عبر Radarr
  • استعراض سجل المشاهدة لمستخدم معين لتشخيص سبب تقطيع البث على شاشة تلفاز معينة
  • استقبال إشعار فوري على الهاتف عبر Telegram فور بدء بث من عنوان IP غير معروف
  • تصدير تقرير شهري بصيغة CSV يوضح إجمالي ساعات البث لكافة أفراد العائلة

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

  • مراقبة البث المباشر على المنفذ 8182: تتبع استهلاك السرعة، والتقدم الزمني، وحالة Direct Play/Transcode، وIP المشاهد
  • سجل تحليلات المشاهدة التاريخي: تقارير ورسوم بيانية شاملة لكافة المشاهدات السابقة حسب المستخدم والمكتبة والمنصة
  • محرك تنبيهات متعدد القنوات: تكامل مباشر مع Discord وTelegram وSlack وPushover والبريد الإلكتروني والـ Webhooks
  • نشرات بريدية للمحتوى الجديد: توليد رسائل بريدية دورية تستعرض أحدث الأفلام والحلقات المضافة للمكتبة
  • تشغيل سكريبتات مخصصة: تنفيذ أوامر برمجية عند بدء البث أو إيقافه مؤقتاً أو انتهائه
  • تشخيص مواصفات الميديا والترميز: فحص نوع الحاوية والبت ريت وقنوات الصوت ونسبة استخدام كارت الشاشة
  • تطبيق هاتف مرافق: مراقبة سيرفر Plex من الهواتف عبر تطبيق Tautulli Remote الرسمي
  • معمارية Docker Compose تجمع Tautulli مع ربط مجلد `./config` لقاعدة بيانات SQLite وسجلات المشاهدة

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8182 لبدء معالج إعداد Tautulli
  • سجل الدخول بحساب Plex لاكتشاف وربط سيرفر Plex Media Server تلقائياً
  • تحقق من الاتصال بـ Plex في Settings ← Plex Media Server وتأكد من كتابة IP السيرفر والمنفذ 32400
  • انتقل إلى Settings ← Notification Agents لربط خطافات Discord Webhook أو بوت تيليجرام
  • عيّن كلمة مرور لحماية لوحة التحكم من Settings ← Web Interface
  • ضع Tautulli خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
  • أعد سكريبت نسخ احتياطي دوري لمجلد الإعدادات وقاعدة البيانات `./config`

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

  • تنبيه أمني حاسم: فعل دائماً المصادقة بكلمة مرور من Settings ← Web Interface؛ فاللوحة تعمل بدون كلمة مرور افتراضياً
  • حافظ على سرية مفتاح Plex Token الخاص بك ولا تشارك ملفات الإعدادات مع العامة
  • استخدم تشفير HTTPS دائماً عبر وكيل عكسي للوصول للوحة التحكم بأمان من خارج المنزل
  • لا تكشف المنفذ 8182 للإنترنت العام مباشرة دون حماية الوكيل العكسي
  • احمِ مجلد الإعدادات `./config` الذي يحتوي على قاعدة البيانات ومفاتيح الـ API بصلاحيات نظام مناسبة بالسيرفر
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات التوافقية مع Plex

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

يقدم Tautulli واجهة الويب والواجهة البرمجية API عبر منفذ TCP 8182 (المحول من 8181 الداخلي). يجب السماح بالمنفذ 8182 في جدار الحماية للشبكة المحلية (`ufw allow 8182/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 8182، مع إبقاء المنفذ 8182 مغلقاً خارجياً.

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

  • انسخ مجلد `./config` احتياطياً، والذي يحتوي على ملف `tautulli.db` (سجل المشاهدات التاريخية، وإحصائيات المستخدمين، والإشعارات)
  • احتفظ بنسخة من ملف `config.ini` الذي يحتوي على توكنات الاتصال بـ Plex وإعدادات التنبيهات
  • احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على المتغيرات ومسارات التخزين
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بربط مجلد الإعدادات بحاوية تجريبية للتأكد من استرجاع كافة الإحصائيات التاريخية بنجاح

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

  • ترك المصادقة معطلة في Settings ← Web Interface مما يتيح لأي شخص بالشبكة الاطلاع على سجل المشاهدات والتوكنات
  • إدخال عنوان IP خاطئ لسيرفر Plex مما يسبب ظهور خطأ 'Unable to connect to Plex Media Server'
  • عدم ربط مجلد التخزين الدائم `./config`، مما يسبب فقدان سجلات المشاهدة عند تحديث الحاوية
  • التشغيل في بيئة الإنتاج عبر بروتوكول HTTP غير المشفر عند الدخول للوحة عن بُعد
  • إرسال إشعارات كثيفة جداً بدون تحديد فلاتر مما يسبب إزعاج قنوات التواصل

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

  • تعذر الاتصال بـ Plex — تأكد من صحة IP السيرفر بالشبكة المحلية (لا تستخدم `localhost`) وصلاحية الـ Plex Token
  • التنبيهات لا تصل — اختبر رابط الـ Webhook في Settings ← Notification Agents ← Test Notification
  • ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs tautulli -f`
  • الجلسات الحية لا تظهر — تأكد من عمل اتصال WebSocket مع Plex في سجلات Tautulli
  • خطأ في صلاحيات حفظ قاعدة البيانات — اضبط ملكية المجلد بالأمر: `chown -R 1000:1000 ./config`

البدائل

تطبيق Plex Dash الرسمي من Plex للهواتف. منصة Jellystat المخصصة لسيرفرات Jellyfin. منصة Overseerr لإدارة الطلبات. لوحات Grafana وVarken لمراقبة البث. خدمة Trakt.tv السحابية لتتبع المشاهدات.

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

تجنب استخدام Tautulli إذا كنت تستخدم خوادم Jellyfin أو Emby بدلاً من Plex (حيث صُممت منصة Jellystat لسيرفرات Jellyfin). وإذا كنت تبحث فقط عن تطبيق هاتف بسيط لمعرفة البث النشط حالياً دون الحاجة لسجلات تاريخية أو تنبيهات ديسكورد، فإن تطبيق Plex Dash الرسمي كافٍ.

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

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

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

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

ما هي منصة Tautulli وكيف تتكامل مع Plex؟

تعد Tautulli منصة مراقبة وإحصائيات مخصصة لسيرفرات Plex Media Server. تتصل بـ Plex عبر واجهات الـ API ومقابس WebSockets لتتبع جلسات البث الحية، وتسجيل تاريخ المشاهدة لكل مستخدم، وإرسال تنبيهات تلقائية عبر مختلف القنوات.

هل يتتبع Tautulli عمليات إعادة ترميز الفيديو (Transcoding)؟

نعم! يوفر Tautulli بيانات لحظية دقيقة توضح ما إذا كان الصوت والصورة يعملان بوضع التشغيل المباشر (Direct Play) أو يعاد ترميزهما (Transcode)، مع توضيح سبب الترميز، وتغيير الدقة، واستخدام كروت الشاشة لتسريع المعالجة العتادية.

هل يستطيع Tautulli إرسال تنبيهات لـ Discord أو تيليجرام؟

نعم! يدعم Tautulli عشرات وكلاء الإشعارات بما في ذلك Discord وTelegram وSlack وPushover والبريد الإلكتروني والـ Webhooks عند بدء أو انتهاء البث وفور إضافة وسائط جديدة للمكتبة.

هل يوجد تطبيق للهواتف الذكية لـ Tautulli؟

نعم! يتوفر تطبيق رسمي باسم 'Tautulli Remote' على أجهزة iOS (App Store) وأندرويد (Google Play)، يتيح لك مراقبة البث النشط واستقبال الإشعارات الفورية على هاتفك.

كم يستهلك Tautulli من الذاكرة العشوائية (RAM)؟

تم تطوير Tautulli بلغة Python وهو خفيف جداً، حيث يستهلك عادة ما بين 50 إلى 120 ميجابايت فقط من الذاكرة العشوائية داخل Docker.