Как создать музыкальный стрим на Icecast + MPD

панорама домашней аудиостудии с компьютером и микшером

О чём эта инструкция

Цель: показать минимальный практический путь от нуля до работающего онлайн-радио на Linux с MPD + Icecast и веб-интерфейсом Pitchfork. Поддерживаемые дистрибутивы: Ubuntu и Fedora (команды приведены для обеих). Пример предназначен для простой настройки; я описываю и планы по повышению безопасности, отладки и проверки работоспособности.

Ключевые понятия (в одну строку):

MPD — демон музыкального проигрывания: управляет библиотекой и выводом аудио.
Icecast — сервер, принимающий аудиопоток от источникa (MPD) и отдающий слушателям.
Pitchfork — веб-интерфейс для управления MPD через браузер.

Important: если вы планируете публичное вещание — настройте пароли, брандмауэр и TLS.

Что понадобится перед началом

Сервер или рабочая станция с Linux (Ubuntu или Fedora). Для Ubuntu используйте sudo. Для Fedora временно переключитесь на root через su -.
Доступ администратора (root/sudo).
Папки для музыки и права доступа к ним.
Открытые порты в фаерволе (обычно 8000 или 8000 и 8001 по конфигурации).

Шаг 1 — Установка и базовая настройка MPD

Установите mpd:

Fedora (выполнить как root):

yum install mpd

Ubuntu (с sudo):

sudo apt-get install mpd

Затем откройте файл конфигурации MPD: /etc/mpd.conf. Используйте ваш любимый текстовый редактор (nano, vim).

Внесите минимальные правки: укажите директории, пользователя и адрес прослушивания. В начале найдите строки и замените USER на ваше имя пользователя (или создайте отдельного пользователя для mpd/icecast):

music_directory "/home/USER/music"
playlist_directory "/home/USER/music/playlists"
db_file "/home/USER/.mpd/mpd.db"
log_file "/home/USER/.mpd/mpd.log"
error_file "/home/USER/.mpd/mpd.error"

Затем укажите пользователя для демона:

user "USER"

Убедитесь, что MPD слушает только на localhost (по умолчанию):

bind_to_address "127.0.0.1"
port "6600"

Добавьте или отредактируйте секцию audio_output, чтобы MPD мог отправлять поток в Icecast. Пример типичной группы audio_output (в Fedora это может быть третья группа по умолчанию):

audio_output {
    type "shout"
    name "Stream short description"
    host "localhost"
    port "8000"
    mount "/mpd.ogg"
    password "hackme"
    quality "5.0"
    # bitrate "128"
    format "44100:16:2"
    # user "source" # optional
    # description "My Stream Description" # optional
    # genre "jazz" # optional
    # public "no" # optional
}

Примечания по параметрам:

host/port — адрес и порт для Icecast (локально: localhost:8000).
mount — имя mount point (точки монтирования) на Icecast, к которому будут подключаться слушатели.
password — пароль «source» для подключения к Icecast; смените на сложный пароль при публикации.
quality / bitrate / format — формат и качество; для Ogg Vorbis используются quality (0.0–10.0); для MP3 используется bitrate.

Сохраните файл. Потом создайте нужные каталоги в своём домашнем каталоге (выйдите из root, если вы были в root):

cd $HOME
mkdir -p music/playlists
mkdir .mpd

Это создаст папки для музыки, плейлистов и файл базы MPD.

Шаг 2 — Установка Icecast

пульт вещания и экран с графиками звука

Установите Icecast:

Fedora (root):

yum install icecast

Ubuntu (sudo):

sudo apt-get install icecast

Файл конфигурации сервера находится в /etc/icecast.xml. Если вы не меняли пароль в mpd (оставили “hackme”), то Icecast из коробки будет принимать поток. Если вы изменяли пароль или хотите изменить порт/права, отредактируйте /etc/icecast.xml и замените соответствующие значения (логин/пароль для source, порты, hostname, административные пароли).

Важно: при развертывании на публичном сервере замените все стандартные пароли и настройте лимиты слушателей в icecast.xml.

Шаг 3 — Установка Pitchfork (веб-интерфейс для MPD)

Pitchfork — удобный веб-интерфейс для управления библиотекой MPD и плейлистами.

Установите стек для веб-интерфейса:

Fedora:

yum install httpd mysql-server php php-mysql php-gd php-pear

Ubuntu:

sudo apt-get install apache2 mysql-server libapache2-mod-php5 php5 php5-mysql php5-gd php5-pear

Скачайте Pitchfork и распакуйте файлы в папку Apache: /var/www или /var/www/html (зависит от дистрибутива). Затем подправьте права:

chown -R apache:apache /var/www
OR
chown -R apache:apache /var/www/html
chmod -R 777 /var/www/config
OR
chmod -R 777 /var/www/html/config

Запустите сервисы (httpd/apache2, icecast, mpd):

Fedora:

service httpd start
service icecast start
service mpd start

Ubuntu:

sudo /etc/init.d/apache2 start
sudo /etc/init.d/icecast2 start
sudo /etc/init.d/mpd start

Теперь откройте браузер и перейдите на http://localhost/ (или IP сервера). Вы увидите Pitchfork.

Настройка Pitchfork для подключения к MPD

веб-интерфейс управления плейлистом

В разделе конфигурации укажите адрес и порт MPD (127.0.0.1:6600 по умолчанию). Поле «пароль» можно оставить пустым, если в mpd.conf не задана авторизация. Установите пароль доступа к самому Pitchfork, чтобы ограничить управление из веба.

После сохранения добавьте треки в библиотеку и создайте плейлист — MPD начнёт отправлять поток в Icecast.

подключение к стриму через браузер

Как подключиться к стриму

Если Icecast слушает порт 8000 и вы открыли его в фаерволе, откройте в браузере:

http://:8000

Нажмите ссылку M3U рядом с нужным mount point (например /mpd.ogg) — это откроет поток в вашем медиаплеере. Альтернативно можно напрямую открыть адрес потоковой точки, например:

http://:8000/mpd.ogg

иконка подключения к интернет-радио

Отладка — если треки не появляются или поток не стартует

Проверьте логи MPD: /home/USER/.mpd/mpd.log и /home/USER/.mpd/mpd.error.
Проверьте логи Icecast: /var/log/icecast/icecast.log (или путь из /etc/icecast.xml).
Убедитесь, что MPD успешно подключается к Icecast (совпадают host, port, mount, password).
Если в Pitchfork треки не отображаются — обновите библиотеку MPD вручную или перезагрузите MPD.
Если порт закрыт, откройте его в фаерволе (firewalld/ufw/iptables).

Примеры команд для проверки соединения (на сервере):

netstat -tulpn | grep 8000
ss -tulpn | grep 6600

Если MPD не подключается к Icecast, в конфигурации audio_output проверьте host и port и пароль “password” для source.

Безопасность и развёртывание в Интернет

Important: простая локальная конфигурация годится для тестов и работы внутри сети. Для публичного вещания выполните дополнительные шаги:

Замените пароли по умолчанию на сложные (admin и source в icecast.xml и mpd.conf).
Ограничьте доступ к административной панели Icecast (админ-пользователь и IP-ограничения).
Включите TLS/HTTPS через обратный прокси (nginx/Apache) и используйте Let’s Encrypt для сертификатов. Icecast сам по себе поддерживает TLS в новых версиях, но часто проще поставить nginx перед ним.
Ограничьте максимальное количество слушателей в icecast.xml, чтобы избежать DoS.
Настройте бэкап конфигураций и ротацию логов.

Практические советы по качеству звука и формату

Для наилучшей совместимости используйте Ogg Vorbis или MP3 в зависимости от целевой аудитории и лицензирования.
Для Ogg указывайте quality (0.0–10.0); 5.0 даёт сбалансированное качество/трафик.
Для MP3 используйте параметр bitrate (например 128) и убедитесь, что кодек установлен на сервере.

Критерии приёмки

MPD находится в статусе “active” и успешно воспроизводит локальный файл.
MPD подключается к Icecast: в логах Icecast виден источник с mount “/mpd.ogg”.
При обращении к http://:8000/mpd.ogg поток воспроизводится в медиаплеере.
Pitchfork подключается к MPD и позволяет добавлять треки в плейлист.

Роль — список задач (checklist)

Администратор сервера:

Установить mpd, icecast, apache/httpd.
Настроить права и владельцев директорий.
Настроить брандмауэр и SSL.

Оператор/диджей:

Загрузить треки в /home/USER/music.
Настроить плейлисты через Pitchfork.
Мониторить логи и метрики слушателей.

Слушатель:

Подключиться по ссылке M3U или напрямую к mount point.
При проблемах сообщить оператору IP и пример времени проблемы.

Тест-кейсы / приёмочные проверки

Откройте Pitchfork, добавьте трек, запустите плейлист — ожидаемый результат: трек начинает играть и появляется активный источник в Icecast.
Из внешней сети откройте http://:8000/mpd.ogg — ожидаемый результат: поток воспроизводится.
Попробуйте подключиться с неправильным паролем source — ожидаемый результат: подключение отклонено.

Быстрый план действий (мини-методология)

Установить mpd и icecast.
Настроить mpd.conf: пути, user, audio_output -> Icecast.
Создать папки музыки и права доступа.
Установить Pitchfork и веб-стек.
Запустить сервисы, проверить логи и подключиться.
Поменять пароли и настроить фаервол для публичного размещения.

Быстрая шпаргалка команд

Для проверки процесса MPD:

systemctl status mpd

Для перезапуска Icecast:

systemctl restart icecast

Для проверки открытых портов:

ss -tulpn | grep 8000

Примеры распространённых ошибок и как их решать

Ошибка: MPD не подключается к Icecast — проверьте параметры host/port/mount/password в секции audio_output.
Ошибка: Pitchfork не показывает треки — проверьте права папки /var/www/config и ownership.
Ошибка: поток виден, но звук отсутствует — проверьте формат (sample rate/bit depth) и кодеки на сервере.

Диаграмма принятия решения (когда публиковать в Интернет)

flowchart TD
  A[Нужен публичный стрим?] -->|Нет| B[Оставить локально]
  A -->|Да| C[Оценить требования безопасности]
  C --> D{Есть SSL и firewall?}
  D -->|Да| E[Развернуть публично, мониторить]
  D -->|Нет| F[Настроить SSL и firewall, изменить пароли]
  F --> C

Глоссарий (1 строка каждый)

Mount point — адрес потока на Icecast, например /mpd.ogg.
Source password — пароль, который отправитель (MPD) использует для подключения к Icecast.
Pitchfork — веб-интерфейс управления MPD.

Заключение

Icecast + MPD — простой и гибкий набор для организации собственного интернет-радио или внутреннего аудиовещания. Для домашней или закрытой сети достаточно базовой конфигурации, для публичного вещания требуется дополнительная безопасность: надежные пароли, SSL и брандмауэр. Экспериментируйте с форматами и качеством, и не забывайте мониторить логи и состояние сервисов.

Image Credit: Shutterstock

Если нужны: короткая версия объявления (100–200 слов) для публикации, шаблоны конфигураций или помощь в переводе конфигурации под конкретный дистрибутив — напишите, укажу точные команды и примеры.