本期来介绍一款自有音乐服务器：QM-Music。

目前NAS原生的音乐服务，没有一款是让笔者满意的。我个人一直在使用Navidrome，最近逛论坛又看到这个新项目，部署来体验了下还挺不错，就分享下部署方法，给大家提供更多选择。以下图片截自项目页面。

项目介绍

完整项目名：chenqimiao/qm-music，可于GHUB搜索。

另外还有个播放器项目：gitbobobo/StreamMusic，音流，大家应该早听说过，各个端都有。

QM-Music 是一个基于 Subsonic 构建的轻量级私有云音乐服务器，专为音乐爱好者设计的轻量级高性能解决方案。支持 Docker 一键部署，完美兼容 Subsonic 生态客户端（如音流/Amperfy/substreamer/feishin/music-assistant），让您随时随地安全访问个人音乐库。

🚨 免责声明：本项目仅供学习和研究目的，不得用于任何商业活动。用户在使用本项目时应遵守所在地区的法律法规，对于违法使用所导致的后果，本项目及作者不承担任何责任。本项目可能存在未知的缺陷和风险（包括但不限于设备损坏和账号封禁等），使用者应自行承担使用本项目所产生的所有风险及责任。作者不保证本项目的准确性、完整性、及时性、可靠性，也不承担任何因使用本项目而产生的任何损失或损害责任。使用本项目即表示您已阅读并同意本免责声明的全部内容。

核心特性

🐳 Docker 容器化部署 - 快速启动，零环境依赖
🌱 轻量级部署 - 仅需约150MB内存占用，低资源消耗
🎧 Subsonic 协议兼容 - 可在支持 subsonic api 的客户端连接使用
⚡ 高性能媒体服务 - 低延迟流媒体传输
🔄 智能转码支持 - 按需开启 libmp3lame/acc 转码节省流量
📁 多格式支持 - 全面兼容 MP3/FLAC/AAC/WAV 等格式
🔒 私有化部署 - 完全掌控您的音乐数据
🇨🇳 中文曲库友好 - 支持繁简字互搜，中文排序/检索优化

后续开发路线：支持外置数据库，跨平台客户端开发，Web 播放器功能增强，单元测试覆盖率提升。

准备工作

其实这里就两个KEY，如果你不想搞便可跳过。

声破天

截屏2025-12-25 14.47.14.png
截屏2025-12-25 14.48.35 拷贝.png

LAST FM

截屏2025-12-25 14.42.21 拷贝.png

部署流程

本文以威联通NAS为例，通过Docker Compose的方式进行部署。

部署代码如下：

services:
  qm-music:
    container_name: qm-music
    image: qmmusic/qm-music:latest
    ports:
      - "6688:6688"
    volumes:
      - /share/media/music:/data/qm-music/music_dir # 音乐目录
      - /share/Container/qmmusic/db:/data/qm-music/db # 数据库与元数据目录
      - /share/Container/qmmusic/cache:/data/qm-music/cache # 缓存文件目录
    environment:
      - QM_FFMPEG_ENABLE=true # 启用智能音频转码（推荐在户外使用的用户开启）
      - TZ=Asia/Shanghai # 请务必根据所在地区设置
      # 非必须
      - QM_REFRESH_AUTO=true # 定时刷新曲库，默认开启且两小时自动刷新
      - QM_CLEAN_PLAY_HISTORY_AUTO=true # 定时清理播放记录开关，默认开启
      - QM_SAVE_PLAY_HISTORY_MONTH=24 # 保留播放记录月份数，默认24
      # 声破天，非必须
      - QM_SPOTIFY_ENABLE=true # 开启获得更多元数据支持
      - QM_SPOTIFY_CLIENT_ID= # 启用则都需要填写
      - QM_SPOTIFY_CLIENT_SECRET=
      # last.fm，非必须
      - QM_LASTFM_ENABLE=true # 开启获得更多元数据支持
      - QM_LASTFM_API_KEY=
    restart: always

打开Container Station，创建新的应用。

截屏2025-12-25 14.50.55.png