教程

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

搭建音乐库

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

接入 OFPlayer

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

页面说明

教程是 OFPlayer 本地优先音乐工作流的一部分。这个页面会先说明功能边界、适用场景和下一步入口，再交给网页播放器或工具页面完成具体操作。

OFPlayer 面向有个人音乐收藏的用户，重点放在本地文件播放、WebDAV 与 Subsonic/Navidrome 音乐库连接、歌词和音频工具、隐私优先的数据处理，以及足够克制的桌面式界面。

如果你只是想试用，可以从网页版开始导入本地音频；如果已经有 NAS、服务器或远程曲库，可以继续阅读教程，把 OpenList、WebDAV 或 Navidrome 接到同一套播放体验里。

页面内容会尽量说明真实可用的能力，不把尚未完成的方向包装成已经上线的功能。遇到部署、连接或格式问题时，可以顺着相关文档和工具逐步检查，而不是在播放器里反复猜配置。

对于搜索、分享或禁用脚本的访问场景，这份静态内容也会保留核心信息：页面主题、产品边界、相关入口和下一步操作都能被直接读取，不依赖前端应用完成后才出现。

每个入口都会尽量连接到相邻的说明页，避免只留下单点页面，内容也会随着产品发布持续更新。

从这里可以继续访问 OpenList 搭建教程、OFPlayer 连接 WebDAV 音乐库、Navidrome 私人音乐服务搭建、WebDAV 音乐库排查指南。这些内部入口覆盖产品介绍、教程、文档、下载和实际工具，方便从了解能力一路走到部署、整理曲库和开始播放。

OFPlayer 自建音乐库教程系列

从零开始搭自己的音乐服务器，用 OFPlayer 随时随地听。

AList 相关内容已降级为存量用户/迁移参考；新部署优先选 OpenList 或 Navidrome。外部项目以各自官方文档为准（2026-05）。

教程目录

入门篇

OpenList（AList 社区驱动分支）搭建教程
- 零基础也能上手
- Windows / Docker / NAS 多种姿势部署
- 当前推荐的 WebDAV 自托管方案
AList WebDAV 服务搭建：存量用户参考
- 给已经部署了 AList 的用户
- 迁移前核对配置用
- 局域网和远程访问都有

实战篇

OFPlayer 连接 WebDAV 音乐库完整指南
- 一步步带你连
- WebDAV / Subsonic 两种协议
- 多设备同步
用 Navidrome 搭建私人音乐流媒体服务
- 专业级音乐服务器
- 多用户
- 兼容 Subsonic 生态

进阶篇

WebDAV 音乐库常见问题排查指南
- 连接问题怎么查
- 性能优化建议
- 高级调试技巧

快速开始

第一次搭的话，按这个顺序来：

选一个方案：
- 想简单 / WebDAV → OpenList 教程
- 要专业功能 → Navidrome 教程
- 已经在用 AList → AList 存量参考，再看要不要迁移到 OpenList
搭好之后，看 OFPlayer 连接指南
出问题了，查排查指南

方案对比

特性	AList	OpenList	Navidrome
部署难度	⭐⭐	⭐⭐	⭐⭐⭐
当前建议	存量参考	WebDAV 首选	专业音乐库首选
Web UI	✓	✓	✓
WebDAV	✓	✓	✗
Subsonic API	✗	✗	✓
多用户	✓	✓	✓
自动扫描	✗	✗	✓
资源占用	低	低	中
适合场景	旧部署维护	通用文件管理	专业音乐管理

推荐配置

家庭用户（< 1000 首）

服务器：树莓派 4B 或旧笔记本
方案：OpenList + OFPlayer
优点：部署简单，资源占用低

音乐爱好者（1000-10000 首）

服务器：N100 小主机
方案：Navidrome + OFPlayer
优点：专业功能，多用户支持

发烧友（> 10000 首）

服务器：Intel i3+ / NAS
方案：Navidrome + OpenList（混合方案）
优点：灵活管理，高性能

常见问题

Q：选哪个方案？

只想快速搭个 WebDAV → OpenList
已经在用 AList → 先按存量参考维护，后面迁移到 OpenList
要专业功能 → Navidrome

Q：需要什么硬件？

最低：树莓派 4B / 旧笔记本
推荐：N100 小主机
发烧：Intel i3+ / NAS

Q：要公网 IP 吗？

局域网用：不需要
远程访问：需要（或者用内网穿透）

Q：支持什么音频格式？

MP3、FLAC、WAV、AAC、OGG
其它格式看播放器支不支持

参考来源

OpenList 官方仓库：https://github.com/OpenListTeam/OpenList
OpenList 官方文档：https://doc.openlist.team/
Navidrome 官方安装文档：https://www.navidrome.org/docs/installation/
Navidrome GitHub Releases：https://github.com/navidrome/navidrome/releases

技术支持

OFPlayer 官网：https://ofplayer.org
OFPlayer 文档：https://ofplayer.org/docs

许可证

本教程系列采用 CC BY-SA 4.0 许可协议。