教程

从 OpenList、Navidrome 到 OFPlayer 连接与排查,教程围绕真实自建音乐库工作流展开。

搭建音乐库

从 OpenList 与 Navidrome 开始,选择适合自己的 WebDAV 或 Subsonic 自托管方案。

接入 OFPlayer

配置 Endpoint、Root Path、用户名和密码,把远程音乐库同步到 OFPlayer。

流媒体很热闹,但总有一些专辑是你一张张攒下来的:可能是多年前抓轨留下的 FLAC,可能是附着完整内页与封面的限定盘,也可能是再也搜不到的现场录音。把这些声音留在自己的硬盘或 NAS 上,让播放器安静地把它们放出来,是自建音乐库最朴素的初衷。

本系列教程核对于 2026 年 10 月,面向 OFPlayer for Windows(26.0.6)、OFPlayer 安卓版(26.0.2) 与 网页版。无论你是第一次把硬盘里的文件夹开放到局域网,还是想排查一次偶发的连接报错,都可以按下面的脉络找到入口。

先确认:你真的需要搭一台服务器吗?

在动手部署之前,不妨先对照一下你的日常听歌习惯:

  • 只在当前设备上听:直接在 OFPlayer 中导入本地文件夹即可,无需任何网络服务。
  • 只想躺在沙发上用手机听电脑里的歌:在同一 Wi-Fi 下把 OFPlayer Windows 版与安卓版配对,就能直接使用局域网串流与播放接力,省去搭服务器的步骤。
  • 音乐长期放在 NAS、小主机或家庭服务器上,希望多台设备随时取用:这正是本系列教程要解决的场景。

选择适合你的服务端方案

自托管音乐服务通常有两条路线:一种像“打开熟悉的文件柜”,另一种像“请一位替你整理好索引的唱片店店员”。

维度 OpenList(WebDAV) Navidrome(Subsonic) AList(存量参考)
核心定位 把文件夹通过 WebDAV 原样暴露出来 扫描音频内嵌标签,建立专辑与艺术家索引 旧环境维护与迁移前核对
适合曲库规模 几百到数千首,习惯按文件夹整理 数千到数万首,偏爱按专辑、歌手浏览 已经在运行 AList 的存量设备
接入协议 WebDAV Subsonic API WebDAV
新部署建议 WebDAV 首选 音乐专服首选 建议核对后迁往 OpenList

阅读路线

  1. OpenList 搭建教程:使用 Docker Compose 部署 OpenList,将音乐目录以只读方式挂载,并开启 WebDAV 读取权限。
  2. Navidrome 私人音乐服务搭建:部署专注音乐收藏的 Navidrome,自动扫描封面、歌词与多碟专辑。
  3. OFPlayer 连接远端音乐库:在 Windows、安卓和网页版中添加 WebDAV 或 Subsonic 来源,理清协议地址、根路径与浏览器跨域(CORS)规则。
  4. WebDAV 音乐库排查指南:当遇到连接超时、401/405 报错、列表空白或点歌无声时,按“服务—路径—权限—音频流”的顺序逐层定位。
  5. AList 存量环境核对与迁移参考:给仍在使用 AList 的朋友核对当前挂载与权限,或规划向 OpenList 的平稳迁移。