دليل

أنشئ خادم موسيقاك الخاص باستخدام Raspberry Pi

يُعد جهاز Raspberry Pi وسيلة هادئة ومنخفضة استهلاك الطاقة للاحتفاظ بمجموعتك الموسيقية بالكامل في منزلك وبثها من أي مكان. يرشدك هذا الدليل خلال إعداد الجهاز باستخدام Navidrome، وهو خادم موسيقى مجاني ومفتوح المصدر يعمل بسلاسة على Pi، وربطه بتطبيق Audex. يستغرق الأمر حوالي 30 دقيقة، يذهب معظمها في انتظار اكتمال التنزيلات.

حوالي 30 دقيقة جهاز Raspberry Pi 3 أو 4 أو 5 Navidrome + Docker

ما ستحتاج إليه

  • جهاز Raspberry Pi 4 أو 5 (ويعمل طراز Pi 3 بكفاءة أيضاً). لا يتطلب Navidrome إمكانيات عالية؛ إذ تكفي ذاكرة وصول عشوائي بحجم 2 غيغابايت وزيادة.
  • بطاقة microSD بسعة 16 غيغابايت أو أكثر، مع مزود الطاقة المخصص للجهاز. وإذا كانت مجموعتك الموسيقية ضخمة، فإن استخدام قرص SSD عبر منفذ USB يُعد خياراً أفضل من البطاقة.
  • اتصال بالشبكة المحلية. يُعد الاتصال السلكي عبر كابل موصول بالراوتر الخيار الأكثر استقراراً، مع إمكانية استخدام شبكة Wi-Fi.
  • حاسوب شخصي لتجهيز بطاقة التخزين ونسخ الملفات الموسيقية، على أن يتصل بشبكة الإنترنت ذاتها المتصل بها جهاز Pi.
  • ملفاتك الموسيقية (مثل MP3 وFLAC وM4A وOGG وOpus وما شابهها) مع وجود تطبيق Audex على هاتفك.

تفضل مشاهدة الشرح أولاً؟

يوضح هذا الشرح إعداد Navidrome على جهاز Raspberry Pi 5، ثم تصحيح وسوم الأغاني وإضافة محطات راديو الإنترنت. تتبع الخطوات المكتوبة أدناه طريقة التثبيت الرسمية باستخدام Docker لـ Navidrome، لذا قد تختلف الأوامر قليلاً عن الفيديو، ولكن كلاهما يؤدي إلى إعداد الخادم نفسه.

يبدأ تثبيت Navidrome عند الدقيقة 4:29. الفيديو مقدم من Jeffs Pi in the Sky، ولا يرتبط بأي صلة مع Audex. لا يتم تحميل أي محتوى من YouTube حتى تضغط على زر التشغيل. شاهده على YouTube

1. إعداد جهاز Raspberry Pi

  1. تثبيت نظام Raspberry Pi OS على بطاقة الذاكرة

    ثبّت برنامج Raspberry Pi Imager على حاسوبك واختر طراز جهاز Pi الخاص بك، ثم حدد Raspberry Pi OS Lite (64-bit) من قائمة «Raspberry Pi OS (other)». لن تحتاج إلى واجهة سطح مكتب عند إعداد خادم.

    تنزيل برنامج Raspberry Pi Imager
  2. تعبئة الإعدادات قبل النسخ على البطاقة

    عندما يتيح لك البرنامج تخصيص النظام، حدد اسم مضيف (Hostname) مثل audex-pi، واسم مستخدم وكلمة مرور، وشبكة Wi-Fi إن لم تكن تستخدم كابلاً سلكياً، وفعّل اتصال SSH باستخدام كلمة المرور. بعد ذلك، انسخ البيانات إلى البطاقة، وأدخلها في جهاز Pi ثم شغله. يستغرق التشغيل للمرة الأولى بضع دقائق.

  3. الاتصال بجهاز Pi من حاسوبك الشخصي

    افتح نافذة الأوامر الطرفية (مثل PowerShell على ويندوز، أو Terminal على macOS أو لينكس) وسجل الدخول باستخدام اسم المستخدم الذي حددته:

    ssh [email protected]

    إذا تعذر العثور على العنوان audex-pi.local، يمكنك استخدام عنوان IP الخاص بجهاز Pi من قائمة الأجهزة المتصلة براوتر الشبكة بدلاً من ذلك.

  4. تحديث النظام لأحدث إصدار
    sudo apt update && sudo apt full-upgrade -y

2. تثبيت برنامج Navidrome

  1. تثبيت منصة Docker

    تقوم منصة Docker بتشغيل Navidrome داخل حاوية يسهل تحديثها لاحقاً. تعتمد هذه الطريقة على سكريبت التثبيت الرسمي لـ Docker، وتسمح لمستخدمك بتشغيله دون الحاجة لصلاحيات sudo:

    curl -fsSL https://get.docker.com -o get-docker.sh
    sudo sh get-docker.sh
    sudo usermod -aG docker $USER

    اكتب الأمر exit ثم سجل الدخول مجدداً عبر ssh لضمان تطبيق التغييرات.

  2. إنشاء مجلدات خاصة بـ Navidrome ومكتبتك الموسيقية
    mkdir -p ~/navidrome/data ~/music
  3. نسخ ملفاتك الموسيقية إلى جهاز Pi

    من نافذة الأوامر الطرفية على حاسوبك (وليس على جهاز Pi)، قم بنسخ أحد مجلدات الموسيقى. كرر هذه الخطوة لكل مجلد، أو انسخ مكتبتك الموسيقية بالكامل دفعة واحدة:

    scp -r "Path/To/Your Music Folder" [email protected]:music/

    نسخ المكتبات الكبيرة يكون أسرع عند استخدام قرص تخزين USB موصول مباشرة بجهاز Pi. احرص على تخصيص مجلد مستقل لكل فنان أو ألبوم، حيث يستطيع Navidrome قراءة الوسوم داخل الملفات في جميع الأحوال.

  4. إعداد تكوين الخادم في ملف Compose

    العودة إلى جهاز Pi لإنشاء ملف جديد:

    nano ~/navidrome/compose.yaml

    الصق النص المطلوب، ثم احفظ التغييرات بالضغط على Ctrl+O ثم Enter، وأغلق الملف باستخدام Ctrl+X:

    services:
      navidrome:
        image: navidrome/navidrome:latest
        user: 1000:1000
        ports:
          - "4533:4533"
        restart: unless-stopped
        volumes:
          - ./data:/data
          - ../music:/music:ro

    1000:1000يمثل المستخدم الأول في نظام Raspberry Pi OS الذي أنشأته بنفسك. يتم ربط مجلد الموسيقى بصلاحية القراءة فقط، مما يمنع Navidrome من تعديل ملفاتك بأي شكل.

  5. تشغيل الخادم
    cd ~/navidrome
    docker compose up -d

    سيقوم التشغيل الأول بتنزيل برنامج Navidrome. ويضمن الأمر restart: unless-stopped إعادة تشغيله تلقائياً كلما تم إعادة تشغيل جهاز Pi.

  6. إنشاء حسابك ضمن Navidrome

    افتح متصفح الويب على حاسوبك وانتقل إلى العنوان http://audex-pi.local:4533 لإنشاء الحساب الأول الذي سيكون حساب المسؤول (Admin). سيقوم Navidrome بعدها بفحص مجلد موسيقاك تلقائياً، لتظهر الألبومات خلال بضع دقائق.

  7. تعيين عنوان IP ثابت لجهاز Pi

    احصل على عنوان جهاز Pi باستخدام الأمر hostname -I، ثم قم بحجز هذا العنوان في إعدادات جهاز الراوتر (يُعرف عادة بحجز DHCP أو التأجير الثابت). يضمن لك ذلك عدم تغير العنوان الذي تدخله في تطبيق Audex أبداً.

3. ربط تطبيق Audex

  1. إضافة الخادم

    داخل تطبيق Audex، انتقل إلى الإعدادات ← خوادم الوسائط ← إضافة خادم واختر Subsonic / OpenSubsonic / Navidrome. (تظهر خوادم Jellyfin وEmby وKodi تلقائياً تحت قسم على هذه الشبكة، بينما لا يبث Navidrome إعلاناً عن نفسه، لذا تضيفه يدوياً باستخدام عنوانه.)

  2. إدخال عنوان الخادم وبيانات تسجيل الدخول

    استخدم عنوان جهاز Pi ورقم المنفذ الخاص به، مثل http://192.168.1.50:4533، مع اسم المستخدم وكلمة المرور لـ Navidrome التي أنشأتها للتو. سيقوم Audex باختبار الاتصال قبل الحفظ لتعلم فوراً ما إذا كان يعمل بنجاح.

  3. تفعيل خيار «البث بالجودة الأصلية»

    في نفس النموذج (أو لاحقاً من صفحة الخادم عبر الإعدادات ← خوادم الوسائط)، فعّل خيار Stream original quality. سيقوم جهاز Pi حينها بإرسال ملفاتك كما هي تماماً دون الحاجة لتحويل صيغتها، مما يحافظ على سرعته ويحميه من السخونة. ولأن ذلك سيهلك بيانات جوال أكبر خارج المنزل، فاتركه معطلاً إذا كانت باقة البيانات لديك محدودة.

  4. شغل شيئاً

    اختر الخادم من قائمة تبديل المصادر أعلى المكتبة. ستظهر الألبومات والفنانون والأنواع وقوائم التشغيل تماماً كما ينظمها Navidrome، ويمكنك تنزيل أي محتوى للاستماع إليه دون اتصال بالإنترنت.

اختياري: الاستماع خارج المنزل

لا يمكن الوصول إلى جهاز Pi إلا عبر شبكتك المنزلية حتى تضيف طريقة للاتصال به من الخارج. وأبسط وأكثر الطرق أماناً هي استخدام شبكة افتراضية خاصة (VPN) مثل Tailscale، والتي لا تتطلب أي تعديلات على جهاز الراوتر لديك:

  1. ثبت Tailscale على جهاز Pi وسجل الدخول
    curl -fsSL https://tailscale.com/install.sh | sh
    sudo tailscale up

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

    احصل على Tailscale
  2. أضفه كعنوان ثانٍ للخادم

    قم بتعديل إعدادات الخادم في Audex وأدخل عنوان Tailscale الخاص بجهاز Pi (الذي يبدأ بـ 100. متبوعاً بـ :4533) في حقل Second address (optional). في المنزل، سيستخدم Audex عنوانك المنزلي، وحين يتعذر الوصول إليه، سيتحول تلقائياً إلى العنوان الثاني.

هل تستخدم بروتوكول HTTPS مع شهادة ذاتية التوقيع؟ يعرض Audex تفاصيل الشهادة وبصمتها الرقمية SHA-256 عند الاتصال لأول مرة، لكي تمنح ثقتك لتلك الشهادة بالتحديد. وإذا حدث وتغيرت في أي وقت، فسيتوقف Audex عن الاتصال ويسألك قبل المتابعة.

إذا واجهتك أي مشكلة في التشغيل

يعمل Navidrome ولكن المكتبة فارغة
لا يمكن لـ Navidrome قراءة مجلد الموسيقى. امنح مستخدمَك صلاحية الملكية الكاملة عليه، ثم أعد تشغيل Navidrome:
sudo chown -R 1000:1000 ~/music ~/navidrome/data
cd ~/navidrome && docker compose restart
لا يمكن لـ Audex الاتصال بالخادم
تأكد من أن هاتفك متصل بنفس شبكة Wi-Fi المتصل بها جهاز Pi، وأن العنوان المدخل في Audex يتضمن :4533. وعلى جهاز Pi، يجب أن يوضح الأمر docker compose ps (داخل مجلد ~/navidrome) أن Navidrome قيد التشغيل. وإذا تغير عنوان جهاز Pi، فقم بحجزه في إعدادات الراوتر كما فعلت في الخطوة 2.
كيف يمكنني تحديث Navidrome لاحقاً؟
على جهاز Pi:
cd ~/navidrome
docker compose pull && docker compose up -d
يتم الاحتفاظ بحسابك وإعداداتك في المجلد ~/navidrome/data دون أي ضياع.
هل يمكنني استخدام Jellyfin على جهاز Pi بدلاً منه؟
نعم. يعمل Jellyfin بكفاءة عالية لتشغيل الموسيقى على أجهزة Pi 4 أو 5، ويتصل به Audex بنفس الطريقة (عبر المنفذ 8096)، وغالباً ما يكتشفه تلقائياً تحت قسم On this network. أما بالنسبة للفيديو، فاحرص على حفظ الملفات بالصيغ التي تشغلها أجهزتك مباشرة، نظراً لأن جهاز Pi لا يستطيع تحويل صيغ الفيديو بسرعة. ويظل Navidrome الخيار الأنسب والأخف إذا كان غرضك الوحيد هو تشغيل الموسيقى.

هل ما زلت تواجه مشكلة؟ راسلنا على [email protected]، ففريق حقيقي يقرأ كل رسالة واردة.