Установка Ampache на Ubuntu 12.04 LTS

Краткое содержание

Что нужно подготовить перед началом
Создание папок для музыки и загрузок
Настройка шаринга через SWAT (SAMBA)
Загрузка, установка и первоначальная веб-конфигурация Ampache
Параметры конфигурации пользователя и пути логов
Рекомендации по безопасности, отладке и обслуживанию
Чек-листы по ролям и краткие сценарии отката

Цель и варианты запроса

Основная цель: установка и запуск Ampache на Ubuntu 12.04 LTS для стриминга собственной музыкальной коллекции. Похожие варианты запросов, которые покрывает статья:

установка Ampache на Ubuntu
настройка Ampache LAMP SAMBA
запуск стриминг-сервера на Ubuntu 12.04
Ampache конфигурация и безопасность

Требования (предварительные условия)

Для выполнения инструкции вам потребуется:

Компьютер с Ubuntu 12.04 LTS и установленным стеком LAMP (Linux, Apache, MySQL, PHP).
Собственный доменный или динамический адрес (необязательно, но нужен для внешнего доступа).
Проброшенный порт 80 на роутере (если вы хотите подключаться извне).
SAMBA/SWAT для сетевого шаринга файлов.

Ресурсы, которые автор использовал как отправные точки (оставлены как ссылки):

Примечание: в последней ссылке финальный шаг предлагает войти как «member of the admin group» — следуйте инструкции этой статьи и войдите в SWAT тогда, когда об этом будет сказано в разделе ниже.

Мини-методология установки

Подготовьте систему: LAMP + SAMBA/SWAT + проброс портов.
Создайте каталоги для музыки и загрузок, откройте доступ внутри локальной сети.
Разверните Ampache в директорию, доступную веб-серверу, запустите веб-инсталлятор.
Завершите конфигурацию в файле ampache.cfg.php, добавьте пути логов и временные директории.
Ужесточите права, назначьте владельца веб-сервера и ограничьте доступ извне по мере необходимости.

Создание директорий для медиа

Создайте папки для музыки и загрузок и дайте им достаточно строгие права доступа для удобства работы в локальной сети. Заменяйте на ваш реальный логин Ubuntu при чтении текста.

sudo mkdir ~/music
sudo chmod 777 ~/music
sudo mkdir ~/downloads
sudo chmod 777 ~/downloads

Комментарий: 777 делает папки максимально доступными. Для боевого сервера рекомендуется позже уменьшить права до 755/750 и назначить владельца, соответствующего веб-серверу или SAMBA-пользователю.

Настройка шаринга Windows-папок через SWAT

Откройте в браузере интерфейс SWAT (SAMBA Web Administration Tool):

http://:901

Войдите как root и используйте пароль root.

Нажмите Shares → Create Share.
Введите параметры (замените на ваш):

path: /home//music valid users: read only: no available: yes

Нажмите Commit Changes, затем Advanced и установите все маски в 0777.
Повторите процесс для папки /home//downloads.

После этого вы должны видеть сервер в локальной сети и иметь доступ к созданным шардам, если знаете пароль SAMBA.

Важно: такие настройки дают широкие права. После завершения развертывания сервера следует пересмотреть права и ограничить доступ, если нужен публичный или частично публичный доступ.

Установка Ampache

Загрузка и распаковка

В терминале (например, через PuTTY) перейдите в папку загрузок:

cd ~/downloads

Перейдите на страницу релизов Ampache и скопируйте ссылку на последний tar.gz, затем используйте wget.

Пример команды (вставьте актуальную ссылку вместо приведённой):

sudo wget https://github.com/ampache/ampache/archive/3.6-alpha6.tar.gz -O ampache.tar.gz

Распакуйте архив в удобную папку для исходников веб-сайтов:

sudo mkdir /usr/local/src/www
sudo chmod 7777 /usr/local/src/www
sudo tar zxvf ampache.tar.gz -C /usr/local/src/www

Запомните точное имя корневой папки после распаковки, например ampache-3.6-alpha6. Далее в инструкциях используйте это имя.

Для простоты тестирования временно ослабьте права на распакованную папку:

sudo chmod -R 7777 /usr/local/src/www/ampache-3.6-alpha6

После установки мы вернём права и назначим владельца веб-сервера.

Включите поддержку php-gd для масштабирования обложек альбомов и перезапустите Apache:

sudo apt-get install php5-gd
sudo /etc/init.d/apache2 restart

Создайте символическую ссылку из корня веб-сервера в распакованную папку, чтобы упростить перемещение сайта в будущем:

cd /var/www/
sudo ln -s /usr/local/src/www/ampache-3.6-alpha6 ampache

Первичная онлайн-конфигурация (веб-инсталлятор)

Откройте в браузере:

http:///ampache

Если все зависимости в порядке, веб-инсталлятор покажет зелёные OK-пометки для проверок окружения. Заполните поля следующим образом:

Desired Database Name — ampache
MySQL Hostname — localhost
(оставьте пустым, если есть соответствующее поле)
MySQL Administrative Username — root
MySQL Administrative Password — <пароль root MySQL>
отметьте “create database user for new database”
Ampache database username — <имя пользователя БД для Ampache, например ampache>
Ampache database User Password — <надёжный пароль для этой БД>
overwrite existing — оставьте unchecked
use existing database — оставьте unchecked

Почему не рекомендуется использовать ваш системный ubuntu-пользователь: эти учётные данные попадут в конфигурационный файл в открытом виде. Лучше создать отдельного пользователя базы данных.

Нажмите “insert database”. На следующем шаге заполните:

Web Path — /ampache
Database Name — ampache
MySQL Hostname — localhost
MySQL port (optional) — оставьте пустым
MySQL Username — или root
MySQL Password — <пароль>

Нажмите “write”. Красные слова станут зелёными OK.

Перейдите к шагу 3 и создайте пользователя-администратора Ampache:

Ampache admin username — <логин администратора Ampache>
Ampache admin password — <надёжный пароль>

Нажмите “update the database” и затем “return”. На главном экране Ampache войдите под созданным админом.

СОВЕТ: сохраните учётные данные в надёжном менеджере паролей.

Конфигурация Ampache — дополнительные шаги (локальная правка конфигурации)

Создайте папку для логов и временную папку для ZIP-архивов, которые генерируются при скачивании альбомов/плейлистов:

sudo mkdir /var/log/ampache
sudo chmod 7777 /var/log/ampache

sudo mkdir /ziptemp
sudo chmod 7777 /ziptemp

Откройте файл конфигурации Ampache:

sudo nano /usr/local/src/www/ampache-3.6-alpha6/config/ampache.cfg.php

Найдите и измените параметры (или добавьте при необходимости):

Сетевая доступность — разрешить доступ извне локальной сети:

require_localnet_session = "false"
access_control  = "true"

Разрешить скачивание ZIP-файлов:

allow_zip_download = "true"
file_zip_download = "true"
file_zip_path = "/ziptemp"
memory_limit = 128

Изменение изображений (обложек):

resize_images = "true"

Отладка и логирование:

debug = "true"
debug_level = 5
log_path = "/var/log/ampache"

Примечание: в боевой системе установите debug=false и уменьшите уровень логирования. Не храните долгосрочно логи с чувствительной информацией.

После завершения установки — ужесточение прав

Когда всё работает, выполните следующие команды, чтобы назначить владельца и ужесточить права:

sudo chown -R www-data:www-data /usr/local/src/www/ampache-3.6-alpha6
sudo find /usr/local/src/www/ampache-3.6-alpha6 -type d -exec chmod 755 {} \;
sudo find /usr/local/src/www/ampache-3.6-alpha6 -type f -exec chmod 644 {} \;

# Права на логи и временную папку (если требуется запись веб-пользователем)
sudo chown -R www-data:www-data /var/log/ampache
sudo chmod 750 /var/log/ampache
sudo chown -R www-data:www-data /ziptemp
sudo chmod 750 /ziptemp

Эти команды делают содержимое доступным веб-серверу, но ограничивают доступ для остальных пользователей сервера.

Безопасность и практики эксплуатации

Используйте отдельного пользователя базы данных для Ampache. Не применяйте root MySQL для повседневной работы.
Отключите режим отладки (debug = “false”) при переносе сервера в продуктив.
Если вам нужен внешний доступ, примените HTTPS (TLS). Установите сертификат от Let’s Encrypt или другого CA и пробросьте 443 порт.
Ограничьте доступ по IP в случаях, когда внешний доступ не нужен: на уровне роутера или Apache.
Для SAMBA: при публичном расшаривании по сети настройте возможные пароли и разрешения, чтобы минимизировать риск несанкционированного доступа.
Регулярно делайте резервные копии /usr/local/src/www/ampache/config/ampache.cfg.php и базы данных.

Отладка и журналирование (советы)

Проверяйте логи Apache: /var/log/apache2/error.log и access.log.
Проверяйте Ampache-логи в /var/log/ampache (если включены).
Если при подключении возникают ошибки базы данных — проверьте параметры в ampache.cfg.php и права пользователя БД.
Для проверки доступности портов используйте netstat или ss.

Чек-листы по ролям

Администратор (установка и поддержка):

Подготовить LAMP и SWAT
Создать каталоги ~/music и ~/downloads
Настроить шаринг SAMBA через SWAT
Скачать и распаковать Ampache
Пройти веб-инсталлятор и создать БД/пользователя
Настроить ampache.cfg.php (пути, логи, zip)
Ужесточить права и назначить владельца www-data
Настроить HTTPS и бэкапы

Пользователь (загрузка/копирование музыки):

Копировать файлы в /home//music по SAMBA
Проверить права доступа и метаданные файлов (теги)
Использовать веб-интерфейс Ampache для организации коллекции

Когда это не работает — распространённые проблемы и решения

Проблема: пустая страница или ошибка 500 при открытии /ampache

Проверьте права на файлы Ampache и владельца (должен быть www-data).
Временно включите отображение ошибок в PHP (в тестовой среде) и посмотрите /var/log/apache2/error.log.

Проблема: Ampache не подключается к MySQL

Проверьте, что MySQL запущен и доступен на localhost.
Убедитесь, что имя пользователя и пароль в веб-инсталляторе совпадают с теми, что в MySQL.
Попробуйте подключиться вручную: mysql -u -p -h localhost

Проблема: обложки не масштабируются

Установлен ли php5-gd? sudo apt-get install php5-gd
Перезапущен ли Apache после установки? sudo /etc/init.d/apache2 restart

Проблема: ZIP-скачивание не создаёт файлы

Проверьте права /ziptemp и владельца.
Убедитесь, что allow_zip_download и file_zip_download установлены в “true”.

Альтернативные подходы

Использовать контейнеры (Docker) для изоляции Ampache от основной системы и упрощения миграции на новую версию Ubuntu.
Применять веб-сервер Nginx вместо Apache; тогда потребуется скорректировать конфигурацию и права.
В качестве альтернативы Ampache можно рассмотреть Subsonic-подобные решения, но Ampache остаётся популярным за счёт гибкости и opensource-подхода.

Критерии приёмки (проверка работоспособности)

Веб-интерфейс Ampache доступен по адресу http:///ampache.
Администратор может войти в систему под созданной учётной записью.
Ampache успешно подключился к базе данных и создал необходимые таблицы.
Музыкальные файлы доступны через SAMBA-шару и могут быть добавлены в библиотеку Ampache.
Стриминг трека в пределах локальной сети работает корректно.

Короткое объявление (для рассылки, 100–200 слов)

Установил Ampache на домашний сервер под Ubuntu 12.04 LTS: удобный стриминг личной музыкальной коллекции в локальной сети и удалённо (при пробросе портов). В статье пошагово описана подготовка системы (LAMP, SAMBA/SWAT), создание каталогов, распаковка и веб-конфигурация Ampache, правки в конфиге, настройка логов и zip-скачиваний, а также рекомендации по безопасности и отладке. Приведены чек-листы для администратора и для обычных пользователей, а также советы по ужесточению прав и резервному копированию. Подробная инструкция позволит развернуть рабочий медиасервер и поддерживать его в безопасности.

Короткий глоссарий (одна строка на термин)

LAMP — набор серверных компонентов: Linux, Apache, MySQL, PHP.
SWAT — веб-интерфейс для администрирования SAMBA.
SAMBA — служба SMB/CIFS для шаринга файлов в сети.
Ampache — веб-приложение для каталогизации и стриминга аудио.

Социальный предпросмотр (предложение)

OG title: Установка Ampache на Ubuntu 12.04 LTS OG description: Пошаговая инструкция по развёртыванию Ampache: LAMP, SAMBA/SWAT, веб-инсталляция и рекомендации по безопасности.

Итог

Ampache можно установить вручную и быстро привести в рабочее состояние на Ubuntu 12.04 LTS.
Главное — подготовить LAMP, SAMBA, папки для музыки и корректно пройти веб-инсталлятор.
После успешного запуска уделите время безопасности: отдельный пользователь БД, HTTPS, резервные копии и корректные права.

Важно: при переносе сервера на публичный хостинг или при желании открыть доступ извне обязательно настройте TLS и продумайте политику доступа к вашему контенту.