五分钟搞定！用 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 可以通过环境变量和文件夹来设置：

环境变量：

变量名	作用
`QM_FFMPEG_ENABLE`	开启后，可以根据网络情况自动切换音频编码，省流量（推荐开启）
`TZ`	记得改成你所在的地区
`QM_SPOTIFY_ENABLE`	开启后，可以获得更多歌曲信息，需要配置`QM_SPOTIFY_CLIENT_ID`和`QM_SPOTIFY_CLIENT_SECRET`
`QM_LASTFM_ENABLE`	开启后，可以获得更多歌曲信息，需要配置`QM_LASTFM_API_KEY`
`QM_REFRESH_AUTO`	自动刷新曲库，默认是打开的
`QM_CLEAN_PLAY_HISTORY_AUTO`	自动清理播放记录，默认是打开的
`QM_SAVE_PLAY_HISTORY_MONTH`	保留播放记录的时间，默认是 24 个月

文件夹：

路径	作用
`/data/qm-music/music_dir`	放音乐文件的文件夹
`/data/qm-music/db`	放数据库文件的文件夹（别放其他东西）
`/data/qm-music/cache`	放缓存文件的文件夹