🎬 تثبيت Tdarr — إعادة ترميز الفيديو الموزعة وضغط مكتبات الوسائط على Docker

نشر منصة Tdarr على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة عالمياً لأتمتة إعادة ترميز وتعديل الفيديو وضغط مكتبات الأفلام عبر كروت الشاشة والمعالجة الموزعة على المنفذ 8265.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر خادم Tdarr وعقدة المعالجة على المنفذين 8265 و8266 مع تسريع كروت الشاشة NVENC وQuickSync جاهزاً.
عرض على GitHub

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

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

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

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

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

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

chmod +x tdarr-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلدات الإعدادات (`./server` و`./configs`) ومجلد الميديا (`./media`) وتمرير كروت الشاشة وتشغيل خادم Tdarr وعقدة المعالجة على المنفذين 8265 و8266.

sudo bash tdarr-ubuntu.sh

4 تهيئة الإضافات وبدء ضغط الفيديو

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8265. أضف مكتبات الميديا الخاصة بك، واختر مسار الإضافات (مثل تحويل كافة الفيديوهات لصيغة H.265 وحذف مسارات الصوت غير المرغوبة)، واترك البرنامج يضغط مكتبتك آلياً.

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

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

المنفذالغرض
8265Web UI (host → container 8265) — no auth
8266Server for worker nodes (host → container 8266)
./mediaYour media (read/write) — Tdarr can modify and delete files

نظرة عامة

تعد Tdarr منصة أتمتة وإعادة ترميز وضغط مكتبات الفيديو الموزعة مفتوحة المصدر الأكثر قوة في العالم. تعمل المنصة عبر المنفذ 8265 (لوحة التحكم) والمنفذ 8266 (خادم عقد المعالجة)، لتقوم بفحص مكتبات الأفلام والمسلسلات وتحويلها تلقائياً بالخلفية من الصيغ القديمة غير الفعالة (مثل H.264 وMPEG-2) إلى الصيغ الحديثة الموفرة للمساحة (مثل H.265/HEVC وAV1)، وتوحيد الحاويات بصيغة MKV، وإزالة مسارات الصوت والترجمة بلغات أجنبية غير مرغوبة، وتوزيع عمليات المعالجة الثقيلة على عدة أجهزة بالشبكة باستخدام تسريع كروت الشاشة (Intel QuickSync وNvidia NVENC).

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

تستهلك ملفات الفيديو غير المضغوطة مساحات هائلة من وحدات التخزين بالسيرفر والـ NAS، مما يجبر خوادم Plex وJellyfin على إعادة الترميز اللحظي الشاق أثناء البث. يؤتمت Tdarr هذه العملية بالكامل: وفّر ما بين 40% إلى 60% من سعة القرص الصلب (توفير عدة تيرابايت)، وتخلص من بطء وضغط المعالج أثناء المشاهدة، وتأكد من تشغيل كافة أفلامك بوضع Direct Play السلس على كافة الشاشات.

متى تحتاجه

  • تمتلك مكتبة فيديو ضخمة وتريد توفير 40% إلى 60% من مساحة التخزين عبر التحويل لصيغة H.265 (HEVC) أو AV1
  • تريد التخلص من بطء وضغط معالجات خوادم Plex وJellyfin بضغط وتجهيز كافة الفيديوهات مسبقاً
  • تريد توزيع مهام ضغط الفيديو الشاقة على عدة حواسيب وسيرفرات متصلة بالشبكة المحلية في آن واحد
  • تريد تنظيف حاويات الفيديو بحذف مسارات الصوت والترجمات بلغات غير مرغوبة لتقليل حجم الملفات
  • تمتلك كروت شاشة Nvidia (NVENC) أو معالجات Intel (QuickSync) وتريد استغلالها في المعالجة العتادية السريعة 24/7

من يحتاجه

  • أصحاب السيرفرات المنزلية وأجهزة التخزين الشبكي (NAS) لتوفير تيرابايت من المساحة باهظة الثمن دون التأثير على جودة الصورة
  • مديرو خوادم Plex وJellyfin لتوحيد صيغ الفيديو وضمان تشغيلها المباشر بدون تقطيع على كافة الشاشات
  • صناع المحتوى والمحررون لضغط وأرشفة لقطات الكاميرات الضخمة بصيغ قياسية خفيفة
  • مديرو الشبكات لإدارة وتوزيع مهام رندر وضغط الفيديو على مصفوفات حواسيب موزعة
  • عشاق الميديا لتوحيد مستويات الصوت واستخراج ملفات الترجمة `.srt` النظيفة آلياً

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

  • فحص مكتبة أفلام بحجم 20 تيرابايت وتحويل ملفات H.264 إلى H.265 واستعادة 8 تيرابايت من المساحة الفارغة
  • توحيد حاويات كافة الأفلام إلى صيغة MKV وإزالة أكثر من 10 مسارات صوتية بلغات أجنبية غير مستخدمة
  • استخدام حاسوب الألعاب الشخصي كعقدة معالجة ثانوية مساعدة لسيرفر المنزل بالاستفادة من كارت Nvidia
  • موازنة وتوحيد مستويات علو الصوت للمسلسلات القديمة لمنع الارتفاع المزعج للصوت أثناء المشاهدة
  • استخراج الترجمات المدمجة تلقائياً إلى ملفات ترجمة نصية خارجية متوافقة مع كافة الهواتف

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

  • معمارية معالجة موزعة: تشغيل الخادم على Ubuntu وربط عدد غير محدود من عقد المعالجة (Nodes) بالشبكة
  • تسريع عتادي متطور: دعم أصلي لكروت Nvidia NVENC، ومعالجات Intel QuickSync (VAAPI)، وكروت AMD وApple Silicon
  • منظومة إضافات مجتمعية ضخمة: مئات الإضافات الجاهزة لضغط الفيديو وفلترة الصوت وإصلاح الحاويات
  • محرر مسارات بصري (Flows): تصميم مسارات معالجة مخصصة بالسحب والإفلات مع شروط وتفرعات منطقية
  • إحصائيات دقيقة للمساحة الموفرة على المنفذ 8265: عرض دقيق لحجم الجيجابايت والتيرابايت الموفرة في كل مكتبة
  • جدولة مواعيد المعالجة: تحديد أوقات عمل عقد المعالجة أثناء الليل وفي أوقات الخمول فقط
  • إدارة دقيقة لمسارات الصوت والترجمة: الاحتفاظ باللغات المفضلة وتعيين المسارات الصوتية الافتراضية
  • معمارية Docker Compose تجمع الخادم والعقدة ومجلدات الإعدادات والميديا على المنفذين 8265 و8266

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8265 لعرض لوحة تحكم Tdarr
  • انتقل إلى تبويب 'Libraries'، واضغط '+ Add Library'، وحدد مسار مجلد الميديا المربوط (`/media`)
  • اختر حزمة الإضافات المطلوبة (مثل إضافات المجتمع لتحويل H.265 بـ NVENC أو QuickSync)
  • انتقل إلى تبويب 'Nodes' وفعل عمال المعالجة بكارت الشاشة (GPU Workers) أو المعالج (CPU Workers)
  • اضغط 'Scan (Find new)' على مكتبتك لبدء فهرسة الفيديوهات ومتابعة طابور المعالجة المباشر
  • ضع Tdarr خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع حماية الواجهة بكلمة مرور
  • أعد سكريبت نسخ احتياطي دوري لمجلدي الإعدادات `./configs` و`./server`

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

  • تنبيه أمني حاسم: لا يحتوي Tdarr على مصادقة مدمجة؛ احرص دائماً على حماية المنفذ 8265 بكلمة مرور عبر Nginx Basic Auth
  • استخدم تشفير HTTPS دائماً للوصول للوحة التحكم عن بُعد عبر وكيل عكسي
  • اقصر الاتصال بمنفذ خادم العقد 8266 على نطاق الشبكة المحلية الموثوقة فقط
  • اختبر دائماً إضافات الضغط الجديدة على مجلد تجريبي صغير أولاً قبل تطبيقها على مكتبتك الرئيسية
  • احمِ مجلدات الإعدادات وقاعدة البيانات بصلاحيات نظام مناسبة بالسيرفر
  • حدّث صورة الحاوية دورياً للحصول على أحدث إصدارات مكتبات FFmpeg وHandBrake

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

يقدم Tdarr لوحة الويب عبر منفذ TCP 8265 وخادم عقد المعالجة عبر منفذ TCP 8266. اسمح بالمنفذ 8265 للشبكة المحلية (`ufw allow 8265/tcp`). واسمح بالمنفذ 8266 للأجهزة بالشبكة المحلية (`ufw allow from 192.168.1.0/24 to any port 8266 proto tcp`) لتتمكن عقد المعالجة من الاتصال. وأبقِ المنفذين مغلقين خارجياً.

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

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

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

  • تطبيق إعدادات ضغط شديدة على فيديوهات ذات جودة منخفضة أصلاً مما يتسبب في تشوه الصورة
  • نسيان تمرير كروت الشاشة (`/dev/dri` لـ Intel أو معرّفات Nvidia) في Compose مما يجبر النظام على المعالجة بالمعالج البطيء
  • عدم ربط مجلدي التخزين الدائم، مما يجبر البرنامج على إعادة فحص وضغط كافة الملفات عند تحديث الحاوية
  • عدم توفير مساحة كافية في مجلد الكاش المؤقت (حيث يتطلب ضغط فيلم 4K مساحة كاش تصل لـ 50 جيجابايت)
  • كشف المنفذ 8265 للإنترنت العام مباشرة بدون كلمة مرور

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

  • فشل المعالجة بكارت الشاشة — راجع تمرير كارت الشاشة في Compose وتأكد من تعريفات الدرايفر بالسيرفر
  • فشل التحويل وظهور 'No space left on device' — وفر مساحة كافية لا تقل عن 100 جيجابايت في مجلد الكاش المؤقت
  • ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs tdarr-server -f`
  • عقد المعالجة الخارجية لا تتصل — تأكد من فتح المنفذ 8266 بالسيرفر وصحة IP السيرفر بإعدادات العقدة
  • خطأ في استبدال الملفات الأصلية — تأكد من تطابق `PUID` و`PGID` مع مالك ملفات الميديا بالسيرفر

البدائل

برنامج HandBrake المكتبي الكلاسيكي. أداة Unmanic لضغط الميديا التلقائي. منصة FileFlows لمعالجة الوسائط. أوامر FFmpeg المباشرة عبر الطرفية. أداة Plex Optimizer المدمجة في Plex.

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

تجنب استخدام Tdarr إذا كنت تمتلك عدداً قليلاً من الفيديوهات وتريد تحويل فيلم واحد يدوياً لمرة واحدة (حيث يعد برنامج HandBrake المكتبي أسهل بكثير). وإذا كنت تبحث فقط عن تحويل وضغط الملفات الصوتية والموسيقية، فإن محولات الصوت المخصصة أبسط.

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

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

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

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

ما هو Tdarr وكيف يوفر مساحة على القرص الصلب؟

يعد Tdarr نظاماً مؤتمتاً لضغط وإعادة ترميز الفيديو، حيث يفحص مكتبات الوسائط بالخلفية ويحول الملفات من الصيغ القديمة (H.264) إلى الصيغ الحديثة الموفرة للمساحة (H.265/HEVC أو AV1)، مما يقلل أحجام الملفات بنسبة 40% إلى 60% دون فقدان ملحوظ في الجودة.

هل يدعم Tdarr تسريع المعالجة بكروت الشاشة؟

نعم! يدعم Tdarr أصلياً كروت Nvidia NVENC، ومعالجات Intel QuickSync، وكروت AMD، ومعالجات Apple Silicon، مما يتيح ضغط الفيديوهات بسرعات فائقة تتجاوز 200 إطار في الثانية.

هل يمكن استخدام عدة أجهزة كمبيوتر لضغط مكتبة واحدة معاً؟

نعم! يعتمد Tdarr على معمارية موزعة تتيح لك تشغيل خادم Tdarr Server على سيرفر Ubuntu وربط عقد معالجة Tdarr Nodes على حواسيب أخرى بالشبكة (Windows أو Mac أو Linux) لتقاسم مهام الضغط في نفس اللحظة.

هل يستبدل Tdarr الملفات الأصلية تلقائياً؟

افتراضياً، يقوم Tdarr بمعالجة الفيديو في مجلد كاش مؤقت، ثم يتحقق من سلامة الملف الجديد وصغر حجمه مقارنة بالأصل، ثم يستبدل الملف الأصلي بنظافة وأمان.

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

يستهلك خادم Tdarr Server ما بين 150 إلى 300 ميجابايت من الذاكرة العشوائية داخل Docker، بينما تستهلك عقد المعالجة ذاكرة إضافية أثناء عمليات الرندر وضغط الفيديو النشطة.