小愛一句話點播NAS裏的歌，Docker一鍵部署Songloft

XiaoMusic: 解放小愛音箱，隨心點播NAS裏的歌曲！

之前不少人會用 XiaoMusic 搭配小愛音箱，把本地音樂庫接入到智能音箱裏使用。不過最近再去看項目頁面時，發現原作者因爲精力有限已經不再繼續維護。

好在社區裏已經有新的接力項目：songloft-org/songloft。Songloft 可以除了通過智能音箱投放插件，把 NAS 上的本地音樂投放到小愛音箱播放，還有很多其他功能。這次就給大家介紹一下這個新項目的部署流程。

項目介紹

這個項目的定位是面向個人用戶的自託管音樂服務器，同樣是不提供任何實質內容的，大家可以通過付費會員開啓下載功能或者其他妙招獲取資源，存到NAS本地。

把音樂文件集中放在 NAS 中，再通過 Web 頁面、客戶端或其他播放設備訪問，形成一個屬於自己的私人音樂庫。

核心功能

• 🎵 本地音樂管理 — 掃描本地目錄，自動提取 MP3/FLAC/WAV/APE/OGG/M4A 等格式的封面和元數據

• 🧩 JS 插件體系 — 基於 QuickJS 沙箱運行，支持權限模型、健康檢查、熱更新，可自由擴展音源 / 元數據 / 設備控制等能力

• 📱 跨平臺客戶端 — Flutter 客戶端支持 Android、iOS、macOS、Windows、Linux、Web 六端

• 📦 Bundle 本地模式 — 客戶端內嵌 Go 後端，無需部署服務器，手機/電腦直接播放本地音樂

• 📺 Kodi 插件客戶端 — 支持 Xbox、Apple TV、樹莓派、Android TV 等大屏設備，專爲遙控器操作優化，帶來流暢的客廳影音體驗

• 🌐 Web 界面 — 完整版內置 Web 前端，開箱即用

• 🔑 JWT 認證 — 雙 Token 機制（Access Token + Refresh Token），支持多設備管理

• 📡 網絡歌曲 & 電臺 — 支持添加網絡音頻 URL 與電臺流，播放時透明緩存到服務端

• 🔌 完整 REST API — 內置 Swagger 文檔，方便集成和二次開發

• ⚡ 輕量高效 — Go 編寫，CGO-free，無外部依賴，適合 NAS / 樹莓派等低功耗設備

部署流程

以威聯通NAS爲例，通過Docker Compose的方式進行部署。

項目提供三種版本，我這裏直接採用完整版，部署代碼如下：

services:

   songloft:

      image: songloft/songloft:latest

      container_name: songloft

      restart: unless-stopped

      ports:

         - "58091:58091"

      volumes:

         - /share/Container/songloft/data:/app/data

         - /share/Music:/app/music # 你的NAS音樂庫目錄

      environment:

         TZ: Asia/Shanghai

         ADMIN_USERNAME: admin

         ADMIN_PASSWORD: "qnap1234" # 自定義

         LISTEN_PORT: "58091"

打開威聯通的Container Station創建新的應用程序。

使用一覽

部署完畢後，瀏覽器輸入NAS_IP:58091即可訪問服務。賬戶名爲admin，密碼則爲上文咱們自定義配置的。

因爲我當前Media目錄下還沒歌曲，因此是空白頁。

默認不會自動掃描，可在「設置」-「音樂庫管理」中配置。

其實這些都不重要，咱們來到「設置」-「擴展」-「插件商店」。

目前顯示的插件有這麼多，我們部署的主要目的是爲了連通小米音箱，找到「智能音箱」並安裝。r如果你網絡有問題，右上角的小鑰匙點擊可以切換GitHub的加速地址，也可以自定義。如果你需要更多驚喜插件，可以到項目主頁找找～

安裝完畢後，來到「設置」-「外觀設置」，如下圖將「智能音箱」手動開啓。

這時候左側欄會自動刷出「智能音箱」，我們點擊進入。點擊左上角的小齒輪，先配置地址，直接內網服務地址就行，如下圖。

觸屏版可以開啓「觸屏歌詞」，像我一樣小愛Pro開啓對話監聽即可。

語音指令也要開啓。具體指令就按照喜好設置，畢竟每個人習慣不同。

返回，右上角點擊「賬號管理」，登錄米家。

直接米家掃碼登錄就行。

登錄之後，便可出現設備，勾選會自動加入管理列表。

然後，選擇要播放的歌單，選擇設備，便可通過小愛點歌啦。

最後

感謝觀看，本文完。