如何讓小愛(ài)音箱免費(fèi)放歌XiaoMusic 本地音樂(lè)服務(wù)器部署指南【免費(fèi)下載鏈接】xiaomusic使用小愛(ài)音箱播放音樂(lè)音樂(lè)使用 yt-dlp 下載。項(xiàng)目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是面向小愛(ài)音箱的開(kāi)源音樂(lè)服務(wù)器部署在 NAS 或家里任意一臺(tái)常開(kāi)的機(jī)器上它用 yt-dlp一個(gè)開(kāi)源音視頻下載工具把歌曲下載下來(lái)讓音箱從平臺(tái)曲庫(kù)切換到你的本地曲庫(kù)。小愛(ài)音箱自帶的音樂(lè)服務(wù)綁在平臺(tái)上部分歌曲提示需要會(huì)員曲庫(kù)隨時(shí)變動(dòng)孩子想聽(tīng)的故事也不穩(wěn)定。更關(guān)鍵的是這些歌曲并不留在音箱上每次都依賴平臺(tái)鏈路播放。XiaoMusic 的做法是你用語(yǔ)音報(bào)出歌名它在本地曲庫(kù)查找找不到就在線搜索并下載之后播放就走本地文件不再受平臺(tái)限制。一、XiaoMusic 快速部署Docker 一條命令跑起來(lái)最短路徑是 Docker 部署Docker 是一種把程序連同運(yùn)行環(huán)境打包成鏡像的容器工具NAS 上一般預(yù)裝docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic三個(gè)參數(shù)各管一件事58090:8090是端口映射58090 用主機(jī)上空閑的端口即可8090 是服務(wù)內(nèi)部端口不要改兩個(gè)-v分別把音樂(lè)目錄和配置目錄映射到主機(jī)建議分開(kāi)存放。國(guó)內(nèi)網(wǎng)絡(luò)環(huán)境可將鏡像換成docker.hanxi.cc/hanxi/xiaomusic。如果報(bào)目錄不存在先執(zhí)行mkdir -p /xiaomusic_music /xiaomusic_conf建好再啟動(dòng)。習(xí)慣 Python 環(huán)境的話也可以用 pip 方式pip install -U xiaomusic xiaomusic --config config.jsonconfig.json直接照倉(cāng)庫(kù)里的 config-example.json 改。二、配置小米賬號(hào)只有兩處必填服務(wù)起來(lái)后瀏覽器訪問(wèn)http://NAS_IP:58090進(jìn)入 Web 后臺(tái)配置只有兩步在設(shè)置頁(yè)填入小米賬號(hào)和密碼帶*號(hào)的項(xiàng)是必填項(xiàng)保存后頁(yè)面會(huì)拉取到你的音箱設(shè)備列表。確認(rèn)音樂(lè)存放目錄其余配置項(xiàng)不用時(shí)保持默認(rèn)即可。保存賬號(hào)前看不到設(shè)備列表是正常的這是設(shè)計(jì)如此。如果登錄失敗日志里提示 Login FailedFAQ 里列了常見(jiàn)解法關(guān)本地代理、米家 App 重新登錄、或在小米官網(wǎng)完成一次人臉/滑塊驗(yàn)證詳見(jiàn) docs/issues/99.md。三、語(yǔ)音口令你能對(duì)音箱說(shuō)什么部署后對(duì)音箱直接說(shuō)這些就行“播放歌曲周杰倫晴天”核心玩法。先在本地曲庫(kù)匹配沒(méi)有就在線搜索用 yt-dlp 下載成 mp3 后播放下次再點(diǎn)同一首就是純本地速度?！吧弦皇?/ 下一首 / 暫停 / 關(guān)機(jī)”基礎(chǔ)播放控制。“單曲循環(huán) / 全部循環(huán) / 隨機(jī)播放”切換播放模式音箱會(huì)用 TTS 語(yǔ)音確認(rèn)。“播放歌單其他”播放音樂(lè)目錄下指定子目錄的全部歌曲目錄名即歌單名?！凹尤胧詹?/ 取消收藏”把當(dāng)前歌加入或移出收藏歌單?？诹钤~本身可以改。配置文件里的user_key_word_dict段把任意短語(yǔ)映射到命令還支持exec#code1(...)、exec#httpget(...)這類寫法去調(diào)用自定義函數(shù)倉(cāng)庫(kù) plugins/ 目錄帶了兩份示例插件TTS 播報(bào)、發(fā)起 HTTP 請(qǐng)求照著寫就能給自己的音箱加專屬指令。四、本地歌單與網(wǎng)絡(luò)歌單兩種曲庫(kù)來(lái)源本地庫(kù)掃描音樂(lè)目錄下的 mp3、flac、wav、ape、ogg、m4a 文件生成歌單下載的歌曲統(tǒng)一是 mp3。已知 L05B、L05C、LX06、L16A 等型號(hào)不能直接播 flac遇到這種情況在設(shè)置里打開(kāi)“轉(zhuǎn)換為 MP3”即可。除本地文件外XiaoMusic 還支持配置一個(gè) json 格式的網(wǎng)絡(luò)歌單電臺(tái)和歌曲都可以放也可以直接用別人分享的鏈接。倉(cāng)庫(kù)自帶 m3u 文件轉(zhuǎn)換工具能把 m3u 電臺(tái)文件轉(zhuǎn)成網(wǎng)絡(luò)歌單格式具體用法見(jiàn) docs/issues/78.md。五、Web 后臺(tái)XiaoMusic 管理界面能做什么后臺(tái)頁(yè)面承擔(dān)了日常管理的絕大部分工作搜索并下載歌曲、刪除歌曲刪除先進(jìn)回收站有一次反悔機(jī)會(huì)、切換多臺(tái)音箱設(shè)備、拖動(dòng)進(jìn)度條定點(diǎn)播放底部還能看到當(dāng)前播放歌曲名、時(shí)長(zhǎng)和設(shè)備音量條。六、長(zhǎng)期使用 XiaoMusic 的建議與注意先了解維護(hù)狀態(tài)README 頂部明確標(biāo)注項(xiàng)目已停止維護(hù)不再接受新功能開(kāi)發(fā)與 bug 修復(fù)作者建議遷移到社區(qū)接力項(xiàng)目 songloft。已部署的使用不受影響但新增需求建議到接力項(xiàng)目提。安全設(shè)置不可省如果要讓后臺(tái)走公網(wǎng)訪問(wèn)務(wù)必開(kāi)啟密碼登錄并設(shè)復(fù)雜密碼同時(shí)不建議把這個(gè)小米賬號(hào)與攝像頭等設(shè)備共用賬號(hào)泄露風(fēng)險(xiǎn)會(huì)連帶擴(kuò)散。語(yǔ)音口令功能要隨手關(guān)語(yǔ)音控制依賴“獲取對(duì)話記錄”開(kāi)關(guān)頻繁拉取對(duì)話記錄可能觸發(fā)登錄失敗不聽(tīng)歌時(shí)可以在后臺(tái)把它關(guān)掉。設(shè)備兼容性README 列了 L06A、L07A、S12、LX06、LX01 等已測(cè)試型號(hào)未列出的型號(hào)一般也能播個(gè)別型號(hào)需要開(kāi)啟“特殊型號(hào)獲取對(duì)話記錄”或“型號(hào)兼容模式”遇到語(yǔ)音控制無(wú)效時(shí)優(yōu)先查 docs/issues/99.md。七、小結(jié)與入口XiaoMusic 解決的核心問(wèn)題很單一把小愛(ài)音箱的音樂(lè)來(lái)源從平臺(tái)曲庫(kù)換成你自己的本地曲庫(kù)一條 Docker 命令就能起步。項(xiàng)目說(shuō)明與完整功能列表README.md新手常見(jiàn)問(wèn)題與報(bào)錯(cuò)處理docs/issues/99.md文檔站點(diǎn)入口docs/index.md核心源碼目錄xiaomusic/【免費(fèi)下載鏈接】xiaomusic使用小愛(ài)音箱播放音樂(lè)音樂(lè)使用 yt-dlp 下載。項(xiàng)目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考