🎬 تثبيت Maintainerr — تنظيف تلقائي لمكتبة الوسائط
انشر Maintainerr على Ubuntu بـ Docker — عرّف قواعد للعثور على الوسائط القديمة وحذفها من مكتبة Plex، بالتكامل مع Overseerr وRadarr وSonarr، على المنفذ 6246.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/maintainerr/maintainerr-ubuntu.sh
chmod +x maintainerr-ubuntu.sh
sudo bash maintainerr-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/maintainerr/maintainerr-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x maintainerr-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم ويُشغّل Maintainerr على المنفذ 6246، مع حفظ الإعدادات والقواعد في حجم ./data.
sudo bash maintainerr-ubuntu.sh
4 ربط Plex وتعريف القواعد
افتح Maintainerr، اربط Plex وOverseerr/Radarr/Sonarr، ثم ابنِ قواعد التنظيف والمجموعات:
http://<your-server-ip>:6246
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 6246 | Web UI (host → container 6246) — connect Plex + *arrs |
| ./data | Rules, collections, and connections |
نظرة عامة
Maintainerr أداة ذاتية الاستضافة ومفتوحة المصدر تُؤتمت تنظيف مكتبة الوسائط لـ Plex وJellyfin وEmby. بدلاً من البحث يدوياً عن العناوين القديمة أو غير المشاهدة، تعرّف قواعد — مثل أفلام لم تُشاهد منذ 90 يوماً، أو مسلسلات أنهاها الجميع في المنزل — ويجمع Maintainerr العناوين المطابقة في مجموعة مراجعة. بعد فترة سماح قابلة للتخصيص، يحذف الملفات من القرص، ويلغي مراقبتها في Radarr/Sonarr حتى لا يُعاد تنزيلها، ويمسح الطلب الأصلي في Overseerr أو Jellyseerr، فتبقى المكتبة مرتبة تماماً كما تريد دون مراقبة يدوية.
لماذا تستخدمه
مكتبات الوسائط المبنية عبر طلبات Overseerr أو Jellyseerr تنمو باستمرار — لا أحد يراجع الطلبات القديمة يدوياً ليتحقق مما إذا كان أي شخص لا يزال يشاهدها، فتمتلئ مساحة التخزين بصمت بعناوين لا يتذكر أحد أنه طلبها. يُغلق Maintainerr هذه الحلقة: إنه 'عكس Seerr'، يحدد تلقائياً المحتوى المطابق لقواعد التنظيف الخاصة بك ويحذفه بعد نافذة مراجعة آمنة. هذا يُبقي سيرفر Plex/Jellyfin/Emby ومكتبات Radarr/Sonarr الأساسية نظيفة دون أن تقضي ساعات في مقارنة تاريخ المشاهدة يدوياً باستخدام القرص.
متى تحتاجه
- مكتبة Plex أو Jellyfin أو Emby لديك تكبر باستمرار لأن الطلبات لا تُراجع بعد تحقيقها
- تُشغّل سيرفر وسائط مشترك أو عام وتريد حذف المحتوى غير المشاهد أو منخفض الطلب تلقائياً لإفساح المجال لطلبات جديدة
- مساحة التخزين لديك منخفضة وتحتاج طريقة قابلة للتكرار ومبنية على قواعد لاستعادة المساحة بدلاً من تدقيق آلاف العناوين يدوياً
- تستخدم بالفعل Overseerr/Jellyseerr للطلبات وRadarr/Sonarr للتنزيل وتريد أتمتة دورة الحياة الكاملة من الطلب حتى التنظيف
- تريد شبكة أمان — مجموعة مراجعة مع فترة سماح — بدلاً من أداة حذف تلقائي فوري
من يحتاجه
- عشاق الاستضافة الذاتية والمختبرات المنزلية الذين يُشغّلون Plex أو Jellyfin أو Emby وسئموا تقليم المكتبات القديمة يدوياً
- مديرو سيرفرات الوسائط المشتركة أو العائلية حيث تتراكم عشرات الطلبات ولا أحد يعود لتنظيفها
- المستخدمون الذين يُشغّلون بالفعل مجموعة *arr (Radarr، Sonarr) وأداة طلبات (Overseerr، Jellyseerr) ويريدون قطعة التنظيف المفقودة
- أي شخص على VPS أو NAS محدود المساحة يحتاج استعادة مساحة القرص تلقائياً وبشكل يمكن التنبؤ به
- أصحاب السيرفرات الذين يريدون قرارات تنظيف مبنية على قواعد واضحة وقابلة للتدقيق بدلاً من الحذف اليدوي العشوائي
حالات الاستخدام الشائعة
- جمع وحذف الأفلام غير المشاهدة خلال عدد أيام محدد تلقائياً
- حذف المسلسلات بمجرد أن ينهيها كل فرد في المنزل
- تحرير مساحة التخزين قبل طلبات محتوى جديدة دون مقارنة تاريخ المشاهدة يدوياً
- إلغاء مراقبة العناوين المحذوفة في Radarr/Sonarr حتى لا يُعاد تنزيلها بصمت لاحقاً
- مسح طلب Overseerr/Jellyseerr الأصلي عند حذف وسائطه، مما يُبقي سجل الطلبات دقيقاً
- تشغيل تدقيقات مكتبة مجدولة ومبنية على قواعد بدلاً من جلسات تنظيف يدوية لمرة واحدة
الميزات الرئيسية
- محرك مبني على قواعد — اجمع معايير مثل حالة المشاهدة والعمر وتاريخ الإضافة وحجم الملف والتقييم لتحديد ما يجب تنظيفه بالضبط
- سير عمل مراجعة قائم على المجموعات — تُجمع الوسائط المطابقة أولاً في مجموعة Plex/Jellyfin/Emby، مع فترة سماح قابلة للتخصيص قبل حذف أي شيء
- تجاوز يدوي — أضف أو استبعد عناصر فردية من مجموعة مطابقة حتى لو طابقت قاعدة تقنياً
- تكامل عميق مع Radarr وSonarr — تُحذف الملفات وتُعطّل المراقبة حتى لا يُعاد جلب المحتوى تلقائياً
- تكامل مع Overseerr وJellyseerr — يمسح سجل الطلب الأصلي عند حذف الوسائط
- تكامل مع Tautulli لقواعد مبنية على تاريخ مشاهدة Plex
- يدعم Plex وJellyfin وEmby كسيرفر وسائط أساسي، مع إمكانية التبديل وترحيل القواعد بينها
- نشر Docker بحاوية واحدة بسيطة مع تخزين كل الحالة في دليل بيانات واحد
كيفية الاستخدام بعد التثبيت
- افتح واجهة الويب على http://your-server-ip:6246 وأكمل إعداد التشغيل الأول
- اربط سيرفر الوسائط لديك (Plex أو Jellyfin أو Emby) بتوفير رابطه ورمز API/تسجيل دخول Plex
- أضف نسخ Radarr و/أو Sonarr حتى يستطيع Maintainerr حذف الملفات ومنع إعادة تنزيلها
- اختيارياً، اربط Overseerr أو Jellyseerr حتى تُمسح الطلبات المحققة تلقائياً عند حذف وسائطها
- أنشئ أول قاعدة لك — مثلاً أفلام غير مشاهدة منذ 90+ يوماً — وخصصها لمجموعة
- دع القاعدة تعمل في وضع المجموعة فقط أولاً وراجع العناوين المطابقة يدوياً قبل تفعيل الحذف التلقائي
- اضبط فترة السماح (الوقت الذي تبقى فيه العناصر المطابقة في المجموعة قبل الحذف) على ما تشعر أنه آمن للمراجعة
- راجع بشكل دوري أو اعتمد على الجدولة لإبقاء المكتبة نظيفة مستقبلاً
أفضل ممارسات الأمان
- يحمل Maintainerr رموز Plex/Jellyfin/Emby ومفاتيح API لـ*arr يمكنها حذف ملفات وسائط حقيقية — عامل دليل بياناته وواجهة الويب كبيانات حساسة
- لا تكشف المنفذ 6246 مباشرة للإنترنت أبداً؛ أبقه على شبكتك الداخلية أو خلف وكيل عكسي مع مصادقة
- استخدم HTTPS عبر وكيل عكسي مثل Nginx Proxy Manager لأي وصول خارج شبكتك المحلية
- اختبر دائماً القواعد الجديدة في وضع المراجعة فقط مع فترة سماح قبل تفعيل الحذف التلقائي — قاعدة مُعدة بشكل خاطئ قد تحذف أكثر مما تقصد
- قيّد الوصول لواجهة الويب على المسؤولين الموثوقين فقط، لأن أي شخص لديه وصول يستطيع تشغيل عمليات حذف ملفات لا رجعة فيها
- حافظ على تحديث صورة Docker لتلقي إصلاحات لمنطق مطابقة القواعد وواجهات التكامل
المنافذ وإعدادات جدار الحماية
يستمع Maintainerr على منفذ واحد، 6246، مُعيّن واحد لواحد من المضيف إلى الحاوية (قابل للتخصيص عبر متغير البيئة UI_PORT). عادةً يعمل على نفس شبكة Docker أو الشبكة المحلية مثل Plex/Jellyfin/Emby ومجموعة *arr حتى يستطيع الوصول لواجهات برمجتها. بما أنه يحمل رموزاً ومفاتيح API ويمكنه حذف ملفات، يجب ألا يُكشف المنفذ 6246 مباشرة للإنترنت العام أبداً. أبقه محمياً بجدار ناري على شبكتك الداخلية باستخدام ufw أو ما شابه، وإذا احتجت وصولاً عن بُعد، ضعه خلف وكيل عكسي مع TLS ومصادقة بدلاً من فتح المنفذ مباشرة.
النسخ الاحتياطي والصيانة
- انسخ دليل ./data (أو /opt/data داخل الحاوية) احتياطياً الذي يحمل كل القواعد والمجموعات وإعدادات الاتصال
- صدّر أو وثّق تعريفات قواعدك بشكل منفصل إن أمكن، لأن إعادة بناء قواعد معقدة من الذاكرة بعد فقدان البيانات يستغرق وقتاً
- انسخ ملف docker-compose.yml احتياطياً حتى يمكن إعادة إنشاء الحاوية بنفس الإعدادات على مضيف جديد
- بما أن Maintainerr يخزن فقط الإعدادات وليس الوسائط نفسها، النسخ الاحتياطية صغيرة وسريعة الأخذ بانتظام
- اختبر الاستعادة على نسخة احتياطية دورياً للتأكد من أن قواعدك واتصالاتك تعود تماماً كما كانت مُعدة
الأخطاء الشائعة
- تفعيل الحذف التلقائي لقاعدة جديدة قبل اختبارها في وضع المراجعة/المجموعة فقط — قاعدة واسعة جداً قد تحذف أكثر بكثير مما تقصد
- ضبط فترة السماح قصيرة جداً، دون وقت حقيقي لالتقاط خطأ قبل حذف الملفات نهائياً
- كشف المنفذ 6246 للإنترنت دون وكيل عكسي أو مصادقة، نظراً للقوة التدميرية للأداة
- نسيان ربط Radarr/Sonarr، ما يسبب إعادة تنزيل الوسائط المحذوفة بصمت في الفحص التالي
- عدم ربط Overseerr/Jellyseerr، ما يترك سجلات طلبات قديمة بعد حذف وسائطها بالفعل
- كتابة قواعد مبنية على 'تاريخ الإضافة' فقط دون مراعاة حالة المشاهدة، ما يحذف مفضلات شوهدت مؤخراً عن طريق الخطأ
استكشاف الأخطاء وإصلاحها
- فشل الاتصال بسيرفر الوسائط — تحقق أن رابط Plex/Jellyfin/Emby متاح من داخل حاوية Maintainerr وأن الرمز/مفتاح API صالح
- القواعد تطابق عناصر غير متوقعة — راجع معايير كل قاعدة بعناية؛ اجمع عدة شروط (حالة المشاهدة + العمر) لتضييق النتائج قبل تفعيل الحذف
- تكامل Radarr/Sonarr لا يحذف الملفات — تأكد أن مفتاح API والرابط صحيحان وأن Maintainerr يملك وصولاً شبكياً لتلك الخدمات
- طلبات Overseerr/Jellyseerr لا تُمسح — تحقق أن التكامل متصل وأن الوسائط المحذوفة تطابق فعلياً سجل طلب موجود
- واجهة الويب غير متاحة — تأكد أن الحاوية تعمل، وأن المنفذ 6246 غير محظور بالجدار الناري، وأنه لا توجد خدمة أخرى مرتبطة بنفس المنفذ
- المجموعة لا تظهر في Plex/Jellyfin — شغّل تحديث مكتبة على سيرفر الوسائط وتأكد أن Maintainerr يملك صلاحية إنشاء مجموعات
البدائل
Janitorr وCleanarr مشروعان مجتمعيان أحدث بهدف مشابه لتنظيف مكتبات Radarr/Sonarr/Jellyfin تلقائياً، لكن كليهما لديه قاعدة مستخدمين أصغر ومحرك قواعد أقل نضجاً من Maintainerr. Tautulli يستطيع التقرير عن تاريخ المشاهدة وتشغيل سكريبتات عند عدم النشاط، لكنه ليس مصمماً خصيصاً لسير عمل الجمع-المراجعة-الحذف ويحتاج سكريبتات مخصصة لحذف المحتوى فعلياً. التدقيق اليدوي للمكتبات باستخدام خيارات إلغاء المراقبة والحذف المدمجة في Sonarr/Radarr يعمل لكنه لا يتوسع وليس له شبكة أمان مراجعة/فترة سماح. لأداة ناضجة ونشطة الصيانة مصممة خصيصاً حول سير عمل تنظيف آمن ومبني على قواعد مع مراجعة قبل الحذف عبر Plex وJellyfin وEmby، يبقى Maintainerr الخيار الأبرز بوضوح.
متى لا تستخدمه
Maintainerr ليس سيرفر وسائط أو أداة طلبات — يدير فقط الحذف، لذا ما زلت تحتاج Plex/Jellyfin/Emby للتشغيل وOverseerr/Jellyseerr للطلبات. إذا كانت مكتبتك صغيرة بما يكفي للتقليم يدوياً في دقائق شهرياً، فقد لا تستحق القطعة الإضافية هذا الجهد. إذا كنت غير مرتاح لفكرة منح أي أداة صلاحية حذف ملفات وسائط تلقائياً، حتى مع فترة سماح، فقد تفضل إبقاء التنظيف يدوياً بالكامل. وإذا كنت لا تُشغّل أي مجموعة *arr (Radarr/Sonarr) بجانب سيرفر الوسائط، فبعض أهم تكاملات Maintainerr — مثل إلغاء المراقبة لمنع إعادة التنزيل الصامت — لن تنطبق عليك.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ماذا يفعل Maintainerr؟
يُؤتمت قرار ما يجب حذفه من مكتبة Plex أو Jellyfin أو Emby. تكتب قواعد مثل 'أفلام لم تُشاهد منذ 90 يوماً'، ويجمع Maintainerr الوسائط المطابقة في مجموعة مراجعة بدلاً من حذفها فوراً.
هل سيحذف وسائطي دون سؤالي؟
فقط إذا أعددته لتخطي المراجعة. سير العمل الآمن هو تشغيل القواعد في وضع المجموعة فقط أولاً، بحيث تظهر الوسائط المطابقة في مجموعة دون حذف أي شيء، والتأكد من صحة الاختيار قبل تفعيل الحذف التلقائي بعد فترة السماح.
أي منفذ يستخدمه Maintainerr؟
منفذ المضيف 6246، مُعيّن واحد لواحد لمنفذ الحاوية 6246 (قابل للتخصيص عبر متغير البيئة UI_PORT). عادةً يعمل على نفس شبكة سيرفر الوسائط ومجموعة *arr لديك، وبما أنه يحمل رموزاً ويستطيع حذف ملفات، أبقه مقيداً بجدار ناري وخلف وكيل عكسي بـTLS لأي وصول عن بُعد.
بماذا يحتاج Maintainerr للاتصال؟
سيرفر وسائط — Plex أو Jellyfin أو Emby — مطلوب، لأنه المكتبة التي يديرها. يتكامل أيضاً مع Radarr وSonarr حتى عندما يحذف شيئاً، تُنظف الملفات المقابلة والمراقبة أيضاً، ومع Overseerr أو Jellyseerr حتى تُمسح الطلبات المحققة تلقائياً.
كيف يتناسب Maintainerr مع Overseerr وTautulli؟
يغطون أجزاء مختلفة من مكدس الوسائط. يتعامل Overseerr أو Jellyseerr مع طلبات المحتوى الجديد، ويقرر Tautulli عن نشاط المشاهدة، ويتولى Maintainerr التنظيف — حذف الوسائط القديمة أو غير المشاهدة تلقائياً بمجرد مطابقتها لقواعدك.