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

哈喽，大家好！最近听歌是不是老遇到版权问题？想听的歌不是没了就是收费，真让人头大！今天跟大家分享一个好东西：QM-Music。有了它，咱也能搭个自己的音乐小窝，想听啥就听啥，再也不用看平台的脸色啦！

🏷️ QM-Music 是个啥？

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

它有啥好处呢？

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

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

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

方法一：用 docker run

docker run -d \
  --name qm-music \
  -p 6688: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 \
  -e QM_FFMPEG_ENABLE=true \
  -e TZ=Asia/Shanghai \
  -e QM_REFRESH_AUTO=true \
  --restart unless-stopped \
  qmmusic/qm-music:latest

方法二：用 docker-compose

services:
  qm-music:
    container_name: qm-music
    image: qmmusic/qm-music:latest
    ports:
      - "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=true
    restart: 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`	放缓存文件的文件夹