值友们好！今天给大家安利一个让我NAS彻底物尽其用的开源项目——HollyMusic

很多值友买了NAS之后，主要用途就是存照片、看电影、跑Docker。但你知道吗？NAS 7×24小时在线的能力，完全可以让你自建一个全网音乐聚合服务器，从此告别各种音乐APP的会员订阅。

HollyMusic是什么？

HollyMusic是一套自部署的在线音乐聚合播放器，直接兼容洛雪音乐自定义音源API 2.0.0。简单来说，你手里已有的那些洛雪.js音源文件，HollyMusic能直接复用，不需要重新找一套资源。

跟传统的Navidrome、Jellyfin不同，HollyMusic的核心思路是：不只是管理本地曲库，而是聚合不同来源的在线音源，同时把账号、收藏、歌单和播放历史全部留在你自己的服务器里。

为什么值友应该部署HollyMusic？

说白了就是三个字：省、私、稳。

• 省钱：各种音乐APP的会员费加起来一年少说几百块，HollyMusic开源免费，一次部署终身使用
• 隐私：所有数据存在你自己的NAS上，播放历史、收藏歌单不会被第三方平台记录分析
• 稳定：NAS 7×24小时在线，随时打开浏览器就能听，不受APP更新、服务下架影响

核心功能一览

Docker部署教程（NAS通用）

HollyMusic已经提供了官方Docker镜像，部署起来非常简单。以下是在NAS上通过Docker Compose部署的完整配置：

services:
  app:
    image: ghcr.milu.moe/redcath/hollymusic:latest
    container_name: holly-music
    ports:
      - "3099:3000"
    env_file:
      - .env
    environment:
      - NODE_ENV=production
      - DATABASE_URL=file:./prisma/data/music.db
      - ENABLE_FILE_CACHE=true
      - AUDIO_CACHE_DIR=/app/.cache/audio-cache
      - AUDIO_CACHE_QUOTA_GB=2
    volumes:
      - ./custom-sources:/app/custom-sources
      - ./config:/app/config
      - ./prisma_data:/app/prisma/prisma/data
      - ./cache_data:/app/.cache
      - ./app_logs:/app/logs
    restart: unless-stopped

部署步骤：

1. 在NAS上创建HollyMusic文件夹
2. 创建.env文件，填入AUTH_SECRET（可用AI生成随机字符串）
3. 将上述Compose配置粘贴到NAS的Docker管理界面
4. 端口3099如果被占用，修改冒号前面的数字即可
5. 启动后浏览器访问 NAS_IP:3099，首次登录后立即修改默认密码

实际使用体验

部署完成后，HollyMusic的完成度比预期高不少：

• 搜索、收藏、播放历史、歌词和歌单这些基础功能齐全
• 服务端音频缓存支持HTTP Range，暂停、恢复、拖动进度都很流畅
• 多用户共享缓存，家里人一起用也不会重复加载
• 移动端PWA支持，配置HTTPS后可以直接添加到桌面，锁屏和通知栏都能控制播放
• 兼容Subsonic协议，可以接DSub、Ultrasonic等第三方客户端

优缺点总结

课代表推荐

如果你是NAS用户，HollyMusic几乎是必装项目。它的思路跟Immich替代Google Photos一样——把云端订阅制服务变成自托管方案。

但要注意两点：

1. HollyMusic并不替代Navidrome等本地音乐管理器，两者适合不同场景：本地FLAC曲库用Navidrome，搜到就听用HollyMusic
2. 音源质量参差不齐，郥分源可能随时失效，需要定期维护

总的来说，部署一次，全家受益。NAS本来就是7×24小时在线的，不拿来听歌简直浪费。值友们赶紧试试吧！