SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor · 更新于 2026-10-28

如何在 VPS 上自托管音乐流媒体服务

在 VPS 上部署 Navidrome 实现个人音乐库流媒体播放。本文涵盖存储空间规划、Subsonic 客户端选择、离线同步配置及 TLS 加密设置。特别提醒:请务必升级至 0.64.1 或更高版本,以修复针对 Subsonic 登录接口的无限制密码猜测漏洞,确保您的服务器安全。

VPS 上自托管音乐流媒体的作用

在 VPS 上自托管音乐流媒体,意味着您运行播放器,并自行提供音乐。服务器保存您已经拥有的音乐文件,任何手机都可以使用普通登录方式通过互联网访问它。开始前应明确这一取舍:它替代的是流媒体服务的播放器,而不是其音乐目录。只有在您购买或翻录音乐,并将文件复制到服务器后,音乐库中才会出现新内容。

音频对服务器的要求远低于视频。音频文件较小,手机无需额外处理即可解码常见格式,而且一名听众占用的带宽低于视频通话。在这里,CPU 通常不是问题。真正受限的是磁盘空间。决定方案能否正常使用的另外两个因素是标签质量,以及手机应用是否支持下载音乐供离线播放。

Navidrome 是只需要音频时的默认选择。它是单个容器中的一个 Go 二进制文件,并将状态保存在一个 SQLite 数据库中。它提供 Subsonic API,因此才有大量第三方手机应用可用。Version 0.64.2 于 24 September 2026 发布,截至 2026-10-27 仍是当前版本。不要运行早于 0.64.1 的版本,因为该版本修复了五个安全公告涉及的问题,其中包括针对 Subsonic 登录的无限速密码猜测。项目说明它可以在 Raspberry Pi 等资源受限的硬件上稳定运行,因此服务器软件不是主要成本来源。

Jellyfin 适合已经在 VPS 上通过 Jellyfin 作为媒体服务器运行视频服务的情况。它的音乐库可以正常工作,Finamp 是一款适用于 Android 和 iOS 的免费 Jellyfin 音乐应用,可下载曲目供离线收听。Jellyfin 本身仍没有内置 Subsonic 端点,但社区插件可以添加该功能。Subfin 插件的分支版本 Subfin-NG 通过向 Jellyfin 添加 OpenSubsonic API,“让兼容 Subsonic 的音乐应用播放你的 Jellyfin 音乐库”。它要求 Jellyfin 12.0 或更高版本;该要求由 release 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 是联邦化选项,version 2.0 于 March 2026 发布。Funkwhale 服务器称为 pod,pod 通过 ActivityPub(Mastodon 使用的协议)进行联邦通信,用户可以跨 pod 关注彼此的播放列表。Version 2.0 用播放列表替换了旧的媒体库,因此媒体库关注关系变为播放列表关注关系;运行 2.0 的 pod 无法与仍运行 1.x 的 pod 进行联邦通信。它也提供部分 Subsonic API,但有一个重要区别:每个用户必须在自己的设置中单独设置 Subsonic 密码,因为 Subsonic 协议要求服务器能够读取密码。Funkwhale 的安装更复杂,因为除了 Web 应用外,还需要 PostgreSQL 和任务队列。

除非需要联邦功能,或已经运行 Jellyfin,否则请选择 Navidrome。本指南的其余部分将使用 Docker 部署 Navidrome。

Subsonic API 如何决定您使用哪款手机应用

Subsonic 是一种音乐服务器,其 HTTP API 后来成为自托管音频服务的通用接口。OpenSubsonic 是负责持续扩展该接口的社区项目。这段历史解释了为什么您可以选择手机应用。Navidrome 不提供自己的移动应用,也不需要这样做,因为任何 Subsonic 客户端都可以使用服务器地址和您的账户信息登录。

离线同步最能体现这一点,因为它决定了这套配置能否适应日常使用。手机进入隧道后无法连接服务器,因此客户端必须提前将文件复制到本地存储。所有客户端都支持串流,但只有部分客户端支持下载。位于 navidrome.org/apps 的客户端目录会说明哪些客户端支持下载。两个平台都有多种选择:Android 上有 Substreamer 和 Ultrasonic,iOS 上有 Amperfy 和 play:Sub。功能最强的客户端中有多款是付费应用,而 Android 上最常被提到的是 Symfonium。请先安装两款再做决定,因为这是您每天使用这套系统时接触最多的部分。

音乐库需要多少存储空间?

图表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,即可得到 MB。在 320 kbps 下,一张专辑需要 108 MB,因此一千张专辑约需 108 GB。

无损格式会改变结果。对于普通录音,CD 音质的 FLAC 平均接近 900 kbps,因此同样的一千张专辑约需 304 GB。24 bit、96 kHz 的音乐库大约需要 1,013 GB;对于一套可以列在纸上的音乐库,这已经是整整 1 TB。适合手机播放的 128 kbps Opus 副本,则可将同样的一千张专辑压缩到 43 GB。对现有音乐库运行 du -sh /path/to/music,因为您自己的平均比特率是在选择方案时唯一重要的数值。

带宽只占费用中较小的一部分。320 kbps 的音频流每秒传输 40 KB,因此听一小时约传输 144 MB。每月收听 100 小时约消耗 14 GB,VPS 的流量额度通常不会受到影响。例外是手机首次进行离线同步时,一个晚上可能传输数十 GB。

存储层还是计算层?

音乐服务器本质上是大量冷数据的集合,几乎不需要计算资源。以每秒 40 KB 的速度读取文件时,任何磁盘都处于空闲状态。CPU 仅在扫描媒体库、转码(通常不需要)以及提取并缓存封面(在扫描时或首次打开项目时)才会产生实际负载。因此,计算型方案中昂贵的 NVMe 固态硬盘在此场景下毫无意义,而其高昂的单位容量价格反而会限制你上传 FLAC 格式音乐文件。在这种情况下,存储型 VPS 优于常规 VPS,因为前者的定价基于 TB 容量而非 CPU 核心数。

内存需求适中。Navidrome 运行个人媒体库仅需几百 MB 内存,且扫描时的内存占用峰值远高于播放时。为服务器分配 1 GB 或 2 GB 内存即可,将剩余预算全部投入到磁盘空间上。

使用 Docker Compose 安装 Navidrome

首先创建目录,并将其所有权分配给容器运行所使用的用户 ID。如果你不熟悉 Compose,VPS 上的 Docker Compose 一文涵盖了此文件所基于的前提条件。

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 会自行写入防火墙规则,因此即使在 ufw 显示所有端口已禁用的服务器上,普通的 4533:4533 依然会暴露在外。音乐卷设置为只读,这意味着扫描程序若出现 Bug 也无法删除你的原始文件。ND_SCANNER_SCHEDULE 默认处于禁用状态;在 Navidrome 0.55 版本之前的指南中,它被称为 ND_SCANSCHEDULE,这是 0.55 版本重命名后的旧称。最后三个备份设置开启了内置的数据库备份功能,下文的备份章节将依赖此功能。

将音乐文件上传至服务器

使用 rsync 同步音乐库。连接中断时,rsync 可从断点续传,无需重新开始。

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

rsync -avP /path/to/local/music/ user@server:/path/to/remote/music/

源路径末尾的斜杠至关重要。若省略斜杠,会导致 /srv/music/Music。复制完成后,修复文件所有权:

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

chown -R 1000:1000 /path/to/remote/music/

容器以用户 ID 1000 运行,且挂载点为只读,因此该 ID 必须拥有所有文件的读取权限以及所有目录的遍历权限。如果复制后的文件归属于其他账户,且权限设置排除了其他用户,扫描程序将无法发现任何曲目,Web 界面会显示为空,日志中则会出现 open /music: permission denied。上述 chown 命令是一种解决方法。如果其他程序也需要使用该文件夹,Navidrome 的 Docker 文档建议改为授予读取权限,而不更改所有者:sudo chmod -R a+rX /srv/music。id -u 可打印您的真实 ID,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(自动证书管理环境)挑战:端口 80 上的 HTTP challenge 和端口 443 上的 TLS-ALPN challenge,并随机选择其中一种,而不是始终先使用 HTTP。挑战失败后,它会重试一次,然后切换到另一种挑战,因此关闭端口 80 不会阻止证书申请。但仍应开放端口 80,因为 Caddy 的 HTTP 到 HTTPS 自动重定向通过该端口提供。在 nginx 中,将 proxy_buffering off; 添加到 location 块:Navidrome 通过一个长连接向 Web 界面推送进度事件;启用缓冲后,界面会一直等待 nginx 持有的响应。如果通过 /music 这样的路径提供服务,而不是使用独立子域名,请将 ND_BASEURL 设置为相同路径,否则界面会加载为空白页。三种常见代理的对比见 VPS 上的 Nginx、Caddy 和 Traefik。

打开站点并创建第一个账户。系统没有默认密码,首位访问者会被要求创建 admin 用户,因此应在告知他人地址前完成此操作。然后测试手机客户端使用的完整路径:

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 按标签而不是按文件夹浏览,因此标签决定了您看到的内容。没有专辑艺术家标签的曲目会归到其曲目艺术家名下,这就是为什么一张每首曲目艺术家都不同的合辑会变成 20 张各只有 1 首曲目的专辑。请直接修复文件中的标签,不要在 Navidrome 中修复:MusicBrainz Picard 和 beets 都会在 MusicBrainz 数据库中查询专辑,并将标准标签写回文件。

Navidrome 还会将包含多个艺术家的标签拆分为独立艺术家。因此,艺术家名称中包含分隔符的乐队可能会被错误拆分,AC/DC 就是最常见的例子。ND_SCANNER_ARTISTSPLITEXCEPTIONS包含绝不能拆分的名称。

新文件写入后,文件监视器会在几秒内发现这些文件。文件监视器依赖内核变更通知,而从另一台计算机挂载的网络共享中的文件不会触发此类通知。因此,在这种环境中,定期执行 ND_SCANNER_SCHEDULE 才能保持媒体库最新。完整重新扫描会读取每个文件的标签,在大型媒体库中速度较慢;这也是值得保护下方数据库的原因之一。

用户、播放列表和共享

管理员在 Web 界面中创建其他账户,不支持用户自行注册。每个用户都有独立的播放次数、播放列表、收藏和评分,因此家庭成员不会共用同一个偏好档案。

播放列表有两种来源。在客户端中创建的播放列表存储在数据库中。将 .m3u 文件放入媒体库目录后,扫描时会导入该文件。这是在桌面播放器和服务之间迁移播放列表的简单方法。智能播放列表使用 .nsp 文件,即内容简短的 JSON 规则文件,会以相同方式导入,并在媒体库发生变化时自动更新。

从 2026 年 7 月发布的版本 0.63.0 开始,共享功能默认启用。用户可以为专辑创建公开链接,任何人无需登录即可打开该链接。如果服务器保存了完整的媒体库,这种设置可能并不符合需求。将 ND_ENABLESHARING 设置为 false 可关闭该功能。

将数据库与音乐文件分开备份

Navidrome 的内置备份功能仅涵盖数据库。文档对此说明得很明确:备份过程仅处理数据库,即用户数据、播放次数及其他元数据,并不备份音乐文件或配置文件。这种分离是正确的处理思路,因为这两部分数据的故障模式不同。音乐文件可以从原始抓取源重新复制;而播放次数、评分、收藏和播放列表仅存在于数据库中,重新扫描无法恢复这些数据。

Compose 文件已配置为每晚将副本写入 /data/backup 并保留 7 个备份。升级前请手动执行一次备份:

sudo docker compose run --rm navidrome backup create

从 0.63 升级到 0.64 版本时最需要执行此操作。0.64.0 版本在迁移过程中会重新编码所有内部 ID,这涉及所有数据表,且保留离线下载的客户端在升级后可能需要重新同步。

恢复备份会覆盖当前数据库并将备份文件复制到相应位置,此操作必须在 Navidrome 停止运行的情况下进行。在运行中的服务器上执行恢复操作是不安全的。

由于这些文件仍存储在同一台 VPS 上,因此无法抵御 VPS 故障。请按计划将 /srv/navidrome 推送到另一台机器或对象存储中,这正是 restic 和 BorgBackup 的用途。整个目录体积很小,通常远小于 1GB,因此每日进行一次异地加密备份几乎没有成本,却能找回重新扫描无法恢复的所有数据。

FAQ

我需要在 VPS 上对音乐进行转码吗?

几乎不需要。手机和大多数系统上的现代浏览器都能自行解码 MP3、AAC、Opus 和 FLAC,因此服务器只需直接发送文件,几乎不占用 CPU。需要检查的是浏览器:Firefox 仅在操作系统或外部库提供解码器时才能播放 AAC,因此网页播放器中的 AAC 库可能需要转码流。最值得开启转码的情况是通过移动数据流式传输 FLAC 库,将约 900 kbps 的码率转换为 128 kbps 的 Opus 格式,可将流量消耗降低约七倍。自 0.61 版本起,Navidrome 已在服务器端管理转码:它会自动检测客户端支持的编解码器,应用格式相关的默认码率,并允许你限制每个播放器的码率。

为什么我的手机应用无法下载音乐以供离线收听?

因为离线存储是客户端功能,而非服务器功能。Subsonic API 允许任何客户端获取完整文件,但由应用决定是否在手机上保留副本。请查看 navidrome.org/apps 上的客户端列表,选择描述中提及离线下载或缓存的应用。部分客户端仅缓存已播放的内容,这与旅途前同步专辑不同。

为什么扫描后一张专辑被拆分成了多张专辑?

这是因为专辑艺术家(Album Artist)标签缺失或各曲目间不一致。Navidrome 根据标签而非文件夹进行分组,因此如果 12 首曲目拥有 12 个不同的艺术家值且没有共享的专辑艺术家值,它们会被识别为 12 张专辑。请为专辑中的每首曲目设置专辑艺术家标签(合辑通常设为 Various Artists),然后重新扫描。MusicBrainz Picard 或 beets 可以一次性处理整个文件夹。

自建音乐流媒体能取代 Spotify 吗?

它取代的是播放器和曲库,而非曲库目录。你可以在所有设备上拥有自己的收藏,且播放列表和播放次数不会因任何授权变更而丢失。但你无法获得新发行内容,也无法获得基于他人收听习惯的推荐。大多数运行此服务的人会购买音乐,并保留一个廉价的流媒体账号用于发现新歌。

这篇文章对您有帮助吗?

#navidrome#music#streaming#自托管#media-server