XiaoMusic 是一個(gè)開(kāi)源項(xiàng)目，旨在通過(guò)小愛(ài)音箱播放音樂(lè)，支持本地和網(wǎng)絡(luò)音樂(lè)資源的無(wú)縫整合。該項(xiàng)目允許用戶通過(guò)語(yǔ)音命令控制播放，如播放歌曲、上一首、下一首、單曲循環(huán)、全部循環(huán)、隨機(jī)播放等。XiaoMusic 使用 yt-dlp 下載音樂(lè)文件，支持多種音頻格式，包括 mp3、flac、wav、ape、ogg、m4a 等。

• XiaoMusic官網(wǎng)入口網(wǎng)址：https://xdocs.hanxi.cc/
• XiaoMusic開(kāi)源項(xiàng)目地址：https://github.com/hanxi/xiaomusic
• XiaoMusic安裝部署說(shuō)明：https://xdocs.hanxi.cc/issues/
• 如果你看不懂官方提供的教程，可以在網(wǎng)上搜索其他網(wǎng)友分享的XiaoMusic相關(guān)教程，你也可以點(diǎn)擊：鏈接，查看b站相關(guān)博主分享的XiaoMusic安裝部署視頻教程。

功能特點(diǎn)

• 語(yǔ)音控制：用戶可以通過(guò)小愛(ài)音箱的語(yǔ)音指令控制播放，如“播放歌曲陳奕迅十年”或“下一首”。
• 本地與網(wǎng)絡(luò)音樂(lè)支持：XiaoMusic 支持本地音樂(lè)文件和網(wǎng)絡(luò)音樂(lè)資源的播放。如果本地沒(méi)有特定歌曲，系統(tǒng)會(huì)自動(dòng)從 B 站或 YouTube 下載并存儲(chǔ)為 MP3 格式 。
• Docker 部署：XiaoMusic 可以通過(guò) Docker 容器進(jìn)行部署，支持多種 NAS 設(shè)備（如威聯(lián)通、綠聯(lián)、飛牛、群暉等）的快速安裝和配置。用戶可以通過(guò) Docker Compose 文件指定鏡像、重啟策略、掛載路徑和環(huán)境變量 。
• Web 管理界面：XiaoMusic 提供了一個(gè) Web 管理界面，用戶可以通過(guò)瀏覽器訪問(wèn)，進(jìn)行音樂(lè)管理、播放列表配置、設(shè)備設(shè)置等操作 。
• 自定義口令：用戶可以設(shè)置自定義口令，通過(guò)語(yǔ)音指令調(diào)用特定功能，如“播放歌曲”或“停止播放”。
• 歌單管理：XiaoMusic 支持 JSON 格式的歌單管理，用戶可以輕松創(chuàng)建和管理自己的音樂(lè)庫(kù) 。
• 安全設(shè)置：為了確保安全，建議開(kāi)啟密碼登錄并設(shè)置復(fù)雜密碼，避免在公共場(chǎng)所的 WiFi 環(huán)境下使用 。

部署與配置

1. Docker 部署：用戶可以通過(guò) Docker Compose 文件快速部署 XiaoMusic。例如，在 NAS 上創(chuàng)建一個(gè) docker-compose.yml 文件，指定鏡像、端口映射、卷掛載和環(huán)境變量 。
2. 環(huán)境變量配置：XiaoMusic 支持多種環(huán)境變量配置，如 MI_USER（小米賬號(hào)）、MI_PASS（小米密碼）、XIAOMUSIC_SEARCH（指定音樂(lè)來(lái)源，如 B 站或 YouTube）等 。
3. 音樂(lè)文件管理：用戶可以將音樂(lè)文件存儲(chǔ)在 NAS 的指定目錄中，XiaoMusic 會(huì)自動(dòng)掃描并播放這些文件。如果本地沒(méi)有特定歌曲，系統(tǒng)會(huì)自動(dòng)從網(wǎng)絡(luò)下載 。
4. Web 界面訪問(wèn)：用戶可以通過(guò)瀏覽器訪問(wèn) XiaoMusic 的 Web 管理界面，進(jìn)行播放列表管理、設(shè)備設(shè)置等操作。默認(rèn)端口通常是 8090 或 58090 。

社區(qū)與支持

XiaoMusic 有一個(gè)活躍的社區(qū)，用戶可以通過(guò) GitHub 倉(cāng)庫(kù)提交問(wèn)題、報(bào)告錯(cuò)誤或提出建議。此外，項(xiàng)目還提供了 QQ 群和交流群，方便用戶交流和獲取幫助。

XiaoMusic 是一個(gè)功能強(qiáng)大且靈活的開(kāi)源項(xiàng)目，旨在通過(guò)小愛(ài)音箱播放音樂(lè)，支持本地和網(wǎng)絡(luò)音樂(lè)資源的無(wú)縫整合。通過(guò) Docker 部署和 Web 管理界面，用戶可以輕松管理和控制音樂(lè)播放。該項(xiàng)目不僅解決了小愛(ài)音箱播放源受限的問(wèn)題，還推動(dòng)了開(kāi)源精神和網(wǎng)絡(luò)共享文化的發(fā)展 。