Як запустити Navidrome на власному VPS
Запустіть Navidrome на VPS і слухайте власну музику з телефона: розрахунок сховища, Subsonic-клієнти, offline-синхронізація, TLS і резервні копії.
Що дає self-hosted потокове відтворення музики на VPS
Self-hosted потокове відтворення музики на VPS означає, що ви самі запускаєте програвач і надаєте музику. Сервер зберігає файли, якими ви вже володієте, а будь-який телефон може підключитися до нього через інтернет за звичайними обліковими даними. Перед початком врахуйте компроміс: це заміна програвача потокового сервісу, а не його каталогу. У бібліотеці не з’явиться нічого нового, доки ви не придбаєте музику або не видобудете її з носія та не скопіюєте файл на сервер.
Аудіо значно менше навантажує сервер, ніж відео. Файли невеликі, телефони без додаткової обробки декодують усі поширені формати, а один слухач використовує менше пропускної здатності, ніж відеодзвінок. CPU тут не є проблемою. Реальне обмеження — дисковий простір. Ще два чинники, від яких залежить результат, — якість ваших тегів і можливість завантажувати музику для offline-використання в застосунку на телефоні.
Який музичний сервер: Navidrome, Jellyfin чи Funkwhale?
Navidrome — стандартний вибір, якщо вас цікавить лише аудіо. Це один Go-бінарник в одному контейнері, який зберігає стан в одній базі даних SQLite. Він підтримує Subsonic API, тому для нього існує велика кількість сторонніх мобільних застосунків. Версія 0.64.2, випущена 24 September 2026, залишалася поточною версією станом на 2026-10-27. Не запускайте версії, старші за 0.64.1: у ній виправлено п’ять security advisories, зокрема необмежене підбирання паролів для входу через Subsonic. Проєкт заявляє, що добре працює на обладнанні з обмеженими ресурсами, наприклад Raspberry Pi, тому саме серверне програмне забезпечення не буде основною статтею витрат.
Jellyfin варто використовувати, якщо ви вже запускаєте Jellyfin як медіасервер на VPS для відео. Його музична бібліотека працює, а Finamp — безплатний музичний застосунок Jellyfin для Android та iOS, який завантажує треки для прослуховування офлайн. Сам Jellyfin досі не має вбудованої кінцевої точки Subsonic, але сторонній плагін додає її. Subfin-NG, форк плагіна Subfin, «дає змогу сумісним із Subsonic музичним застосункам відтворювати вашу музичну бібліотеку Jellyfin», додаючи до Jellyfin OpenSubsonic API. Для нього потрібен Jellyfin 12.0 або новіший; цю мінімальну вимогу встановила версія v12.1.13.0 16 October 2026, коли додала підтримку Jellyfin 12.0. Плагін також швидко змінюється: між 24 та 28 September 2026 вийшло щонайменше сім версій. Отже, Subsonic-застосунки також можуть підключатися до Jellyfin через сторонній плагін, а не через функцію ядра. Перед використанням варто перевірити вибраний клієнт. Міст працює і в іншому напрямку: Navidrome 0.64.0 додав експериментальний Jellyfin API, вимкнений за замовчуванням і вмикнений за допомогою ND_JELLYFIN_ENABLED. У документації зазначено, що його перевірено з Finamp, Jellify та Feishin.
Funkwhale — федеративний варіант; версію 2.0 випущено в March 2026. Сервер Funkwhale називається pod, pod-и федеративно взаємодіють через ActivityPub (протокол, на якому працює Mastodon), а користувачі стежать за плейлистами одне одного між pod-ами. Версія 2.0 замінила старі libraries на плейлисти, перетворивши підписки на libraries на підписки на плейлисти. Pod версії 2.0 не федеративно взаємодіє з pod-ами, на яких досі працює 1.x. Він також підтримує частину Subsonic API, але є важлива відмінність: кожен користувач задає окремий пароль 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. Деякі з найкращих клієнтів є платними застосунками, а серед Android-застосунків найчастіше згадують Symfonium. Перш ніж зробити вибір, встановіть два клієнти, оскільки саме з цією частиною системи ви взаємоджатимете щодня.
Скільки місця потрібно для музичної бібліотеки?
Дані, на яких побудовано графік
[
{
"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 MB, тому тисяча альбомів — приблизно 108 GB.
Lossless змінює результат. FLAC у якості CD для звичайного матеріалу має середній бітрейт близько 900 kbps, тому для тієї самої тисячі альбомів потрібно приблизно 304 GB. Бібліотека у форматі 24 bit, 96 kHz займатиме близько 1,013 GB — повний терабайт для колекції, яку можна було б перелічити на папері. Копія в Opus, оптимізована для телефона, за бітрейту 128 kbps вміщує ту саму тисячу альбомів у 43 GB. Запустіть du -sh /path/to/music для вже наявної бібліотеки, оскільки під час вибору тарифу має значення лише її середній бітрейт.
Пропускна здатність — менша частина загальних витрат. Потік із бітрейтом 320 kbps передає 40 кілобайтів за секунду, тому година прослуховування споживає близько 144 MB. Сто годин на місяць — це приблизно 14 GB, що зазвичай непомітно для ліміту трафіку VPS. Винятком є перша офлайн-синхронізація телефона: за один вечір вона може передати десятки гігабайтів.
Рівень зберігання чи обчислювальний рівень?
Музичний сервер — це великий обсяг неактивних даних, для обробки яких майже не потрібні обчислювальні ресурси. Читання файлу зі швидкістю 40 кілобайтів за секунду залишає будь-який диск майже без навантаження, а CPU справді потрібен лише під час сканування медіатеки, транскодування, яким ви здебільшого не займатиметеся, а також вилучення й кешування обкладинок під час сканування або під час першого відкриття елемента. Тому швидкий NVMe у compute plan тут нічого не дає, а саме ціна за гігабайт заважає завантажувати копії FLAC. Це випадок, коли storage VPS вигідніший за звичайний VPS, оскільки вартість таких планів визначається за терабайт, а не за кількістю ядер.
Потреба в пам’яті помірна. Navidrome обслуговує особисту медіатеку, використовуючи кількасот мегабайтів, а пікове споживання припадає на сканування, а не на відтворення. Виділіть серверу 1 GB або 2 GB RAM, а решту бюджету витратьте на диск.
Встановлення Navidrome за допомогою Docker Compose
Спочатку створіть каталоги. Власником має бути ідентифікатор користувача, від імені якого працюватиме контейнер. Якщо ви раніше не працювали з 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:rodocker compose up -d
docker compose psКоманда docker compose ps має показати, що сервіс працює, а не перезапускається. Контейнер, який постійно перезапускається, майже завжди має проблеми з правами доступу до /srv/navidrome, а docker compose logs navidrome містить назву файлу, до якого він не зміг записати.
У цьому файлі варто пояснити чотири деталі. Порт опубліковано лише на 127.0.0.1, тому сервер доступний через reverse proxy, а не через порт 4533 з відкритого Інтернету: Docker самостійно додає правила firewall, тому звичайний 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/Кінцевий слеш у source має значення. Без нього ви отримаєте /srv/music/Music. Після завершення копіювання виправте власника:
sudo chown -R 1000:1000 /srv/music
id -uКонтейнер працює від імені user id 1000, а mount доступний лише для читання. Тому цей id має мати дозвіл на читання кожного файлу та дозвіл на проходження для кожного каталогу. Якщо скопійовані файли належать іншому обліковому запису, а його permissions забороняють доступ усім іншим, сканування не знайде жодного треку. Вебінтерфейс залишатиметься порожнім, а в журналі з’явиться open /music: permission denied. Наведена вище команда chown — один зі способів виправити це. Якщо папку також використовують інші програми, у Docker-документації Navidrome рекомендується натомість надати доступ на читання, не змінюючи власника: sudo chmod -R a+rX /srv/music. Команда id -u виводить ваш фактичний id, а в матеріалі про роботу PUID і PGID у Docker-контейнерах повністю пояснено це зіставлення.
Reverse proxy і TLS, щоб телефон працював з будь-якої мережі
Спрямуйте DNS A-запис на VPS, а потім додайте до Caddy три рядки:
music.example.com {
reverse_proxy 127.0.0.1:4533
}sudo systemctl reload caddyCaddy запитує сертифікат у фоновому режимі одразу після завантаження сайту, не чекаючи на відвідувача. Порт 443 має бути відкритим. Caddy за замовчуванням вмикає два ACME (automatic certificate management environment) challenges: HTTP challenge на порту 80 і TLS-ALPN challenge на порту 443. Він випадково вибирає один із них, а не завжди починає з HTTP. Після помилки Caddy повторює спробу один раз, а потім перемикається на інший challenge, тому закритий порт 80 не перешкоджає отриманню сертифіката. Але порт 80 все одно залиште відкритим, оскільки саме на ньому працює автоматичне перенаправлення Caddy з HTTP на HTTPS. У nginx додайте proxy_buffering off; до location block: Navidrome передає події про прогрес вебінтерфейсу через одне довготривале з’єднання. Якщо buffering увімкнено, інтерфейс чекає на відповідь, яку nginx досі утримує. Якщо ви розміщуєте сервіс за шляхом на кшталт /music, а не на окремому субдомені, задайте ND_BASEURL з таким самим шляхом. Інакше інтерфейс завантажиться як порожня сторінка. Три поширені proxy порівняно в матеріалі 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, proxy працює, а облікові дані неправильні. Помилку сертифіката на цьому етапі потрібно виправити першою, оскільки більшість мобільних клієнтів відхиляє недійсний сертифікат і показує користувачеві неінформативне повідомлення.
Чому після першого сканування бібліотека має неправильний вигляд
Navidrome переглядає музику за тегами, а не за папками, тому саме теги визначають, що ви бачите. Трек без тегу виконавця альбому буде віднесено до виконавця треку. Через це одна збірка, де кожен трек має іншого виконавця, перетворюється на двадцять альбомів по одному треку. Виправляйте це у файлах, а не в 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, тому вони не переживуть відмову VPS. За розкладом передавайте /srv/navidrome на іншу машину або до об’єктного сховища. Саме для цього призначені restic і BorgBackup. Увесь каталог невеликий, зазвичай значно менший за гігабайт, тому щоденна зашифрована копія за межами сервера майже нічого не коштує та відновлює все, чого не може відновити повторне сканування.
FAQ
Чи потрібно транскодувати музику на VPS?
Майже ніколи. Телефони самостійно декодують MP3, AAC, Opus і FLAC. Сучасні браузери на більшості систем також це вміють. Тому сервер надсилає файл без змін і майже не використовує CPU. Перевіряти потрібно саме браузери: Firefox відтворює AAC лише тоді, коли операційна система або зовнішня бібліотека надає декодер. Тому для AAC-бібліотеки у вебпрогравачі може знадобитися транскодований потік. Найдоцільніше вмикати транскодування для бібліотеки FLAC, яку передають через мобільну мережу. Перетворення приблизно з 900 kbps на Opus зі швидкістю 128 kbps зменшує обсяг використаних даних приблизно у сім разів. Починаючи з версії 0.61, Navidrome підтримує транскодування на сервері: визначає кодеки, які підтримує клієнт, застосовує налаштування бітрейту з урахуванням формату та дає змогу обмежувати бітрейт для кожного програвача.
Чому мобільний застосунок не може завантажити музику для прослуховування офлайн?
Тому що офлайн-сховище — це функція клієнта, а не сервера. Subsonic API дає змогу будь-якому клієнту отримати цілий файл, але саме застосунок вирішує, чи зберігати його копію на телефоні. Перегляньте каталог клієнтів на navidrome.org/apps і виберіть застосунок, в описі якого згадано офлайн-завантаження або кешування. Деякі клієнти кешують лише те, що ви вже прослухали. Це не те саме, що синхронізувати альбом перед поїздкою.
Чому після сканування один альбом розділився на кілька альбомів?
Тег виконавця альбому відсутній або має різні значення в різних композиціях. Navidrome групує композиції за тегами, а не за каталогами. Тому 12 композицій із 12 різними значеннями виконавця та без спільного значення виконавця альбому виглядають як 12 альбомів. Установіть тег виконавця альбому для кожної композиції альбому. Для збірки зазвичай використовують значення Various Artists. Після цього запустіть повторне сканування. MusicBrainz Picard або beets можуть змінити теги для всього каталогу за один раз.
Чи замінює self-hosted стримінг музики Spotify?
Він замінює програвач і бібліотеку, але не каталог. Ви отримуєте власну колекцію на кожному пристрої, а також плейлисти й лічильники прослуховувань, яких у вас не забере жодна зміна ліцензійних умов. Нових релізів і рекомендацій на основі прослуховувань інших користувачів ви не отримуєте. Більшість людей, які використовують таку схему, купують музику та зберігають недорогий обліковий запис streaming-сервісу для пошуку нової музики.