QM-Music 

如果你有一套本地音乐库，希望随时随地通过手机或电脑安全访问，又不想依赖 Spotify、Apple Music 等第三方平台，那么 QM-Music 或许是你一直在找的解决方案。

这是一个基于 Subsonic 协议构建的轻量级私有云音乐服务器，专为音乐爱好者设计：资源占用极低、部署简单、兼容主流客户端，且完全由你掌控数据。

为什么选择 QM-Music？

• 轻量高效：运行内存仅约 150MB，低配设备（如树莓派、旧 NAS）也能流畅运行
• 一键部署：通过 Docker 容器化发布，无需配置环境
• 协议兼容：完整支持 Subsonic API，可直接使用 音流、Feishin、Amperfy、Substreamer、Music Assistant 等成熟客户端
• 格式全面：支持 MP3、FLAC、AAC、WAV 等主流音频格式
• 私有安全：所有音乐文件与元数据均存储在本地，无数据外传风险

核心功能一览

🎧 播放体验

• 智能转码（可选）：启用后，根据网络状况自动将高码率音频转为 MP3 或 AAC 流，显著节省移动流量
• 歌词同步：自动匹配本地或在线歌词，支持滚动显示
• 多用户支持：可创建独立账号，分配不同权限
• 播放历史与收藏：实时记录偏好，支持个性化歌单管理

🗂️ 音乐管理

• 自动刷新曲库：开启后，系统会定时扫描音乐目录，新增或修改的文件自动纳入库中
• 元数据精准解析：基于 ID3 标签识别艺术家、专辑、流派等信息
• 多维浏览：按专辑、艺术家、流派分类，支持全局关键词搜索
• 智能推荐：基于风格推荐相似歌曲与艺人

🔒 隐私与控制

• 所有数据（包括数据库、缓存、音频文件）均存储在你指定的本地路径
• 默认提供管理员账户（首次登录后务必修改密码）
• 无外部依赖（元数据、推荐等功能可完全离线运行）

快速部署（Docker）

方法一：docker run

docker run -d \
  --name qm-music \
  -p 6688:6688 \
  -v /your/music:/data/qm-music/music_dir \
  -v /your/db:/data/qm-music/db \
  -v /your/cache:/data/qm-music/cache \
  -e QM_FFMPEG_ENABLE=true \
  -e TZ=Asia/Shanghai \
  -e QM_REFRESH_AUTO=true \
  --restart unless-stopped \
  qmmusic/qm-music:latest

方法二：docker-compose.yml

version: '3'
services:
  qm-music:
    container_name: qm-music
    image: qmmusic/qm-music:latest
    ports:
      - "6688:6688"
    volumes:
      - /your/music:/data/qm-music/music_dir
      - /your/db:/data/qm-music/db
      - /your/cache:/data/qm-music/cache
    environment:
      - QM_FFMPEG_ENABLE=true
      - TZ=Asia/Shanghai
      - QM_REFRESH_AUTO=true
    restart: unless-stopped

注意：

• 将 /your/music 等路径替换为你的实际目录
• 首次启动后访问 http://[服务器IP]:6688，使用默认账号 admin/admin 登录，并立即修改密码

配置说明（关键环境变量）

Spotify / Last.fm 集成为可选功能，如需增强元数据（如专辑封面、艺人介绍），可申请对应 API Key 并启用，非必需。

客户端连接

在任意 Subsonic 兼容客户端（如 Feishin、音流、Amperfy）中添加服务器：

• 服务器地址：http://[你的服务器IP]:6688
• 用户名/密码：你在网页端设置的管理员或子账号

连接后即可在手机、平板、电脑上无缝播放、创建歌单、查看歌词。

未来规划

项目团队已公布初步路线图，包括：

• 支持外置数据库（如 PostgreSQL/MySQL）
• 开发官方 Web 播放器增强版
• 推出跨平台原生客户端
• 提升单元测试覆盖率，保障长期稳定性

适合谁用？

• 拥有大量本地无损音乐（FLAC/WAV）的发烧友
• 希望摆脱流媒体平台限制的用户
• 在 NAS、树莓派或低功耗服务器上搭建家庭媒体中心的人
• 注重隐私、不愿将听歌数据交给第三方的用户

QM-Music 不追求花哨功能，而是专注做好一件事：让你安全、高效、低成本地访问自己的音乐库。