群暉部署XiaoMusic：小米音箱Pro的音樂自由之路

一、事件驅動

小愛音箱Pro進家好幾年了，雖支持語音交互與內容播放，但經常無法播放想聽的歌曲。

老婆說：“你號稱IT狂人，就不能想想辦法嘛？”

既然老婆發話了，那咱就得想辦法解決，好在找到了XiaoMusic，這是個開源的解決方案，可以使NAS與小愛音箱連接，實現播放本地音樂和自動搜索下載歌曲的功能。

二、準備工作 1. 設備及存儲

? NAS設備：群暉NAS。不好意思，賣給客戶的都是正版群暉，自己家里用個黑的；

? 存儲規劃：單獨插了塊500GB硬盤，用來存放音樂文件，想來是足夠的；

? 網絡環境：群暉NAS與小米音箱需處于同一局域網內，在不在同一個VLAN倒是無所謂。

注意：安裝XiaoMusic的時候，群暉NAS需要科學上網一次，我用的方法是，電腦上的clash開啟代理：即Allow LAN啟用。

然后群暉的網絡設置里面，代理服務器打開，填寫電腦的IP地址和代理端口就行，默認是7890端口。

2. 小米賬號及小米音箱的具體型號

? 小米賬號：需與米家APP登錄賬號一致；

? 設備型號：就在小愛音箱底部標簽，我家的是LX06。

三、部署步驟（圖文詳解） 1. Docker環境配置

1. 在群暉「套件中心」安裝Docker

2. 搜索并拉取鏡像：hanxi/xiaomusic

3. 創建容器時填寫關鍵參數： ? 環境變量（必填）：

   MI_USER=小米賬號
   MI_PASS=小米賬號的密碼
   MI_HARDWARE=LX06  # 自家的音箱型號
   XIAOMUSIC_HOSTNAME=群暉內網IP
   XIAOMUSIC_SEARCH=bilisearch:  # 啟用B站搜索

   ? 文件夾映射：

   /volume1/music:/app/music  # 本地音樂存儲路徑

   ? 端口映射：8090:8090（默認端口）

   
   

1. 訪問 http://群暉IP:8090 進入管理界面，點擊「懷舊主題」

2. 勾選音箱型號，確認賬號密碼、端口、目錄等設置；
   

3. 保存后通過「測試播放」驗證連接狀態，如果有聲音，表示配置成功。

? 支持FLAC/WAV/MP3等格式，無損播放NAS中存儲的歌曲以及有聲讀物等。 ? 自動創建JSON歌單，支持語音指令，比如：“播放歌曲鄭智化的星星點燈”，如果本地沒有這首歌曲，會觸發自動下載，然后再播放，并且添加到列表。

2. 手機點播，一樣方便

? 自適應頁面，支持手機登錄，可點播、可下載，也可創建不同的播放列表，很方便。

五、常見問題 音箱無響應

? 檢查網絡是否通暢群；

? 檢查8090端口是否有響應；

? 確認賬號密碼是否正確；

? 確認設備型號與米家APP是否一致。

總結：在群暉上部署XiaoMusic，成功為老婆打造了個性化的樂庫，得好評一個。