
QM-Music 是一个基于 Subsonic 协议的轻量级私有云音乐服务器,目标是让你把自己的音乐文件变成可远程访问、可被多种客户端连接的个人曲库。它支持 Docker 一键部署,并兼容音流、Feishin、Amperfy、Substreamer、Music Assistant 等 Subsonic 生态客户端。
README 里强调它面向个人音乐库:音乐文件挂载到 `/data/qm-music/music_dir`,数据库和缓存分别挂载到对应目录,服务默认端口为 6688。首次进入管理界面后,需要立刻修改默认管理员密码,再刷新曲库,让系统解析音乐元数据。
轻量自托管的 Subsonic 服务
功能上,QM-Music 支持 Docker 容器化、约 150MB 内存占用、Subsonic API 兼容、MP3/FLAC/AAC/WAV 等多格式、按需音频转码、播放历史、收藏、歌单、歌词、全局搜索、专辑/艺术家/流派分类,以及对中文曲库友好的繁简互搜和排序优化。
生态扩展方面,它可以接入 Spotify、Last.fm、酷狗等元数据来源;转码依赖 FFMPEG,可通过 `QM_FFMPEG_ENABLE=true` 启用;曲库定时刷新、播放记录清理和保留月份也都有环境变量控制。项目还提供 Docker run 和 docker compose 示例。
截至 2026 年 6 月 5 日,GitHub API 显示 qm-music 有 559 stars,使用 Apache-2.0 协议,主要语言为 Java,最近 push 在 2026 年 5 月 28 日。仓库 topics 包括 music、music-server、self-hosted 和 subsonic-server。
需要注意的是,QM-Music 适合管理和播放你有权使用的个人音乐文件,不是在线音乐资源站。公开暴露服务前,也要处理好账号密码、反向代理、HTTPS 和音乐版权边界。
项目地址
项目地址:https://github.com/chenqimiao/qm-music
原创文章,如若转载,请注明出处:https://wefound.cc/p/4815.html