本期來介紹一款自有音樂服務器:QM-Music。
目前NAS原生的音樂服務,沒有一款是讓筆者滿意的。我個人一直在使用Navidrome,最近逛論壇又看到這個新項目,部署來體驗了下還挺不錯,就分享下部署方法,給大家提供更多選擇。以下圖片截自項目頁面。
![]()
項目介紹
這個項目其實就是Navidrome的超輕量化替代品,體驗還好。
完整項目名:chenqimiao/qm-music,可於GHUB搜索。
另外還有個播放器項目:gitbobobo/StreamMusic,音流,大家應該早聽說過,各個端都有。
QM-Music 是一個基於 Subsonic 構建的輕量級私有云音樂服務器,專爲音樂愛好者設計的輕量級高性能解決方案。支持 Docker 一鍵部署,完美兼容 Subsonic 生態客戶端(如音流/Amperfy/substreamer/feishin/music-assistant),讓您隨時隨地安全訪問個人音樂庫。
🚨 免責聲明:本項目僅供學習和研究目的,不得用於任何商業活動。用戶在使用本項目時應遵守所在地區的法律法規,對於違法使用所導致的後果,本項目及作者不承擔任何責任。 本項目可能存在未知的缺陷和風險(包括但不限於設備損壞和賬號封禁等),使用者應自行承擔使用本項目所產生的所有風險及責任。 作者不保證本項目的準確性、完整性、及時性、可靠性,也不承擔任何因使用本項目而產生的任何損失或損害責任。 使用本項目即表示您已閱讀並同意本免責聲明的全部內容。
核心特性
🐳 Docker 容器化部署 - 快速啓動,零環境依賴
🌱 輕量級部署 - 僅需約150MB內存佔用,低資源消耗
🎧 Subsonic 協議兼容 - 可在支持 subsonic api 的客戶端連接使用
⚡ 高性能媒體服務 - 低延遲流媒體傳輸
🔄 智能轉碼支持 - 按需開啓 libmp3lame/acc 轉碼節省流量
📁 多格式支持 - 全面兼容 MP3/FLAC/AAC/WAV 等格式
🔒 私有化部署 - 完全掌控您的音樂數據
🇨🇳 中文曲庫友好 - 支持繁簡字互搜,中文排序/檢索優化
後續開發路線:支持外置數據庫,跨平臺客戶端開發,Web 播放器功能增強,單元測試覆蓋率提升。
準備工作
其實這裏就兩個KEY,如果你不想搞便可跳過。
聲破天
![]()
![]()
LAST FM
![]()
部署流程
本文以威聯通NAS爲例,通過Docker Compose的方式進行部署。
部署代碼如下,複製若出現格式錯誤,請藉助AI排版:
services:
qm-music:
container_name: qm-music
image: qmmusic/qm-music:latest
ports:
- "6688:6688"
volumes:
- /share/media/music:/data/qm-music/music_dir # 音樂目錄
- /share/Container/qmmusic/db:/data/qm-music/db # 數據庫與元數據目錄
- /share/Container/qmmusic/cache:/data/qm-music/cache # 緩存文件目錄
environment:
- QM_FFMPEG_ENABLE=true # 啓用智能音頻轉碼(推薦在戶外使用的用戶開啓)
- TZ=Asia/Shanghai # 請務必根據所在地區設置
# 非必須
- QM_REFRESH_AUTO=true # 定時刷新曲庫,默認開啓且兩小時自動刷新
- QM_CLEAN_PLAY_HISTORY_AUTO=true # 定時清理播放記錄開關,默認開啓
- QM_SAVE_PLAY_HISTORY_MONTH=24 # 保留播放記錄月份數,默認24
# 聲破天,非必須
- QM_SPOTIFY_ENABLE=true # 開啓獲得更多元數據支持
- QM_SPOTIFY_CLIENT_ID= # 啓用則都需要填寫
- QM_SPOTIFY_CLIENT_SECRET=
# last.fm,非必須
- QM_LASTFM_ENABLE=true # 開啓獲得更多元數據支持
- QM_LASTFM_API_KEY=
restart: always
打開Container Station,創建新的應用。
![]()
使用介紹
部署完畢後,瀏覽器輸入 NAS_IP:6688 即可訪問服務。
![]()
默認的賬戶密碼皆爲admin。
![]()
提示修改密碼。改掉後需要重新登錄。
第一次,登錄進來後臺,手動點擊刷新曲庫。
![]()
這裏以iPhone爲例,下載了音流。如下圖所示,進行連接。如果外網用就填寫域名,有端口號也要填上。
![]()
因爲我部署時加入了聲破天這些的KEY,聯網獲得元數據,得到的效果如下。

最後
感謝觀看,本文完。
更多遊戲資訊請關註:電玩幫遊戲資訊專區
電玩幫圖文攻略 www.vgover.com
