TimeAmber
剪藏#剪藏#高等精灵实验室

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

2025 年 9 月 29 日 约 1 分钟
分享Twitter / XTelegram微博
五分钟搞定！用 QM-Music 搭建你的私人音乐服务器！ 封面

Notion image

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

🏷️ QM-Music 是个啥？

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

它有啥好处呢？

  • 自己的地盘：音乐都在自己手里，再也不用担心哪天突然下架了。

  • 兼容性好：像音流、Amperfy 这些 Subsonic 客户端都能用。

  • 轻巧方便：不占地方，随便一台电脑都能跑起来。

  • Docker 部署：安装特别简单，几分钟就能搞定。

Notion image

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

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

方法一：用**docker run**

JAVASCRIPT
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**

JAVASCRIPT
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 放缓存文件的文件夹

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

建好之后就可以用了：

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

  2. 登录：

  3. 用户名：admin密码：admin

  4. 赶紧改密码！

  5. 去「曲库管理」点一下【刷新曲库】。

  6. 等它扫描完（可以看日志）。

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

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

  • 服务器地址: http://[服务器IP]:6688

  • 账户: 改过后的管理员账号

  • 密码: 改过后的管理员密码

Notion image

Notion image

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

原创不易，如果觉得此文对你有帮助，不妨点赞+收藏+关注，你的鼓励是我持续创作的动力！

Notion image

原文地址: https://mp.weixin.qq.com/s?__biz=MzA4MjkzMTcxMg==&mid=2449047769&idx=1&sn=dc861d9280157207f02fab2e0a0ff7d6&chksm=8aaf1d39b8fcca0a7e94e36214764468f2da2a62eb83782957fa0f8427b703eadde37d0881d2&mpshare=1&scene=1&srcid=0929pu8h4kmwjdnWnqaULB9N&sharer_shareinfo=596ce23cafc3f858237cc3cd34caf6aa&sharer_shareinfo_first=596ce23cafc3f858237cc3cd34caf6aa#rd

相关文章