音乐都存在家里的硬盘,出门用手机听不到;想在线听,又不想把曲库传到别人的云。Navidrome 把音乐库变成自己的流媒体服务,客户端用 Subsonic 协议就能接。
Navidrome 是什么
Navidrome 是开源的音乐流媒体服务器:扫描本地曲库,提供 Web 界面和 Subsonic API,支持转码、播放列表、多用户。它不提供音乐,只负责管理和串流你的文件。
Docker 部署
docker run -d --name navidrome \
--restart=unless-stopped \
-p 4533:4533 \
-v /data/music:/music:ro \
-v /data/navidrome:/data \
-e ND_SCANSCHEDULE=1h \
-e ND_LOGLEVEL=info \
deluan/navidrome:latest
音乐目录只读挂载,防止误删;数据目录存数据库、封面和配置,单独备份。
曲库怎么整理
Navidrome 按标签识别,不靠文件名。建议:
- 专辑目录:艺人/专辑/曲目
- 标签完整:标题、艺人、专辑、音轨号
- 封面放 cover.jpg 或内嵌
- 不要放重复文件,扫描会慢
整理好标签,界面才不会一堆“未知艺人”。
用户和权限
管理面板可以建用户,设管理员、上传、分享权限;对外只开普通用户,别给管理员。多用户共享一个库,播放记录分开。

转码
客户端带宽不够时,Navidrome 可以转码成 Opus/MP3。转码吃 CPU,1 核跑一两个人够,多人同时转就要加核。
ND_ENABLETRANSCODINGCONFIG=true
ND_TRANSCODINGCACHESIZE=100MB
无损曲库建议保留原文件,按客户端能力转码;别全局强制转码,音质会降。
HTTPS 和反代
location / {
proxy_pass http://127.0.0.1:4533;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
Subsonic 客户端填 HTTPS 域名和端口;反代超时给足,大文件串流别被截断。

日本节点
音乐串流对延迟和带宽都敏感,节点位置直接影响体验。
- 日本:大陆和东亚用户延迟低,适合主要受众
- 新加坡:东南亚用户近
- 美国:曲库大、存储便宜,但跨洋延迟高
曲库放对象存储或大磁盘,服务器只跑服务;日本节点配 100M 以上带宽,多人同时听才不卡。

备份
备份数据库、播放列表和配置;音乐文件如果有多份,可以不重复备。数据库丢了,用户和播放记录就没了。
客户端
Subsonic 兼容客户端很多:Android 的 Symfonium、iOS 的 play:Sub、桌面的 Sonixd 等。填服务器地址、账号密码即可,支持离线缓存。
扫描
扫描频率别太高,曲库大时很吃 IO;新增文件手动触发一次,比每小时全扫省资源。
播放列表
支持 m3u 和客户端播放列表;导入前确认路径,路径变了列表就空。
分享
可以生成分享链接,按需开;公开分享注意版权,别把整张专辑挂出去。
带宽
无损串流吃带宽,多人同时听要算峰值;转码能降带宽,但吃 CPU。
升级
升级前备份数据库,镜像用固定 tag;跨版本可能改库结构,先在测试环境跑。
音质
原文件无损就够,转码只为省带宽;客户端支持什么格式,决定你要不要转。
多用户
每个用户独立账号和播放记录;共享曲库不等于共享密码,别让所有人用管理员。
故障排查
扫不到歌先看标签和目录权限;串流卡先看带宽和转码 CPU,再看反代超时。
移动端
Subsonic 客户端支持离线缓存;缓存目录和音质设置按流量套餐调。
曲库迁移
换服务器先保持目录结构,再改挂载路径;路径变了要重新扫描,播放列表可能失效。
安全
HTTPS、强密码、关闭公开注册;管理员账号单独用,别和日常听歌账号混。
硬件
曲库大用大磁盘,转码多加大 CPU;内存 1G 起步,用户多再加。
转码配置
按客户端网络选码率,别全局最高;转码缓存能减少重复计算。
播放统计
记录播放次数和最近播放;多用户下按账号分开,别混在一起。
客户端选择
选支持离线缓存和歌词的客户端;协议兼容不代表体验一样,先试用。
缓存
封面和转码缓存会涨;设上限并定期清,别把系统盘写满。
多房间
不同房间/设备可以播不同歌;按用户隔离,别让一个人的队列影响别人。
监控
看扫描状态、转码队列和带宽;串流卡先查网络,再查 CPU。
先把曲库扫完,再谈转码和分享;标签乱了,后面全乱。
先把标签整理好,再开转码和分享。
先让一个客户端播起来,再谈多用户啊啊。
先把曲库和标签理顺,再谈转码和分享。
先把标签和目录理顺,再开转码。
先把曲库扫完,再谈播放体验。
先把曲库整理好,再谈转码。
先把标签和目录理顺,再谈多用户。
先把曲库和播放跑顺。
先跑通一个客户端,再扩用户。
先把一个客户端跑顺,再谈多用户。
常见问题 FAQ
Q1:Navidrome 和 Plex 有什么区别?
Navidrome 专注音乐,轻量、协议开放;Plex 偏综合媒体,功能多但更重。
Q2:日本节点合适吗?
东亚用户为主就合适;欧美用户多就选美国或欧洲。
Q3:要多大配置?
1 核 1G 能跑,转码和多用户建议 2 核 2G 以上。
Q4:能商用吗?
看许可证和音乐版权;自用没问题,公开传播要授权。
Q5:支持什么格式?
MP3、FLAC、AAC、OGG 等常见格式;转码输出看客户端支持。
总结
Navidrome 适合自建音乐库:Docker 起服务、曲库标签整理、按需转码、HTTPS 反代、日本节点做串流。数据库和配置要备份,音乐文件按版权要求使用。
需要一台音乐服务器,可以按小时开一台萤光云日本 VPS,先把曲库和串流跑通。
音乐库先整理标签和封面,转码和客户端兼容会省很多事。







