Як встановити Ampache на Ubuntu

Ampache – це потужний веб-додаток для потокового відтворення аудіо, який дає змогу користувачам керувати своїми музичними колекціями та транслювати їх із будь-якого пристрою, оснащеного веб-браузером. Якщо ви хочете встановити Ampache на свій сервер Ubuntu 24.04, цей посібник проведе вас через усі етапи процесу, забезпечуючи плавне встановлення та налаштування. Від попередніх умов до порад щодо встановлення – ми розповімо про все, що потрібно знати, щоб запустити ваш сервіс потокового відтворення музики.

Необхідні умови для встановлення Ampache

Перш ніж приступити до процесу встановлення, необхідно переконатися, що ваша система відповідає всім необхідним вимогам. Ось що вам потрібно:

• Ubuntu 24.04 Server: Переконайтеся, що у вас встановлено чисту версію Ubuntu 24.04.
• Доступ до командного рядка: У вас повинен бути доступ до терміналу з привілеями sudo.
• Знання стека LAMP: Знання Linux, Apache, MySQL/MariaDB і PHP (у сукупності відомих як стек LAMP) буде корисним.

Крок 1: Встановлення стека LAMP

Першим кроком у налаштуванні Ampache є встановлення стека LAMP, який забезпечує необхідне серверне оточення для запуску веб-додатків.

Встановіть Apache

Apache – один із найпоширеніших веб-серверів у світі. Для його встановлення виконайте такі кроки:

sudo apt update && sudo apt install apache2

Після встановлення запустіть і увімкніть службу Apache, щоб вона працювала під час завантаження:

sudo systemctl start apache2
sudo systemctl enable apache2

Встановіть MySQL/MariaDB

Далі вам знадобиться система управління базами даних. MySQL або MariaDB чудово підійдуть для цієї мети. Ось як встановити MySQL:

sudo apt install mysql-server

Після встановлення захистіть налаштування MySQL, виконавши команду:

sudo mysql_secure_installation

Ця команда запропонує вам встановити пароль root і налаштувати параметри безпеки.

Встановлення PHP і необхідних розширень

Для оптимальної роботи Ampache потрібен PHP і кілька розширень. Встановіть PHP і необхідні модулі за допомогою такої команди:

sudo apt install php php-mysql libapache2-mod-php php-curl php-gd

Після встановлення ви можете перевірити версію PHP, виконавши команду:

php -v

Крок 2: Завантаження та встановлення Ampache

Коли стек LAMP готовий, настав час завантажити та встановити Ampache.

Завантажте Ampache

Ви можете завантажити останню версію Ampache прямо з GitHub за допомогою wget:

wget https://github.com/ampache/ampache/releases/download/7.0.1/ampache-7.0.1_all_php8.3.zip

Витяг і переміщення файлів Ampache

Після завантаження витягніть файли і перемістіть їх у каталог вашого веб-сервера:

unzip ampache-7.0.1_all_php8.3.zip
sudo mv ampache /var/www/html/

Налаштування Ampache

Наступний крок включає в себе налаштування Ampache для використання:

Встановіть дозволи: Налаштуйте дозволи, щоб Apache міг отримати доступ до файлів:

sudo chown -R www-data:www-data /var/www/html/ampache

Створіть файл конфігурації: скопіюйте приклад файлу конфігурації, наданий Ampache:

cd /var/www/html/ampache
sudo cp config/ampache.cfg.php.dist config/ampache.cfg.php

Редагування файлу конфігурації: Відкрийте файл конфігурації в текстовому редакторі (наприклад, nano або vim) і задайте параметри підключення до бази даних.

sudo nano config/ampache.cfg.php

Крок 3: Конфігурація бази даних для Ampache

Для зберігання даних Ampache потрібна спеціальна база даних. Ось як налаштувати її в MySQL/MariaDB:

mysql -u root -p
CREATE DATABASE ampache;
CREATE USER 'ampacheuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON ampache.* TO 'ampacheuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Цей скрипт створює нову базу даних з ім’ям «ampache» і користувача «ampacheuser» з повними привілеями для цієї бази даних.

Крок 4: Останні кроки зі встановлення

Тепер ваш сервер готовий до роботи з Ampache! Останні кроки включають в себе доступ до майстра установки через веб-браузер.

Доступ до майстра встановлення

Відкрийте веб-браузер і перейдіть за адресою:

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

Відкриється майстер встановлення Ampache, де ви зможете завершити процес встановлення, дотримуючись інструкцій на екрані.

Завершення встановлення через веб-інтерфейс

Майстер встановлення проведе вас через налаштування основних параметрів, таких як підключення до бази даних, створення користувача-адміністратора та інші. Уважно виконуйте кожен крок.

Усунення загальних проблем під час встановлення

Якщо ви зіткнулися з проблемами під час інсталяції або налаштування, скористайтеся цими загальними порадами щодо усунення неполадок:

Помилка: «403 Forbidden»:

– Зазвичай це вказує на проблеми з правами доступу. Переконайтеся, що Apache має права доступу до каталогу Ampache:

sudo chown -R www-data:www-data /var/www/html/ampache
sudo chmod -R 755 /var/www/html/ampache

Помилка: «500 Internal Server Error»:

– Перевірте журнали помилок Apache, щоб знайти конкретні повідомлення:

/var/log/apache2/error.log

Переконайтеся, що встановлено всі необхідні розширення PHP.

Помилка: Не вдалося встановити з’єднання з базою даних:

– Двічі перевірте облікові дані бази даних у файлі `config/ampache.cfg.php`.

– Переконайтеся, що MySQL запущено:

sudo systemctl status mysql

Помилка: Відсутні розширення PHP:

– Якщо під час встановлення з’явиться повідомлення про відсутність розширень, встановіть їх за допомогою:

sudo apt install php-xml php-mbstring php-zip php-json

Помилка: Проблеми з SSL-сертифікатом (під час використання HTTPS):

– Переконайтеся, що ваш SSL-сертифікат правильно встановлений і налаштований.

Кроки після встановлення Ampache

Встановлення Ampache завершено! Тим не менш, є додаткові кроки, які ви можете зробити для поліпшення роботи та безпеки.

Доступ до приладової панелі Ampache

Ви можете отримати доступ до своєї музичної бібліотеки, перейшовши за посиланням:

http://<your-server-ip>/ampache/login.php

Це приведе вас на сторінку входу, де ви можете ввести облікові дані адміністратора, створені під час налаштування.

Завантаження музики та налаштування параметрів

Ampache дозволяє завантажувати музичні файли безпосередньо через свій інтерфейс або вказувати йому на директорії з музичними файлами на вашому сервері.

• Створіть директорії в межах `/var/www/html/ampache` для організації музичних файлів.
• Ви також можете налаштувати додаткові параметри, як-от плейлисти, параметри потокового мовлення та права доступу користувачів з панелі керування.
• Документація, доступна на офіційному сайті Ampache, містить докладний посібник із розширених налаштувань.
• Якщо вас цікавить мобільний доступ або інтеграція з іншими сервісами, як-от Last.fm або Spotify, вивчіть доступні плагіни на панелі керування.
• Ampache також підтримує різні аудіоформати, зокрема MP3, Ogg Vorbis, FLAC та інші!
• Форуми спільноти – чудовий ресурс для усунення специфічних проблем або розширення функціональності за допомогою плагінів, створених спільнотою.
• Якщо вам потрібні додаткові заходи безпеки, розгляньте можливість впровадження правил брандмауера за допомогою UFW (Uncomplicated Firewall) або fail2ban для захисту від спроб несанкціонованого доступу.
• Ви також можете розглянути можливість встановлення SSL-сертифікатів за допомогою Let’s Encrypt для безпечних HTTPS-з’єднань.
• Це не тільки захистить ваші дані, а й підвищить довіру користувачів під час доступу до вашого потокового сервісу через публічні мережі.
• Якщо ви плануєте часто використовувати віддалений доступ, подумайте про налаштування динамічних служб DNS, якщо ваша IP-адреса часто змінюється.
• Це дасть змогу користувачам легко підключатися, не потребуючи постійного оновлення інформації про зміну IP-адреси!
• Якщо ви зацікавлені в подальшому підвищенні продуктивності, розгляньте такі рішення для кешування, як Redis або Memcached, які можуть значно прискорити доставку контенту!
• Ви також можете розглянути можливість інтеграції інших медіасерверів, таких як Icecast або Liquidsoap, якщо вам потрібні складніші потокові системи!
• Гнучкість Ampache дає йому змогу добре адаптуватися, незалежно від того, створюєте ви просту особисту бібліотеку чи повноцінний стрімінговий сервіс!
• Якщо ви хочете зробити свій внесок або дізнатися більше про аспекти розробки самого Ampache, зазирніть у їхній репозиторій на GitHub!
• Спільнота завжди вітає нових учасників, незалежно від того, чи цікавитеся ви розробкою коду або поліпшенням документації.

Вітаємо! Ви успішно встановили Ampache. Для отримання додаткової допомоги або корисної інформації ми рекомендуємо вам відвідати офіційний сайт Ampache.