🎟️ تثبيت Wizarr — نظام دعوة وتهيئة مستخدمي سيرفرات Jellyfin وPlex على Docker
نشر منصة Wizarr على Ubuntu باستخدام Docker — نظام الدعوات المؤتمت وتهيئة المستخدمين الجدد لسيرفرات Jellyfin وPlex وEmby مع تحديد المكتبات والربط مع ديسكورد على المنفذ 5690.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/wizarr/wizarr-ubuntu.sh
chmod +x wizarr-ubuntu.sh
sudo bash wizarr-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/wizarr/wizarr-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x wizarr-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم لقاعدة البيانات (`./data`) وتشغيل حاوية Wizarr على المنفذ 5690.
sudo bash wizarr-ubuntu.sh
4 ربط سيرفر الوسائط وتوليد أول رابط دعوة
افتح متصفحك على الرابط http://ip-سيرفرك:5690. أكمل معالج التثبيت بربط رابط سيرفر Jellyfin أو Plex ومفتاح الـ API، ثم أنشئ أول رابط دعوة مخصص.
http://<your-server-ip>:5690
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 5690 | Web UI (host → container 5690) — connect media server in setup |
| ./data | Config, invites, and server connection |
نظرة عامة
تعد Wizarr منصة ونظاماً مفتوح المصدر لأتمتة دعوة وتهيئة المستخدمين الجدد (User Invitation & Onboarding) لسيرفرات الوسائط المنزلية Jellyfin وPlex وEmby. تعمل المنصة عبر المنفذ 5690 لتخلص مديري السيرفرات من عناء إنشاء الحسابات يدوياً، وتحديد صلاحيات المكتبات لكل مستخدم، وشرح كيفية تنزيل التطبيقات. ويتيح Wizarr إنشاء روابط دعوة مؤقتة تنتهي بوقت محدد، وعندما يفتح المستخدم الرابط يتم توجيهه خطوة بخطوة لإنشاء حسابه، وتحديد مكتبات الأفلام، وتنزيل التطبيق المتوافق مع جهازه تلقائياً.
لماذا تستخدمه
يعد تسجيل الأصدقاء والعائلة على سيرفرك الخاص مهمة روتينية مرهقة: طلب البريد، وإنشاء الحسابات في لوحة التحكم يدوياً، وتحديد مكتبات المشاهدة، والإجابة عن كيفية تثبيت التطبيقات على التلفزيون والهاتف. يؤتمت Wizarr هذه الدورة بالكامل: ترسل رابط دعوة واحد بهوية احترافية، ليقوم المستخدم بتسجيل بياناته بنفسه، وتُمنح له صلاحيات المكتبات المحددة، مع دليل مرئي لشرح تشغيل الوسائط على كافة الأجهزة بدون أي تدخل يدوي منك.
متى تحتاجه
- تدير سيرفر Jellyfin أو Plex أو Emby وتريد نظام تسجيل ودعوات تلقائي للمستخدمين
- تريد روابط دعوة ذكية تنتهي صلاحيتها بعد مدة زمنية محددة أو بعد عدد محدد من الاستخدامات
- تريد دليلاً بصرياً يوجه أصدقاءك وعائلتك غير التقنيين لكيفية تحميل وتثبيت مشغلات الوسائط
- تريد تخصيص المكتبات المتاحة (أفلام، مسلسلات، أنمي، أطفال) لكل رابط دعوة بشكل منفصل
- تريد ربط تسجيل المستخدمين بسيرفر ديسكورد لمنح الرتب تلقائياً وإرسال رسائل الترحيب
من يحتاجه
- مديرو السيرفرات المنزلية (Homelab) الذين يشاركون سيرفرات Jellyfin وPlex مع الأصدقاء والعائلة
- مديرو مجتمعات البث الرقمي لإدارة الدعوات والتحقق من عضويات ديسكورد
- عشاق الوسائط الذين يقدمون مكتبات 4K أو أنمي مخصصة بفئات وصول مختلفة
- مهندسو الأنظمة الراغبون في أتمتة إدارة حسابات مستخدمي سيرفرات الترفيه
- المستخدمون المحترفون الباحثون عن بوابة ترحيب أنيقة ومخصصة لمنظومة المشاهدة المنزلية
حالات الاستخدام الشائعة
- إنشاء رابط دعوة لمرة واحدة لصديق يقوم بإنشاء حسابه في Jellyfin ويمنحه وصولاً لمكتبة الأفلام والمسلسلات
- توليد رابط دعوة لمجتمع يضم 20 عضواً ينتهي خلال 48 ساعة ويمنحهم رتبة المشاهدة في سيرفر Discord
- تقديم روابط تحميل مباشرة لتطبيق Jellyfin Media Player لأنظمة Windows وApple TV وAndroid TV وiOS
- منح فترات وصول تجريبية لمدة 30 يوماً لمكتبات الوسائط مع تعطيل الحساب تلقائياً عند انتهاء المدة
- الدمج مع Overseerr / Jellyseerr لتوحيد تجربة إنشاء الحسابات وطلب الأفلام والمسلسلات الجديدة
الميزات الرئيسية
- روابط دعوات مؤتمتة على المنفذ 5690: إنشاء روابط فردية أو جماعية مع تحديد فترات الصلاحية وعدد المرات
- دعم خوادم الوسائط المتعددة: تكامل مباشر مع سيرفرات Jellyfin وPlex وEmby
- تحديد دقيق للمكتبات: اختيار المكتبات المتاحة للمستخدم (أفلام 4K، أطفال، أنمي، وثائقيات) لكل دعوة
- تهيئة بصرية وإرشادية للمستخدم: معالج تفاعلي يشرح تحميل التطبيقات وبيانات تسجيل الدخول
- تكامل مع روبوتات Discord: منح رتب مخصصة وإرسال إشعارات ترحيبية فور إنشاء الحساب
- حسابات تجريبية ومؤقتة: تعطيل أو حذف الحسابات تلقائياً بعد فترة زمنية محددة (مثل 30 يوماً)
- محرك SQLite خفيف وفائق السرعة: تشغيل سلس وتخزين لكافة سجلات الدعوات في مجلد التخزين الدائم `./data`
- معمارية Docker Compose تجمع Wizarr مع ربط مجلد `./data` على المنفذ 5690
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:5690
- أكمل معالج الإعداد: عيّن كلمة مرور المشرف واختر نوع سيرفر الوسائط (Jellyfin أو Plex أو Emby)
- أدخل رابط سيرفر الوسائط ومفتاح الـ API للربط البرمجي
- اضبط التعليمات الافتراضية وروابط تحميل التطبيقات الموجهة للمستخدمين
- اضغط على '+ Create Invitation'، وحدد المكتبات المستهدفة ومدة الصلاحية، وانسخ الرابط الناتج
- ضع Wizarr خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
- أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة البيانات `./data`
أفضل ممارسات الأمان
- تنبيه أمني حاسم: عيّن كلمة مرور معقدة لحساب المشرف أثناء معالج التثبيت الأول
- استخدم تشفير HTTPS دائماً لحماية كلمات مرور المستخدمين ومفاتيح الـ API أثناء التسجيل
- استخدم روابط دعوة لمرة واحدة أو عيّن مدة انتهاء صارمة للروابط المنشورة بالمجموعات العامة
- لا تشارك مفاتيح API الرئيسية لسيرفر الوسائط مع المستخدمين (يقوم Wizarr بالوساطة الآمنة)
- احمِ مجلد البيانات `./data` الذي يحتوي على قاعدة بيانات SQLite بصلاحيات نظام صارمة (`chmod 700`)
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار
المنافذ وإعدادات جدار الحماية
يقدم Wizarr واجهة الويب وبوابة الدعوات عبر منفذ TCP 5690. اسمح بالمنفذ 5690 للشبكة المحلية (`ufw allow 5690/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 5690، مع إبقاء المنفذ 5690 مغلقاً خارجياً.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./data` احتياطياً، والذي يحتوي على ملف قاعدة بيانات `database.sqlite` بكافة الدعوات والربط بالخوادم
- احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بنسخ مجلد `./data` بحاوية تجريبية والتأكد من ظهور كافة الدعوات النشطة
الأخطاء الشائعة
- عدم ربط مجلد التخزين الدائم `./data`، مما يسبب مسح كافة الدعوات النشطة والربط بالسيرفر عند تحديث الحاوية
- تشغيل Wizarr عبر HTTP غير المشفر مما يكشف كلمات مرور المستخدمين الجدد أثناء التسجيل
- إنشاء روابط دعوة غير محدودة وبدون تاريخ انتهاء في المنتديات العامة مما يسبب استنزاف موارد السيرفر
- كتابة عنوان IP داخلي غير متاح لسيرفر الوسائط أثناء الإعداد مما يسبب فشل إنشاء حسابات المستخدمين
- نسيان ضبط ترويسات الوكيل العكسي مما يظهر عناوين IP داخلية في شاشات الإرشادات للمستخدمين
استكشاف الأخطاء وإصلاحها
- رفض الاتصال بالواجهة — تأكد من عمل الحاوية بالأمر `docker compose ps` وافحص السجلات: `docker logs wizarr -f`
- فشل اختبار الاتصال بسيرفر الوسائط — تأكد من صحة مفتاح الـ API وإمكانية وصول الحاوية لسيرفر Jellyfin/Plex
- فشل إنشاء حساب المستخدم عبر الرابط — تأكد من تفعيل صلاحيات إنشاء المستخدمين وتوفر تراخيص في سيرفر الوسائط
- روبوت Discord لا يسند الرتب — تأكد من صلاحيات البوت وترتيب الرتب في إعدادات سيرفر ديسكورد
- خطأ قفل قاعدة البيانات (Database Locked) — تأكد من وضع ملف البيانات على قرص محلي وليس مشاركة NFS شبكية
البدائل
منصة Jellyseerr / Overseerr لطلبات الوسائط والأفلام. منصة Ombi لإدارة الطلبات والمستخدمين. منصة Petio لطلبات المشاهدة. الإنشاء اليدوي للمستخدمين من لوحة تحكم Jellyfin/Plex مباشرة.
متى لا تستخدمه
تجنب استخدام Wizarr إذا كنت المستخدم الوحيد لسيرفرك ولا تشارك البث مع أي شخص آخر. وإذا كنت تحتاج خصيصاً لبوابة تتيح للمستخدمين البحث عن الأفلام والمسلسلات الجديدة وطلب تحميلها آلياً، فإن Jellyseerr أو Overseerr مخصصة لطلبات التحميل (وتعمل بتوافق رائع مع Wizarr).
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي منصة Wizarr وما هي خوادم الوسائط التي تدعمها؟
تعد Wizarr منصة مؤتمتة لإدارة دعوة وتهيئة مستخدمي خوادم الوسائط. تدعم سيرفرات Jellyfin وPlex وEmby، وتتيح للمشرفين إنشاء روابط دعوات تقوم بإنشاء الحسابات وتخصيص المكتبات للمستخدمين تلقائياً.
هل يمكن تحديد تاريخ انتهاء لروابط الدعوة؟
نعم! يتيح لك Wizarr تحديد فترات صلاحية مخصصة للروابط (مثل الانتهاء بعد 24 ساعة أو 7 أيام) بالإضافة لتحديد الحد الأقصى لعدد مرات الاستخدام (مثل رابط للاستخدام مرة واحدة فقط).
هل يمكنني تقييد المكتبات التي يصل إليها المستخدم المدعو؟
نعم! عند إنشاء رابط الدعوة في Wizarr، يمكنك تحديد المكتبات المسموح بها بدقة (مثل مكتبة الأفلام والمسلسلات واستبعاد مكتبات 4K أو المستندات الخاصة) للمستخدم الجديد.
هل يتكامل Wizarr مع منصة ديسكورد (Discord)؟
نعم! يتضمن Wizarr تكاملاً مدمجاً مع بوتات Discord لمنح رتب مخصصة للأعضاء الجدد تلقائياً في سيرفر ديسكورد وإرسال رسائل ترحيبية عند إكمال تسجيل الحساب.
كم يستهلك تطبيق Wizarr من الذاكرة العشوائية (RAM)؟
تم بناء Wizarr بتقنيات Python/Node.js مع قاعدة بيانات SQLite، ويتميز بخفة ممتازة حيث يستهلك عادة ما بين 50 إلى 120 ميجابايت فقط من الرام داخل Docker.