🎵 تثبيت Music Assistant — بث الموسيقى متعدد الغرف على Docker

نشر خادم Music Assistant على Ubuntu عبر Docker — منصة موحدة لإدارة وتجميع مكتبات الموسيقى والبث الصوتي المتزامن لخدمات Spotify وTidal وQobuz والملفات المحلية إلى السماعات الذكية.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر خادم Music Assistant على المنفذ 8298 مع حفظ دائم للإعدادات واكتشاف تلقائي للسماعات.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/iot/music-assistant/music-assistant-ubuntu.sh
chmod +x music-assistant-ubuntu.sh
./music-assistant-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/iot/music-assistant/music-assistant-ubuntu.sh

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

chmod +x music-assistant-ubuntu.sh

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

./music-assistant-ubuntu.sh

4 فتح واجهة الويب وإضافة مزودي الموسيقى

http://your-server-ip:8298

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

المنفذالغرض
8298Music Assistant web interface (mapped from container port 8095; host network for speaker discovery)

نظرة عامة

يعد Music Assistant (MASS) خادماً مفتوح المصدر لإدارة وبث الموسيقى متعدد الغرف، مصمماً لدمج جميع مصادر الموسيقى الخاصة بك (Spotify وTidal وQobuz وApple Music وYouTube Music وراديو الإنترنت ومكتبات الملفات المحلية) في واجهة مستخدم واحدة موحدة. يعمل الخادم على المنفذ 8298 (المحول من المنفذ الداخلي 8095)، ويعمل كجسر وسائط ذكي قادر على توجيه أي مقطع صوتي إلى أي سماعة ذكية أو مستقبل شبكي — بما في ذلك سماعات Sonos وGoogle Cast (Chromecast وNest) وApple AirPlay وDLNA/UPnP وSnapcast وESPHome.

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

يعاني قطاع الصوتيات الذكية في المنازل من التشتت والتقييد بين الشركات؛ فسماعات Sonos لا تتزامن تلقائياً مع سماعات Google Nest، وملفاتك الصوتية المحلية عالية الدقة (FLAC) تتطلب تطبيقات مختلفة عن قوائم تشغيل Spotify. يزيل Music Assistant هذه الحواجز كلياً من خلال توحيد مصادر الموسيقى في مكتبة واحدة تدعم البحث الشامل والتلاشي المتبادل (Crossfade) وتطبيع مستوى الصوت، مع إمكانية تجميع السماعات من ماركات مختلفة للبث المتزامن في جميع غرف المنزل.

متى تحتاجه

  • تمتلك سماعات ذكية من علامات تجارية متنوعة (Sonos وGoogle Nest وAirPlay وDLNA) وتريد تشغيل الموسيقى عليها جميعاً من تطبيق واحد
  • ترغب في دمج اشتراكات البث السحابي (Spotify وTidal) مع مكتبة موسيقاك المحلية في واجهة بحث موحدة
  • تستخدم منصة Home Assistant وتريد تحكماً صوتياً وأتمتة متقدمة لتشغيل الوسائط في أرجاء المنزل
  • تحتاج إلى بث موسيقي متعدد الغرف متزامن دون شراء أجهزة وموزعات صوتية تجارية باهظة
  • تريد الاستمتاع بجودة صوت عالية الدقة (Hi-Res) مع ميزات معالجة الصوت المتقدمة مثل تطبيع الصوت والمعادلات الصوتية

من يحتاجه

  • هواة المنازل الذكية الذين يبحثون عن نظام صوتي متكامل يرتبط بسلاسة مع Home Assistant
  • عشاق الصوتيات النقية (Audiophiles) الذين يمتلكون مكتبات ملفات صوتية ضخمة بجانب خدمات البث
  • أصحاب المنازل التي تحتوي على مزيج من سماعات Chromecast وSonos وApple TV ومستقبلات الصوت
  • المطورون وهواة بناء أنظمة الصوت المخصصة باستخدام متحكمات ESP32 أو Raspberry Pi مع Snapcast
  • المستخدمون الراغبون في إدارة موسيقاهم بحرية واستقلالية بعيداً عن تطبيقات الشركات المغلقة

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

  • بث موسيقى متزامن لغرف متعددة تحتوي على مزيج من سماعات Sonos ومكبرات Google Nest في وقت واحد
  • توحيد ألبومات FLAC المخزنة على خادم التخزين الشبكي NAS مع قوائم تشغيل Spotify وTidal تحت صفحة فنان واحدة
  • أتمتة تشغيل قوائم الموسيقى الصباحية الهادئة في أرجاء المنزل تلقائياً عبر Home Assistant
  • بث محطات الراديو العالمية والإنترنت إلى أجهزة استقبال AirPlay وشاشات التلفاز الذكية عبر DLNA
  • التحكم في تشغيل الموسيقى عبر واجهة الويب السريعة والمتجاوبة على الهواتف والأجهزة اللوحية والشاشات الجدارية

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

  • دعم شامل لمزودي الموسيقى: Spotify وTidal وQobuz وApple Music وYouTube Music وDeezer والملفات المحلية
  • دعم بروتوكولات التشغيل المتنوعة: Sonos وGoogle Cast وAirPlay 1/2 وDLNA/UPnP وSnapcast وSlimproto وESPHome
  • تجميع السماعات من ماركات مختلفة للبث المتزامن مع تعويض تلقائي لتأخير الإشارة والشبكة
  • بحث موحد وفوري عبر جميع منصات البث والمكتبات المحلية في وقت واحد
  • معالجة صوتية رقمية متقدمة (DSP): تطبيع مستوى الصوت EBU R128، التشغيل دون فواصل (Gapless)، والتلاشي المتبادل
  • تكامل عميق مع Home Assistant لإنشاء كيانات مشغلات وسائط وعرض أغلفة الألبومات والتحكم بالسيناريوهات
  • واجهة ويب عصرية وسريعة مصممة للعمل بكفاءة على الهواتف وشاشات التحكم الجدارية والحواسيب
  • قاعدة بيانات SQLite محلية لتخزين بيانات المكتبة والمفضلة وقوائم التشغيل وحالات التشغيل بدقة

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

  • افتح واجهة الويب عبر المتصفح على الرابط http://ip-سيرفرك:8298
  • انتقل إلى الإعدادات (أيقونة الترس) ← Music Providers لإضافة حسابات البث الموسيقي (Spotify أو Tidal) أو تحديد مسار مجلد الموسيقى المحلي
  • انتقل إلى Settings ← Player Providers لتفعيل اكتشاف السماعات لـ Google Cast أو Sonos أو AirPlay أو DLNA
  • انتظر بضع دقائق ليكتمل فحص المكتبة واكتشاف مشغلات الصوت المتصلة بشبكتك المحلية
  • أنشئ مجموعات السماعات (Speaker Groups) من تبويب Players لمزامنة تشغيل الصوت في عدة غرف معاً
  • ثبت تكامل Music Assistant داخل Home Assistant للتحكم في التشغيل عبر سيناريوهات الأتمتة الذكية

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

  • تم تصميم Music Assistant للعمل داخل الشبكة المحلية (LAN) ولا يفرض نظام مصادقة افتراضياً على واجهة الويب
  • أبقِ المنفذ 8298 محصوراً داخل شبكتك المنزلية الموثوقة وتجنب فتحه مباشرة للإنترنت العام
  • إذا كنت بحاجة للوصول عن بُعد، استخدم شبكة VPN آمنة (مثل WireGuard أو Tailscale) أو وكيلاً عكسياً محمياً بالمصادقة (Authelia)
  • تخزن بيانات الاعتماد ورموز OAuth الخاصة بحسابات البث بأمان داخل مجلد البيانات الدائم ./data
  • حدّث صورة الحاوية ghcr.io/music-assistant/server دورياً للحصول على أحدث ميزات التوافق والتحديثات الأمنية

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

تعمل واجهة Music Assistant على المنفذ 8298 (المحول من منفذ 8095 الداخلي). ونظراً لأن Music Assistant يعتمد على بروتوكولات mDNS وSSDP وUPnP لاكتشاف السماعات الذكية على شبكتك المحلية، يُوصى بشدة بتشغيل الحاوية في وضع شبكة المضيف (`network_mode: host`) لتمكين الاكتشاف التلقائي السلس. أبقِ هذا المنفذ محلياً داخل شبكة LAN ولا تفتحه للإنترنت العام دون وكيل عكسي محمي.

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

  • انسخ مجلد ./data احتياطياً، والذي يحتوي على قاعدة بيانات music_assistant.db وإعدادات المزودين والأغلفة المخزنة مؤقتاً
  • احتفظ بنسخة من بيانات اعتماد المزودين وإعدادات المشغلات المخصصة في ملفات الإعداد
  • جدول نسخاً احتياطية دورية لمجلد التطبيق وارفعه إلى مساحة تخزين سحابية عبر rsync أو restic
  • اختبر الاستعادة بربط مجلد البيانات المنسوخ بحاوية جديدة والتحقق من استرجاع السماعات والإعدادات بنجاح

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

  • تشغيل الحاوية في شبكة bridge دون وضع host، مما يمنع الحاوية من استقبال حزم mDNS واكتشاف سماعات Chromecast وSonos
  • فتح المنفذ 8298 للإنترنت العام على سيرفر VPS دون طبقة مصادقة وأمان
  • نسيان منح الحاوية صلاحيات القراءة لمجلد الموسيقى المحلي، مما يسبب فشل فهرسة الأغاني
  • تشغيل المزامنة متعددة الغرف على شبكة واي فاي 2.4GHz مزدحمة دون زيادة حجم مخزن الذاكرة المؤقتة (Buffer)
  • عدم ربط مجلد التخزين الدائم ./data، مما يؤدي لفقدان تسجيلات الدخول وإعدادات المزودين عند إعادة إنشاء الحاوية

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

  • عدم ظهور السماعات — تأكد من تشغيل الحاوية في وضع `network_mode: host` أو تفعيل مكرر mDNS بين شبكات VLAN
  • تقطيع أو توقف الصوت أثناء التشغيل — زد حجم الذاكرة المؤقتة (Buffer) في إعدادات المشغل أو صل السماعات بشبكة 5GHz مستقرة
  • الملفات المحلية لا تظهر في المكتبة — تأكد من مسار ربط المجلد في docker-compose ومنح صلاحيات القراءة لمجلد الموسيقى
  • فشل تسجيل الدخول لـ Spotify أو Tidal — اتبع الرابط الظاهر لإتمام مصادقة OAuth وأعد تشغيل المزود
  • عدم إمكانية فتح واجهة الويب — افحص سجلات الحاوية بالأمر: docker logs music-assistant -f لمعرفة أسباب التعطل أو تعارض المنافذ

البدائل

نظام Volumio هو نظام تشغيل صوتي مخصص لأجهزة Raspberry Pi يدعم محولات الصوت DAC الاحترافية. خادم LMS (Logitech Media Server / Lyrion) هو نظام بث صوتي متعدد الغرف عريق ومفتوح المصدر. منصتا Navidrome وJellyfin هما خوادم وسائط مخصصة لبث الملفات الصوتية الشخصية إلى الهواتف. منصة Roon هي خيار تجاري فاخر يقدم بيانات موسيقية ثرية وتوزيع صوتي بتكلفة اشتراك مرتفعة.

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

تجنب استخدام Music Assistant إذا كان هدفك الأساسي هو الاستماع للموسيقى على هاتفك المحمول خارج المنزل عبر بيانات الهاتف — حيث تعد خوادم مثل Navidrome أو Plexamp أفضل وأكثر كفاءة للبث الخارجي. وإذا كنت لا تمتلك أي سماعات ذكية وتريد فقط تشغيل الموسيقى محلياً على حاسوبك، فإن مشغلات خفيفة مثل VLC أو Strawberry ستكون أبسط وأسهل.

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

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

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

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

ما هو Music Assistant وما فائدته؟

Music Assistant هو خادم بث موسيقي مفتوح المصدر يربط مصادر الموسيقى المتنوعة (Spotify وTidal ومكتبتك المحلية) بالسماعات الذكية (Sonos وGoogle Cast وAirPlay وDLNA) عبر واجهة مستخدم موحدة.

هل يمكن تشغيل الموسيقى على سماعات Sonos وGoogle Cast معاً في نفس الوقت؟

نعم، يتيح لك Music Assistant إنشاء مجموعات سماعات موحدة لمزامنة تشغيل الصوت بدقة عبر ماركات سماعات مختلفة، مما يدمج سماعات Sonos وGoogle Cast وAirPlay معاً.

هل يتطلب Music Assistant وجود نظام Home Assistant للعمل؟

لا، يعمل خادم Music Assistant كحاوية Docker مستقلة تماماً بواجهتها الخاصة، ولكنه يتكامل بعمق وسلاسة مع Home Assistant إذا رغبت في استخدامه ضمن الأتمتة المنزلية.

لماذا يُوصى بنمط شبكة المضيف (Host Network) لخادم Music Assistant؟

تعلن السماعات الذكية عن وجودها عبر حزم بث mDNS وSSDP على الشبكة المحلية، وشبكة Docker الافتراضية تعزل هذه الحزم، بينما يتيح وضع Host Network اكتشاف السماعات تلقائياً وفورياً.

هل يدعم Music Assistant الصوت عالي الدقة (Hi-Res Lossless)؟

نعم، يدعم Music Assistant ملفات FLAC وALAC وWAV والبث عالي الدقة من Qobuz وTidal، ويقوم بتمرير الصوت بدقة كاملة ومعدل عينات يطابق قدرات السماعة المستقبلة.