
痛点在哪
多年攒下的无损音乐躺在 NAS 或移动硬盘里,出门就听不到;想同步到手机吧,几百 GB 根本塞不下,云盘又不给流式播放。商业云音乐倒是什么都能听,但你的本地曲库它不认识,下架的、冷门的、自己录的,全都搜不到。买台设备搭流媒体服务听起来很重,其实一个容器就够了。
Navidrome Navidrome 是一款用 Go 写的开源音乐服务器,GPL-3.0 协议,GitHub 约 2.4 万星,扫描你硬盘上的音乐目录,通过网页或手机客户端就能像用云音乐一样播放,支持按需转码、歌词、封面、多用户和播放列表,Docker 一条命令就能跑起来,空闲时内存只占几十兆。
参数一览
| 项目 | 说明 |
|---|---|
| 部署方式 | Docker / 二进制单文件 |
| 开源协议 | GPL-3.0 |
| GitHub 星数 | 约 2.4 万(2026-10 核实) |
| 数据库 | SQLite(默认)/ PostgreSQL / MySQL |
| 客户端 | 网页 + 任意 Subsonic 协议客户端 |
| 硬件要求 | 1 核 512MB 内存即可起步 |
能干什么
- 扫目录建库:指定音乐目录,自动按标签整理歌手、专辑、年份,封面从内嵌或同目录图片里取,还有最近添加、最常播放这些视图。
- 兼容 Subsonic 协议:这是关键:市面上大量手机客户端(音流、Symfonium、DSub、play:Sub 等)都支持这个协议,直接连你的服务器,安卓 iOS 都有得选。
- 按需转码:手机流量紧的时候让它把 FLAC 转成低码率 MP3 再传,回家连 WiFi 听原始无损,一份曲库两种用法。
- 自带网页播放器:不装客户端也能在浏览器里听,界面清爽、能搜能排队,办公室电脑上打开就能用。
- 多用户和播放列表:可以给家里人各开一个账号,各自有自己的收藏和播放记录,互不干扰。
- 轻量到离谱:Go 编译的单文件,空闲时内存几十兆,树莓派、老笔记本、群晖上都能跑。
怎么开始用
- 先整理音乐目录,建议按歌手、专辑、曲目的层级放,标签尽量用工具清理干净,扫库质量靠这个。
- Docker 起服务:映射 4533 端口,音乐目录挂到 /music,数据目录挂到 /data。
- 浏览器打开服务器地址的 4533 端口,第一次进要创建管理员账号。
- 进设置里的媒体库,填 /music 路径,点立即扫描,等它扫完(几万首大约几分钟)。
- 手机上装一个支持 Subsonic 协议的客户端,服务器地址填域名或内网地址,账号密码用刚才建的,登录就能听。
- 要在外面听,用反向代理加 HTTPS(或内网穿透)把 4533 暴露出去,别把端口裸奔在公网。
适用人群
- NAS 或硬盘里存了几十上百 GB 无损音乐的人
- 想在外网听自己曲库、又不想上传到云盘的人
- 受够了云音乐下架和版权跳票的用户
- 有小服务器或树莓派、愿意花半小时折腾的人
常见问题
问:必须要有公网 IP 吗?
答:不是必须。局域网内直接填内网地址就能用;出门想听就配反向代理加域名,或者用内网穿透工具把 4533 映射出去。注意加 HTTPS,别把端口裸暴露。
问:支持哪些手机客户端?
答:所有兼容 Subsonic API 的客户端都行,安卓上常见的有 DSub、Symfonium、音流,iOS 上有 play:Sub、Amperfy。官方网页版手机浏览器也能用,就是体验不如原生客户端。
问:会不会自动转码?音质会损失吗?
答:默认可以不转码,原样传输。只有在设置里开了转码、或者客户端请求低码率时才会转,曲库文件本身不会被改动,改的只是传输流。
问:树莓派或者旧笔记本能跑吗?
答:能。Go 单文件、内存占用低,树莓派 4 扫几万首没问题;扫库那一刻 CPU 会高一些,扫完就闲下来了。解码转码开得猛旧硬件会吃力,关掉转码就行。
最后更新:2026-10-29
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。
