QM-Music：专为音乐爱好者打造的轻量级私有云音乐服务器


QM-Music

是一款基于 Subsonic 协议开发的开源音乐服务器，专注于为用户提供低资源占用、高性能、全平台兼容的私有化音乐解决方案。通过 Docker 快速部署，你可以轻松在任意设备上搭建属于自己的云端音乐库，随时随地访问与播放，数据完全掌控在你手中。


💡截图界面













🚀 核心亮点


🐳 容器化部署，极速上手

支持 Docker 和 docker-compose 一键部署，无需繁琐环境配置，几分钟即可运行。


🌱 超轻资源占用

运行内存仅约 150MB，适合各类轻量服务器与本地设备。


🎧 完全兼容 Subsonic 协议

支持音流、feishin、Amperfy、substreamer、music-assistant 等客户端无缝接入。


🔄 智能音频转码

可按需启用 libmp3lame/acc 动态转码，节省移动网络流量。


📁 支持主流音频格式

全面兼容 MP3、FLAC、AAC、WAV 等格式，无需手动转换。


🔒 私有化部署，数据可控

本地存储与自建服务器实现完全的数据隐私保障。


🎧 多端用户体验优化

  • 多用户权限管理
  • 自定义播放列表与收藏夹
  • 本地/在线歌词智能同步
  • 结构化音乐展示（按专辑、歌手、流派分类）
  • 播放历史追踪与个性化偏好记录


🔍 高效的音乐管理与探索功能

  • 定时扫描目录，自动刷新曲库
  • ID3 标签与专辑元数据智能识别
  • 全局搜索功能，快速定位歌曲/专辑/歌手
  • 推荐相似歌曲与歌手，助力音乐发现
  • 支持流派筛选，探索多样化风格


⚙️ 配置灵活，支持拓展生态

QM-Music 支持丰富的环境变量设置，配合 Spotify、Last.fm 等 API 可拓展更多元数据体验。使用者可根据实际需求进行深度定制。


🖥️ 快速部署指令


Docker 一键启动：
 

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 \\
  --restart unless-stopped \\
  qmmusic/qm-music:latest


Docker Compose 示例：
 

services:
  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
    restart: unless-stopped

部署完成后，通过浏览器访问

http://[服务器IP]:6688

，使用默认账号

admin/admin

登录并立即修改密码。


📜 开源与免责声明

本项目遵循 Apache 2.0 协议开源，支持自由修改与二次开发。仅限学习与研究用途，使用者须自行承担相关法律与风险责任。

项目地址：🔗

https://github.com/chenqimiao/qm-music