كيفية تشغيل خادم أمباتشي على خادم أوبونتو

يحوّل برنامج Ampache خادم Ubuntu إلى مكتبة موسيقى مُستضافة ذاتيًا يُمكنك تشغيلها عبر متصفح أو تطبيق متوافق. يستخدم هذا الدليل Ubuntu Server 26.04 LTS، وApache، وMariaDB، وAmpache 8.3.0. يتطلب Ampache 8 الإصدار PHP 8.5 أو أحدث، لذا يُرجى مراجعة متطلبات التثبيت الرسمية قبل استخدام إصدار أقدم من Ubuntu.

ستحتاج إلى حساب بصلاحيات المستخدم الجذر (sudo)، ومساحة تخزين كافية لملفات الموسيقى، واسم نطاق إذا كنت تخطط لجعل الخادم متاحًا عبر الإنترنت العام. اجعل برنامج التثبيت مقتصرًا على شبكة موثوقة حتى اكتمال الإعداد.

قم بتثبيت Ampache على خادم Ubuntu

1. قم بتثبيت Apache و MariaDB و PHP وأدوات الصوت

قم بتحديث أوبونتو وتثبيت مكونات الخادم وإضافات PHP الخاصة بـ Ampache. يدعم FFmpeg وأدوات الصوت معالجة الوسائط وتحويل الترميز.

sudo apt update
sudo apt upgrade -y
sudo apt install apache2 mariadb-server php8.5 php8.5-cli php8.5-curl php8.5-gd php8.5-intl php8.5-mbstring php8.5-mysql php8.5-xml php8.5-zip ffmpeg flac lame vorbis-tools inotify-tools zip unzip curl
sudo systemctl enable --now apache2 mariadb

يتضمن نظام أوبونتو 26.04 إصدار PHP 8.5 ضمن أرشيفه. إذا كان خادمك يدعم إصدارًا مختلفًا من PHP، فاختر إصدارًا من Ampache متوافقًا مع ذلك الإصدار، أو اتبع دليل Ampache الخاص بالإصدار؛ ولا تفترض أن phpالحزمة غير المُرقمة تفي بمتطلبات Ampache 8.

2. أنشئ قاعدة بيانات ومستخدمًا مخصصًا

افتح واجهة إدارة MariaDB المحلية. سيقتصر وصول حساب التطبيق على قاعدة بيانات Ampache فقط، بينما تبقى إدارة MariaDB المحلية في Ubuntu منفصلة.

sudo mariadb

في موجه أوامر MariaDB، أنشئ قاعدة البيانات واستبدل كلمة المرور النموذجية بكلمة مرور طويلة وفريدة. تجنب استخدام علامة اقتباس مفردة في كلمة المرور إلا إذا قمت بإلغاء تهريبها بشكل صحيح في SQL.

CREATE DATABASE ampache CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'ampacheuser'@'localhost' IDENTIFIED BY 'REPLACE_WITH_A_LONG_RANDOM_PASSWORD';
GRANT ALL PRIVILEGES ON ampache.* TO 'ampacheuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

3. قم بتنزيل أرشيف إصدار Ampache

تعرض صفحة الإصدار الرسمية الأرشيفات ذات الإصدارات المختلفة. يوضح المثال أدناه تثبيت Ampache 8.3.0 وإصدار PHP 8.5 الخاص به؛ إذا كان هناك إصدار أحدث متاح عند التثبيت، فقم بتحديث كل من رقم الإصدار واسم الملف.

cd /tmp
wget https://github.com/ampache/ampache/releases/download/8.3.0/ampache-8.3.0_php8.5.zip
sudo mkdir -p /var/www/ampache
sudo unzip ampache-8.3.0_php8.5.zip -d /var/www/ampache
sudo chown -R root:www-data /var/www/ampache
sudo chmod -R g+rX /var/www/ampache
sudo chown www-data:www-data /var/www/ampache/config
sudo chmod 775 /var/www/ampache/config

يحتاج خادم الويب إلى كتابة مجلد الإعدادات أثناء عملية التثبيت. أما بقية ملفات التطبيق فيمكن أن تبقى مملوكة للمستخدم الجذر وقابلة للقراءة بواسطة خادم أباتشي.

4. قم بتوجيه Apache إلى الدليل العام لـ Ampache

يُعدّ المجلد الفرعي هو المجلد الرئيسي لموقع Ampache public. على خادم جديد مُخصّص لـ Ampache، عدّل المضيف الافتراضي؛ استخدم مضيفًا افتراضيًا منفصلاً إذا كان Apache يُقدّم مواقع أخرى بالفعل.

sudo nano /etc/apache2/sites-available/000-default.conf

داخل <VirtualHost *:80>الكتلة الموجودة، قم بتعيين اسم الخادم وجذر المستند، ثم أضف قواعد الدليل:

ServerName ampache.example.com
DocumentRoot /var/www/ampache/public

<Directory /var/www/ampache/public>
    AllowOverride All
    Require all granted
</Directory>

قم بتمكين إعادة كتابة Apache، وإنشاء ملفات إعادة الكتابة المرفقة مع Ampache، واختبار التكوين، وإعادة تحميل Apache:

sudo a2enmod rewrite
cd /var/www/ampache
sudo php bin/installer htaccess -e -p
sudo apache2ctl configtest
sudo systemctl reload apache2

يُمكّن هذا AllowOverride Allالإعداد خادم Apache من قراءة هذه الملفات. يُحذّر Ampache من أن البث المباشر وواجهات برمجة التطبيقات الخاصة به قد تُعيد أخطاء 404 عند عدم توفر إعادة الكتابة؛ راجع دليل قواعد إعادة الكتابة إذا كنت تستخدم مضيفًا افتراضيًا مخصصًا.

5. تحقق من الخادم في مُثبِّت Ampache

من جهاز كمبيوتر على شبكتك الموثوقة، افتح الملف http://ampache.example.com/install.php. إذا لم تقم بتكوين نظام أسماء النطاقات (DNS)، فاستخدم عنوان IP الخاص بالخادم. اختر لغة، ثم حدد " بدء التكوين" ، وراجع صفحة المتطلبات. قم بحل جميع مشاكل وحدات PHP المفقودة قبل المتابعة؛ ثبّت الحزمة المطابقة php8.5-وأعد تشغيل Apache عند الحاجة.

6. قم بتوصيل قاعدة البيانات واكتب الإعدادات

أدخل localhostاسم مضيف قاعدة البيانات، ampacheواسم قاعدة البيانات، وبيانات ampacheuserالاعتماد التي أنشأتها سابقًا. استخدم هذا الحساب المخصص بدلًا من حساب MariaDB الرئيسي. حدد نوع التثبيت القياسي. إذا كنت ترغب في أن يقوم Ampache بتحويل ترميز الصوت، فاختر FFmpeg من خيارات تحويل الترميز؛ وإلا فاترك تحويل الترميز معطلًا. حدد " إنشاء تكوين" لحفظ ملف التكوين.

7. أنشئ حساب مسؤول Ampache

أنشئ اسم مستخدم وكلمة مرور قويين لحساب مدير Ampache. هذا هو الحساب الذي ستستخدمه لإدارة الموسيقى والمستخدمين في Ampache؛ وهو منفصل عن حساب تسجيل دخولك إلى Ubuntu وحساب MariaDB. اسمح للمثبّت بتطبيق أي تحديثات لقاعدة البيانات، ثم سجّل الدخول.

8. أضف موسيقاك ككتالوج

اجعل مجلد الموسيقى قابلاً للقراءة بواسطة Apache. استخدم المسار الذي توجد فيه ملفاتك فعلياً؛ المثال يُنشئ دليل مكتبة جديداً:

sudo mkdir -p /srv/music
sudo chgrp -R www-data /srv/music
sudo chmod -R g+rX /srv/music

انسخ أو قم بتثبيت ملفاتك الصوتية هناك، ثم سجّل الدخول كمسؤول Ampache. افتح قائمة الإدارة واختر " إضافة كتالوج" . أدخل اسمًا مثل " كتالوج الموسيقى Music"، وحدد المسار الكامل إلى /srv/music"كتالوج الموسيقى المحلي"، واختر كتالوج موسيقى محليًا، ثم أضفه. قم بتحديث البرنامج لكي يتمكن Ampache من قراءة الملفات. يشرح دليل الكتالوج كيفية صيانة الكتالوج والأذونات.

تأمين الوصول عن بُعد والحفاظ على تحديث المكتبة

للوصول إلى خادم عبر الإنترنت، وجّه سجل نظام أسماء النطاقات (DNS) الخاص بنطاقك إلى الخادم، وقم بتهيئة بروتوكول HTTPS قبل مشاركة العنوان. يستخدم دليل أمباتشي لنظام أوبونتو برنامج Certbot مع أباتشي.

sudo apt install snapd
sudo snap install certbot --classic
sudo certbot --apache -d ampache.example.com

بعد تثبيت الشهادة، اضبط الإعدادات force_ssl = "true"بحيث /var/www/ampache/config/ampache.cfg.phpيُنشئ Ampache روابط HTTPS. في UFW، اسمح بمنفذ SSH الخاص بالخادم قبل تفعيل جدار الحماية، ثم اسمح بحركة مرور الويب على المنفذين 80 و443. أبقِ منفذ MariaDB رقم 3306 مغلقًا أمام الإنترنت العام. تجد قواعد UFW في وثائق جدار حماية Ubuntu .

إذا لم يعثر فحص الموسيقى على أي شيء، فتأكد من صحة مسار الكتالوج وأن www-dataالحساب لديه صلاحية قراءة الملفات والتنقل بين المجلدات. لتحديث الكتالوج بشكل دوري والمهام المجدولة الأخرى، قم بضبط مهام cron في Ampache .