全网音源搬进NAS！HollyMusic部署，听歌、下歌一站服务
内容提要
HollyMusic是一款自部署的在线音乐聚合播放器，兼容洛雪音乐自定义音源，可在NAS上聚合不同来源，支持多用户、缓存、PWA及Subsonic协议。部署简单，通过Docker Compose即可，适合“搜到就听”的用户，但需自备音源，仅供学习交流。
延伸解读
适用场景与定位
HollyMusic并非要取代Navidrome或Jellyfin这类本地音乐库管理工具。如果你已有整理好的FLAC曲库，偏好本地管理，那么传统方案更合适。HollyMusic更适合“搜到就听”的用户，它聚合在线音源，同时将账号、收藏、歌单等数据保留在自己的服务器上，兼顾便利与数据自主。
部署与配置要点
部署通过Docker Compose即可完成，默认端口3099，需注意端口冲突。首次启动需设置AUTH_SECRET，可用AI生成。默认用户名为admin，初始密码在容器日志中生成且仅显示一次，务必及时修改。此外，需自行准备音源文件，项目不内置音源，仅供学习交流。
功能与扩展性
HollyMusic支持LX Music自定义音源API2.0.0，可复用已有.js音源。具备服务端音频缓存、HTTP Range、多用户隔离、PWA及Subsonic协议兼容。若音源支持，还可下载FLAC格式的Hi-Res文件。AI辅助生成歌单属于附加功能，不影响核心使用。
Q&A
HollyMusic是什么？
HollyMusic是一款自部署的在线音乐聚合播放器，兼容洛雪音乐自定义音源，可以在NAS上聚合不同来源的音乐，支持多用户、缓存、PWA及Subsonic协议。
HollyMusic和Navidrome有什么区别？
HollyMusic适合喜欢在线搜索即听、不想自己整理音乐文件的用户，而Navidrome更适合已有完整FLAC曲库、喜欢自己整理音乐的用户。HollyMusic不是Navidrome的替代品。
如何在NAS上部署HollyMusic？
使用Docker Compose部署，需要创建docker-compose.yml文件，包含镜像ghcr.milu.moe/redcath/hollymusic:latest，映射端口3099:3000，设置环境变量如DATABASE_URL、ENABLE_FILE_CACHE等，并挂载相关目录。
HollyMusic支持哪些音源？
HollyMusic兼容洛雪音乐自定义源API2.0.0，已有的洛雪.js音源大多可以直接复用，但需要自备音源，项目不提供内置音源。
HollyMusic支持多用户吗？
支持，每个用户的收藏、歌单和播放历史相互隔离，适合部署一次给家人一起使用。
HollyMusic有哪些缓存和下载功能？
支持服务端音频缓存和HTTP Range，可暂停、恢复、拖动进度；多用户共享缓存，容量达到限制自动清理旧文件。如果音源支持，还可以下载，甚至下载flac格式的Hi-Res文件。
HollyMusic支持移动端和第三方客户端吗？
支持PWA，配置HTTPS后可添加到桌面，锁屏和通知栏可控制播放；同时兼容Subsonic协议，可连接DSub、Ultrasonic等第三方客户端。
HollyMusic有AI功能吗？
有，配置OpenAI兼容接口后可以用自然语言辅助生成歌单，但这是附加功能，不配置也不影响正常听歌。
