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

💡截图界面
截图1 截图2 截图3 截图4 截图5 截图6 截图7 截图8 截图9 截图10 截图11 截图12


🚀 核心亮点
🐳 容器化部署,极速上手
支持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协议开源,支持自由修改与二次开发。仅限学习与研究用途,使用者须自行承担相关法律与风险责任。
