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