SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor · Обновлено 2026-10-28

Как создать свой музыкальный стриминг на VPS

Руководство по запуску Navidrome на VPS для доступа к личной медиатеке. Вы узнаете о настройке TLS, выборе Subsonic клиентов, расчете хранилища и организации резервных копий.

Преимущества self-hosted стриминга музыки на VPS

Self-hosted стриминг музыки на VPS означает, что вы самостоятельно запускаете плеер и предоставляете контент. Сервер хранит файлы, которыми вы уже владеете, а любой телефон может получить к ним доступ через интернет с помощью стандартной авторизации. Будьте честны с собой относительно ограничений перед началом: это замена плеера стримингового сервиса, а не его каталога. В вашей библиотеке не появится ничего нового, пока вы не купите или не оцифруете запись и не скопируете файл на сервер.

Аудио гораздо менее требовательно к серверу, чем видео. Файлы имеют небольшой размер, телефоны декодируют все распространенные форматы без дополнительной помощи, а один слушатель потребляет меньше трафика, чем видеозвонок. Нагрузка на CPU здесь минимальна. Основным ограничением является дисковое пространство. Еще два фактора, определяющих работоспособность системы — качество ваших тегов и возможность мобильного приложения скачивать музыку для офлайн-прослушивания.

Navidrome — это выбор по умолчанию, если вас интересует только аудио. Это один бинарный файл на языке Go в одном контейнере, который хранит состояние в единственной базе данных SQLite. Он поддерживает API Subsonic, благодаря чему существует большое семейство сторонних мобильных приложений. Версия 0.64.2, выпущенная 24 сентября 2026 года, оставалась актуальным релизом на 27 октября 2026 года. Не используйте версии старше 0.64.1, в которой были устранены пять уязвимостей, включая возможность неограниченного подбора пароля при входе в Subsonic. Проект позиционируется как решение, хорошо работающее на оборудовании с ограниченными ресурсами, например, на Raspberry Pi, поэтому серверное ПО не является тем, за что вы будете платить.

Jellyfin стоит использовать, если вы уже используете Jellyfin как медиасервер на VPS для видео. Его музыкальная библиотека работает, а Finamp — это бесплатное музыкальное приложение Jellyfin для Android и iOS, позволяющее загружать треки для прослушивания офлайн. В самом Jellyfin до сих пор нет встроенной конечной точки Subsonic, но её добавляет сторонний плагин. Subfin-NG, форк плагина Subfin, «позволяет музыкальным приложениям с поддержкой Subsonic воспроизводить вашу музыкальную библиотеку Jellyfin», добавляя API OpenSubsonic в Jellyfin. Для этого требуется Jellyfin версии 12.0 или новее — это минимальное требование, установленное релизом v12.1.13.0 от 16 октября 2026 года, когда была добавлена поддержка Jellyfin 12.0. Проект быстро развивается: как минимум семь релизов вышло в период с 24 по 28 сентября 2026 года. Таким образом, приложения Subsonic могут подключаться к Jellyfin через сторонний плагин, а не через базовую функциональность, поэтому стоит протестировать выбранный клиент перед тем, как полагаться на него. Мост работает и в обратную сторону: в Navidrome 0.64.0 был добавлен экспериментальный API Jellyfin, который по умолчанию выключен и активируется с помощью ND_JELLYFIN_ENABLED; согласно документации, он протестирован с Finamp, Jellify и Feishin.

Funkwhale — это вариант с поддержкой федерации, версия 2.0 которого была выпущена в марте 2026 года. Сервер Funkwhale называется «под» (pod), поды объединяются в федерацию через протокол ActivityPub (тот же, что используется в Mastodon), и пользователи могут подписываться на плейлисты друг друга между подами. В версии 2.0 старые библиотеки были заменены на плейлисты, превратив подписки на библиотеки в подписки на плейлисты, при этом под версии 2.0 не объединяется в федерацию с подами, работающими на версии 1.x. Он также частично поддерживает API Subsonic, но есть важное отличие: каждый пользователь устанавливает отдельный пароль Subsonic в своих настройках, так как протокол Subsonic требует пароль, который сервер может прочитать. Установка Funkwhale более ресурсоемкая, так как помимо веб-приложения требуются PostgreSQL и очередь задач.

Выбирайте Navidrome, если вам не нужна федерация и если у вас еще не запущен Jellyfin. В остальной части этого руководства рассматривается настройка Navidrome с помощью Docker.

Почему API Subsonic определяет выбор мобильного приложения

Subsonic был музыкальным сервером, чей HTTP API стал общим языком для self-hosted аудио, а OpenSubsonic — это общественный проект, который продолжает его развивать. Эта история объясняет, почему у вас есть выбор приложений для телефона. Navidrome не поставляет собственного мобильного приложения и не нуждается в нём, так как любой Subsonic-клиент авторизуется с помощью адреса сервера и данных вашей учётной записи.

Это наиболее важно для офлайн-синхронизации — функции, которая определяет, будет ли система пригодна для ежедневного использования. Телефон в туннеле не может связаться с вашим сервером, поэтому клиент должен заранее скопировать файлы в локальное хранилище. Все клиенты поддерживают потоковое воспроизведение. Только некоторые умеют скачивать файлы. Список клиентов на navidrome.org/apps указывает, какие из них поддерживают эту функцию, и выбор на обеих платформах широк: Substreamer и Ultrasonic на Android, Amperfy и play:Sub на iOS. Многие из наиболее функциональных клиентов являются платными, а Symfonium на Android — это приложение, которое пользователи называют чаще всего. Установите два разных клиента перед тем, как сделать окончательный выбор, так как именно с этой частью системы вы будете взаимодействовать каждый день.

Сколько дискового пространства требуется для музыкальной библиотеки?

ГрафикStorage per 1,000 albums by audio format
Данные, на которых построен график
[
  {
    "label": "Opus 128k",
    "kbps": 128,
    "gb_per_1000_albums": 43
  },
  {
    "label": "MP3 320k",
    "kbps": 320,
    "gb_per_1000_albums": 108
  },
  {
    "label": "FLAC 16/44.1",
    "kbps": 900,
    "gb_per_1000_albums": 304
  },
  {
    "label": "FLAC 24/96",
    "kbps": "3,000",
    "gb_per_1000_albums": "1,013"
  }
]

Эти показатели порядка величин получены на основе битрейта, а не путем замеров реальной коллекции, при этом расчеты достаточно просты для проверки на ваших собственных файлах. Примите длительность альбома за 45 минут, что составляет 2,700 секунд. Умножьте битрейт в килобитах в секунду на 2,700, затем разделите на 8,000, чтобы получить мегабайты. При 320 kbps это дает 108 МБ на один альбом, поэтому тысяча альбомов займет около 108 ГБ.

Использование форматов без потерь меняет ответ. FLAC с качеством CD в среднем имеет битрейт около 900 kbps на обычном материале, поэтому для той же тысячи альбомов потребуется около 304 ГБ. Библиотека в формате 24 bit, 96 kHz потребует примерно 1,013 ГБ — целый терабайт для коллекции, список которой можно уместить на листе бумаги. Копия в формате Opus, оптимизированная для телефона, с битрейтом 128 kbps позволяет уместить ту же тысячу альбомов в 43 ГБ. Запустите du -sh /path/to/music для уже имеющейся у вас библиотеки, так как ваш собственный средний битрейт — это единственное число, которое имеет значение при выборе тарифного плана.

Пропускная способность — это меньшая часть расходов. Поток 320 kbps составляет 40 килобайт в секунду, поэтому час прослушивания передает около 144 МБ. Сто часов в месяц — это около 14 ГБ, что не заметно для лимитов трафика любого VPS. Исключением является первая офлайн-синхронизация телефона, которая может потребовать передачи десятков гигабайт за один вечер.

Уровень хранения или уровень вычислений?

Музыкальный сервер — это большой объем «холодных» данных, практически не требующий вычислительных мощностей. Чтение файла со скоростью 40 килобайт в секунду не нагружает диск, а процессор выполняет реальную работу только во время сканирования библиотеки, транскодирования (которое вам вряд ли понадобится) или извлечения и кэширования обложек альбомов (при сканировании или первом открытии элемента). Поэтому быстрый NVMe на вычислительном тарифе здесь не дает преимуществ, а его цена за гигабайт — это именно то, что мешает загрузить FLAC-копии. В этом случае storage VPS лучше обычного VPS, так как стоимость таких тарифов рассчитывается за терабайт, а не за ядро.

Требования к памяти скромные. Navidrome обслуживает личную библиотеку, потребляя несколько сотен мегабайт, причем пиковая нагрузка приходится на сканирование, а не на воспроизведение. Выделите серверу 1 GB или 2 GB RAM, а остаток бюджета потратьте на дисковое пространство.

Сначала создайте директории, владельцем которых должен быть пользователь, от имени которого будет запущен контейнер. Если вы новичок в Compose, в Docker Compose на VPS описаны предположения, на которых строится этот файл.

sudo install -d -m 755 -o 1000 -g 1000 /srv/navidrome /srv/music

Создайте файл docker-compose.yml в отдельной директории:

services:
  navidrome:
    image: deluan/navidrome:0.64.2
    user: "1000:1000"
    ports:
      - "127.0.0.1:4533:4533"
    restart: unless-stopped
    environment:
      ND_LOGLEVEL: "info"
      ND_SESSIONTIMEOUT: "24h"
      ND_SCANNER_SCHEDULE: "@every 24h"
      ND_BACKUP_PATH: "/data/backup"
      ND_BACKUP_SCHEDULE: "0 4 * * *"
      ND_BACKUP_COUNT: "7"
    volumes:
      - /srv/navidrome:/data
      - /srv/music:/music:ro
docker compose up -d
docker compose ps

Команда docker compose ps должна показать, что сервис работает, а не находится в состоянии перезапуска. Если контейнер постоянно перезапускается, это почти всегда связано с правами доступа к /srv/navidrome, а в docker compose logs navidrome указано имя файла, в который не удалось записать данные.

Стоит пояснить четыре детали в этом файле. Порт опубликован только на 127.0.0.1, поэтому сервер доступен через обратный прокси, а не через порт 4533 из открытого интернета: Docker самостоятельно управляет правилами брандмауэра, поэтому обычный 4533:4533 останется открытым даже на сервере, где ufw сообщает, что всё запрещено. Том с музыкой подключен только для чтения, что гарантирует: ошибка сканера не приведёт к удалению вашей единственной копии. Параметр ND_SCANNER_SCHEDULE по умолчанию отключен, а в руководствах, написанных до Navidrome 0.55, он называется ND_SCANSCHEDULE — это старое имя, которое было изменено в версии 0.55. Три настройки резервного копирования активируют встроенную функцию бэкапа базы данных, на которую опирается раздел резервного копирования ниже.

Перенос музыкальной библиотеки на сервер

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

rsync -av --info=progress2 ~/Music/ user@music.example.com:/srv/music/

Наличие косой черты в конце пути источника имеет значение. Без неё вы получите /srv/music/Music. После завершения копирования исправьте владельца файлов:

sudo chown -R 1000:1000 /srv/music
id -u

Контейнер работает от имени пользователя с идентификатором 1000, а точка монтирования доступна только для чтения. Поэтому этот идентификатор должен иметь права на чтение всех файлов и доступ к содержимому всех каталогов. Если после копирования владельцем файлов является другая учетная запись с ограничениями доступа, сканер не обнаружит ни одного трека, веб-интерфейс останется пустым, а в логах появится open /music: permission denied. Команда chown выше — один из способов решения. Если папку используют и другие программы, документация Navidrome для Docker рекомендует открыть её для чтения без изменения владельца: sudo chmod -R a+rX /srv/music. Команда id -u выводит ваш текущий идентификатор пользователя, а в принципах работы PUID и PGID в контейнерах Docker приведено подробное описание механизма маппинга.

Обратный прокси и TLS для доступа с телефона из любого места

Направьте DNS A-запись на ваш VPS, а затем добавьте в Caddy три строки:

music.example.com {
    reverse_proxy 127.0.0.1:4533
}
sudo systemctl reload caddy

Caddy запрашивает сертификат в фоновом режиме сразу после загрузки сайта, не дожидаясь посетителей. Порт 443 должен быть открыт. Caddy по умолчанию использует два метода проверки ACME (automatic certificate management environment): HTTP-челлендж на порту 80 и TLS-ALPN-челлендж на порту 443, выбирая один из них случайным образом. В случае ошибки он делает одну повторную попытку, а затем переключается на другой метод, поэтому закрытый порт 80 не помешает получению сертификата. Тем не менее, оставьте порт 80 открытым, так как Caddy использует его для автоматического перенаправления с HTTP на HTTPS. В nginx добавьте proxy_buffering off; в блок location: Navidrome отправляет события о прогрессе в веб-интерфейс через одно долгоживущее соединение, и при включенной буферизации интерфейс будет ожидать ответа, который nginx удерживает у себя. Если вы обслуживаете сервис по пути, например /music, а не на отдельном поддомене, установите ND_BASEURL на тот же путь, иначе интерфейс загрузится как пустая страница. Сравнение трех популярных прокси приведено в Nginx, Caddy и Traefik на VPS.

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

SALT=$(openssl rand -hex 6)
TOKEN=$(printf '%s%s' 'YOUR_PASSWORD' "$SALT" | md5sum | cut -d' ' -f1)
curl -s "https://music.example.com/rest/ping.view?u=YOUR_USER&t=$TOKEN&s=$SALT&v=1.16.1&c=curl&f=json"

Корректный ответ начинается с {"subsonic-response":{"status":"ok" и указывает navidrome в качестве типа сервера. Тело ответа, содержащее "status":"failed" и код ошибки 40, означает, что прокси работает нормально, а учетные данные неверны. Ошибку сертификата на этом этапе нужно устранить в первую очередь, так как большинство мобильных клиентов отклоняют некорректный сертификат, выдавая пользователю неинформативное сообщение.

Почему ваша медиатека выглядит некорректно после первого сканирования

Navidrome выполняет навигацию по тегам, а не по папкам, поэтому именно теги определяют структуру отображения. Трек без тега album artist будет отнесен к исполнителю трека (track artist). Именно поэтому сборник, где у каждого трека указан свой исполнитель, превращается в двадцать альбомов по одному треку в каждом. Исправляйте это в самих файлах, а не в Navidrome: MusicBrainz Picard и beets позволяют найти альбом в базе данных MusicBrainz и записать стандартные теги обратно в файлы.

Navidrome также разделяет теги с несколькими исполнителями на отдельных артистов. В результате название группы, содержащее разделитель, ошибочно разбивается на части; AC/DC — это пример, с которым сталкиваются все. В ND_SCANNER_ARTISTSPLITEXCEPTIONS указываются имена, которые не должны разделяться ни при каких обстоятельствах.

Новые файлы обнаруживаются механизмом отслеживания изменений через несколько секунд после их появления. Этот механизм зависит от уведомлений ядра, которые не приходят для файлов, записанных на сетевом ресурсе, смонтированном с другой машины. Поэтому в такой конфигурации именно периодический ND_SCANNER_SCHEDULE поддерживает актуальность медиатеки. Полное повторное сканирование считывает теги каждого файла, что работает медленно на больших медиатеках, и это одна из причин, почему базу данных ниже стоит защищать.

Пользователи, плейлисты и общий доступ

Администратор создает остальные учетные записи через веб-интерфейс, самостоятельная регистрация отсутствует. У каждого пользователя свои счетчики прослушиваний, плейлисты, избранное и оценки, поэтому профили предпочтений членов семьи не смешиваются.

Плейлисты могут поступать из двух источников. Плейлист, созданный в клиенте, хранится в базе данных. Файл .m3u, помещенный в папку библиотеки, импортируется во время сканирования; это простой способ переноса плейлистов из десктопного плеера. Смарт-плейлисты — это файлы .nsp, небольшие JSON-файлы с правилами, которые импортируются аналогичным образом и обновляются автоматически при изменении библиотеки.

Общий доступ включен по умолчанию начиная с версии 0.63.0, выпущенной в июле 2026 года. Он позволяет пользователю создать публичную ссылку на альбом, которую может открыть любой человек без авторизации. Если на сервере хранится вся ваша библиотека, это может быть нежелательно; установка ND_ENABLESHARING в значение false отключает данную функцию.

Резервное копирование базы данных отдельно от музыкальных файлов

Собственный механизм резервного копирования Navidrome охватывает только базу данных. Документация прямо указывает на это: процесс резервного копирования сохраняет базу данных, включая пользователей, статистику прослушиваний и прочие данные, но не затрагивает музыкальные файлы или конфигурацию. Такое разделение оправдано, так как эти два компонента требуют разных подходов к восстановлению. Музыкальные файлы можно скопировать повторно с диска, с которого они были оцифрованы. Статистика прослушиваний, оценки, избранное и плейлисты не существуют больше нигде, и повторное сканирование библиотеки их не восстановит.

Файл compose уже настроен на создание ежедневной копии в /data/backup с хранением семи последних версий. Перед обновлением создайте копию вручную:

sudo docker compose run --rm navidrome backup create

Переход с версии 0.63 на 0.64 — это обновление, которое требует особого внимания. В версии 0.64.0 происходит перекодирование всех внутренних идентификаторов в рамках миграции, затрагивающей каждую таблицу, поэтому клиентам, использующим офлайн-загрузки, может потребоваться повторная синхронизация.

Восстановление подразумевает удаление текущей базы данных и копирование резервной копии на её место; эта процедура должна выполняться только при остановленном Navidrome. Восстановление на работающем сервере небезопасно.

Поскольку эти файлы хранятся на том же VPS, они не уцелеют при выходе сервера из строя. Настройте регулярную отправку /srv/navidrome на другую машину или в объектное хранилище — это задача, для которой предназначены restic и BorgBackup. Весь каталог занимает мало места, обычно значительно меньше гигабайта, поэтому ежедневная зашифрованная копия вне сервера практически не требует затрат и позволяет восстановить всё то, что невозможно вернуть при обычном сканировании.

FAQ

Нужно ли перекодировать музыку на VPS?

Почти никогда. Телефоны самостоятельно декодируют MP3, AAC, Opus и FLAC, как и современные браузеры в большинстве систем, поэтому сервер отправляет файл «как есть» и почти не тратит ресурсы процессора. Проверять нужно именно браузеры: Firefox воспроизводит AAC только в том случае, если операционная система или внешняя библиотека предоставляют декодер, поэтому для AAC-библиотеки в веб-плеере может потребоваться транскодированный поток. Случай, когда это действительно стоит включить — прослушивание FLAC-библиотеки через мобильный интернет, где преобразование из примерно 900 кбит/с в Opus с битрейтом 128 кбит/с сокращает объем передаваемых данных примерно в семь раз. Navidrome управляет транскодированием на сервере начиная с версии 0.61: он определяет кодеки, поддерживаемые клиентом, применяет настройки битрейта по умолчанию в зависимости от формата и позволяет ограничить битрейт для каждого плеера.

Почему мое мобильное приложение не может скачать музыку для прослушивания офлайн?

Потому что офлайн-хранилище — это функция клиента, а не сервера. API Subsonic позволяет любому клиенту получить файл целиком, но именно приложение решает, сохранять ли его копию на телефоне. Проверьте список клиентов на navidrome.org/apps и выберите тот, в описании которого упоминаются офлайн-загрузки или кэширование. Некоторые клиенты кэшируют только то, что вы уже прослушали, что не равносильно синхронизации альбома перед поездкой.

Почему после сканирования один альбом разделился на несколько?

Отсутствует тег album artist или он различается у разных треков. Navidrome группирует музыку по тегам, а не по папкам, поэтому двенадцать треков с двенадцатью разными значениями artist и отсутствующим общим значением album artist выглядят как двенадцать разных альбомов. Установите тег album artist для каждого трека в альбоме (для сборников обычно используется значение Various Artists), а затем запустите повторное сканирование. Программы MusicBrainz Picard или beets позволяют сделать это для всей папки сразу.

Заменяет ли self-hosted стриминг музыки Spotify?

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

Была ли эта статья полезной?

#navidrome#music#streaming#self-hosting#media-server