五分钟搞定！用 QM-Music 搭建你的私人音乐服务器！

🏷️ QM-Music 是个啥？

简单说，QM-Music 就是一个能让你自己建个“私人音乐库”的工具。它用的是 Subsonic 协议，就像你用网易云或者 QQ 音乐一样，在手机、电脑上都能随时听自己的歌。

它有啥好处呢？

• 自己的地盘
  ：音乐都在自己手里，再也不用担心哪天突然下架了。
• 兼容性好
  ：像音流、Amperfy 这些 Subsonic 客户端都能用。
• 轻巧方便
  ：不占地方，随便一台电脑都能跑起来。
• Docker 部署
  ：安装特别简单，几分钟就能搞定。

🏷️ 快速开始：Docker 几行命令搞定

QM-Music 最方便的就是 Docker 部署了，简直是懒人福音！几行命令就能搭起来：

方法一：用docker run

docker run -d--name qm-music -p6688:6688 -v[host_music_file_path]:/data/qm-music/music_dir -v[host_path_db_path]:/data/qm-music/db -v[host_path_cache_path]:/data/qm-music/cache -eQM_FFMPEG_ENABLE=true -eTZ=Asia/Shanghai -eQM_REFRESH_AUTO=true --restart unless-stopped   qmmusic/qm-music:latest

方法二：用docker-compose

services:qm-music:container_name: qm-musicimage: qmmusic/qm-music:latestports:-"6688:6688"volumes:-[host_music_file_path]:/data/qm-music/music_dir-[host_path_db_path]:/data/qm-music/db-[host_path_cache_path]:/data/qm-music/cache environment:- QM_FFMPEG_ENABLE=true- TZ=Asia/Shanghai- QM_REFRESH_AUTO=truerestart: unless-stopped

几个小提示：

• [host_music_file_path]
  换成你放音乐的文件夹。
• [host_path_db_path]
  换成你放数据库文件的文件夹。
• [host_path_cache_path]
  换成你放缓存文件的文件夹。
• QM_FFMPEG_ENABLE=true
  建议打开，这样能帮你省流量。
• TZ=Asia/Shanghai
  记得改成你所在的地区。

🏷️ 简单配置：环境变量和文件夹

QM-Music 可以通过环境变量和文件夹来设置：

环境变量：

文件夹：

🏷️ 开始使用：登录和刷新

建好之后就可以用了：

1. 打开网页：在浏览器里输入http://[Server IP]:[Port]，比如http://192.168.1.100:6688。

2. 登录：

• 用户名：admin
• 密码：admin

🏷️ 连接客户端：随时听歌

在音流/feishin/Amperfy/substreamer/music-assistan这些客户端里填上：

• 服务器地址:http://[服务器IP]:6688
• 账户: 改过后的管理员账号
• 密码: 改过后的管理员密码

就可以随时随地听自己的歌啦！