如果你硬盘里攒了不少珍藏的 MP3、FLAC 无损音频，又不想每个月给各大流媒体平台充会员，还经常面临歌曲下架、灰色变灰的烦恼，那么自建音乐服务器会是你的终极解法。Navidrome 是一款极其轻量、开源且现代的个人音乐流媒体服务。它不仅自带清爽的网页播放器，而且原生兼容成熟的 Subsonic / Madsonic API 协议，这意味着 iOS、Android、车载甚至桌面端有海量的成熟第三方客户端（如音流、Amperfy、Symfonium 等）任你挑选，随时随地串流你的私人曲库。

本文基于 Navidrome v0.64.2 官方镜像（deluan/navidrome）于 2026-11-03 实测通过。我们将采用官方推荐的 Docker Compose 方式进行容器化部署，整个过程十分轻快，几分钟即可搞定。

成品长这样

部署完成后，你只要在浏览器打开管理面板，Navidrome 就会自动解析歌曲标签并建立索引，生成美观的封面网格流：

Navidrome 登录后的专辑列表，出现演示专辑 Deploy Demo Album — 图 1：登录后的专辑墙，演示专辑已经自动扫描入库

准备工作

在开始敲命令之前，请确认你的服务器环境满足以下几项基础条件：

Linux 服务器一台：Navidrome 用 Go 语言编写，内存占用极低，配置 1 核 CPU、512MB 内存的入门级 VPS 即可流畅起跑。
运行环境：服务器已安装好 Docker 以及 Docker Compose 插件。
防火墙端口：确保安全组或防火墙已放行 4533 端口（TCP 流量）。
音乐文件目录：准备好存放音频文件的本地路径。Navidrome 支持只读挂载，绝不会篡改你辛苦整理的音频源文件。

第一步：Docker Compose 部署

创建专属工作目录

在服务器上规划一个专用的持久化目录，比如 ~/navidrome，并在里面建立数据存储目录与音乐文件夹：
BASH
```
mkdir -p ~/navidrome/data ~/navidrome/music
cd ~/navidrome
```
编写 docker-compose.yml 配置文件

在当前目录下新建 docker-compose.yml 文件，将以下配置写入其中：
BASH
```
services:
  navidrome:
    image: deluan/navidrome:0.64.2
    container_name: navidrome
    restart: unless-stopped
    ports:
      - "4533:4533"
    environment:
      - ND_SCANSCHEDULE=1h
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/data
      - ./music:/music:ro
```
这里将宿主机的 ./music 只读映射（:ro）到容器内部，既安全又防误删；ND_SCANSCHEDULE=1h 表示每隔 1 小时自动扫描一次新添加的曲目。
拉取镜像并启动容器

在配置文件所在目录执行启动命令，后台运行容器服务：
BASH
```
docker compose up -d
```
验证服务可访问性

等待几秒后，打开浏览器访问 http://你的服务器IP:4533。只要能看到提示创建首个管理员账号（Create Admin User）的初始化引导页面，就说明服务已经成功在后台启动跑通。

备份极省心：Navidrome 的播放列表、用户收藏、听歌历史和索引数据全部储存在 ./data/navidrome.db 这个单独的 SQLite 文件里。以后迁移服务器或日常异地备份，你只需要打包拷贝这个文件即可，没有任何复杂的数据库运维负担。

第二步：创建管理员并登录

容器启动成功后，你在浏览器打开 http://你的服务器IP:4533。你会发现 Navidrome 并没有预设任何诸如 admin/admin 的默认账号，而是直接弹出了一个创建管理员的初始界面。

在界面里依次填入你要设置的用户名（Username）、密码（Password）以及确认密码（Confirm Password）。
确认无误后点击下方的 CREATE ADMIN 按钮。系统会立即为你建好用户，并自动登录跳转进后台主界面。

注意安全：你创建的第一个账号就是最高管理员，而且创建完成后该注册入口会立即永久关闭。请务必使用强密码，避免公网暴露后被恶意爆破。

Navidrome 首次访问的创建管理员页面 — 图 2：首次访问没有登录框，而是直接让你创建第一个管理员

之后你再在任何设备上打开这个地址，或者退出当前登录，呈现给你的就是日常的登录界面了，直接用刚建好的账号密码登录即可：

第三步：往音乐库里加歌

刚进后台时曲库是一片空白的，接下来你需要把歌曲放进挂载的 music 目录中。为了往后维护方便，最清爽的做法是按 歌手名/专辑名/歌曲文件.flac 这种层级来分文件夹存放。

Navidrome 会按照配置的环境变量 ND_SCANSCHEDULE 设定的周期定时扫描（我们在前文配置的是每小时扫描一次 1h）。如果你刚拷贝完音频文件、不想干等定时任务，直接点一下网页右上角的重新扫描图标，系统就会立刻启动全量扫描入库。

元数据全看 ID3 标签：
Navidrome 渲染专辑封面墙、歌手归类和音轨顺序，完全依赖音频文件内部封装的 ID3 标签，而不是你的文件名。如果文件标签缺失或杂乱，专辑墙就会变成一片“未知艺术家”，加歌前建议先用元数据刮削工具把标签整理规范。

我们在本次实测中放进了一个带有完整内嵌标签的演示文件。扫描完成后进入专辑详情页，你可以看到系统自动识别出了一首曲目，并准确展示出标题、歌手、精准时长以及音频码率等完整信息：

Navidrome 专辑详情页，列出演示歌曲 Demo Silence — 图 4：专辑详情页，歌曲的标题、歌手、时长、码率都来自文件标签

除了在网页端直接听歌，Navidrome 还天然支持成熟的 Subsonic API。你可以在手机端安装音流、Amperfy 或 substreamer 等客户端，在 App 里填入你的 http://服务器IP:4533 和账号密码，就能瞬间打通私有流媒体串流。

踩坑实录

1. 解压二进制包报 Cannot change ownership 错误
如果你选择从 GitHub Release 下载官方 tar 包在非 root 或受限环境解压，tar 可能会报错 Cannot change ownership: Operation not permitted 并异常退出。解决方法很简单，解压命令加上 --no-same-owner 参数即可，释放出的二进制文件完全完好可用。

2. 顺序别搞反：先建管理员再导歌单
如果你有现成的 .m3u 歌单想要同步，一定要等建好首个管理员之后再放进曲库。如果在建号前就丢进去，启动日志会白纸黑字明确提示由于尚未创建用户、歌单已被跳过导入。建好账号后再触发重新扫描，歌单才会正确关联到对应账号。

3. 不给配置就全走纯默认参数
如果启动时没有指定配置文件或对应的环境变量，Navidrome 会在日志中输出一行 warning 提示正在使用默认配置。为了避免后续出现扫描卡死或转码失控，建议像监听端口、扫描周期（ND_SCANSCHEDULE）等核心参数都在 compose 或 navidrome.toml 里显式钉住。

4. db 只是元数据索引，不是音频本体存储
navidrome.db 只是个轻量的 SQLite 数据库，里面记录的是每首歌的标签元数据和绝对路径索引，真正的音乐本体一直老老实实呆在 music 目录里。做整站迁移时，千万别只拷一个 db 走，两套目录必须完整备份且挂载路径保持一致，否则所有索引都会失效。

升级与备份

平滑升级：
使用 Docker Compose 升级非常简单，只需修改 docker-compose.yml 里的版本标签（或直接拉取最新镜像），然后执行 docker compose pull && docker compose up -d 重新拉起即可；如果是二进制部署，直接替换新的二进制程序。Navidrome 在每次启动时都会自动检测并执行 SQLite 数据库迁移，无需手动执行升级脚本。

日常备份：
为防止 SQLite 在写入时被打包导致损坏，备份前建议先短暂停服：

# 1. 暂停容器服务
docker compose stop

# 2. 打包核心数据目录与音乐文件
tar -czvf navidrome_backup_$(date +%F).tar.gz data/ music/

# 3. 恢复运行
docker compose start

其中 data/navidrome.db 记录着你所有的红心收藏、播放统计与歌单，体积通常只有几兆到十几兆，平时写个简单的定时脚本将它单独异地备份即可。