在NAS上安装XiaoMusic：让小爱音箱播放NAS音乐的完整指南

XiaoMusic是一款开源工具，让小爱音箱可以播放NAS中的本地音乐，无需会员即可收听完整歌曲，并支持自动下载网络歌曲。它通过Docker部署，完美连接小爱音箱与NAS音乐库。

准备工作

1. 必备条件：

- 一台支持Docker的NAS（群晖、威联通、绿联、极空间、飞牛等）

- 至少一台小爱音箱（支持多种型号，如L06A、L07A、S12等）

- 小米账号（建议不要使用同时绑定摄像头的账号）

2. 创建目录：

在NAS上创建一个文件夹（如 xiaomusic ），在其中再创建两个子文件夹：

-  music ：存放音乐文件

-  conf ：存放配置文件

Docker部署步骤（推荐）

方法一：使用Docker Compose（最简单）

1. 打开NAS的Docker管理界面

2. 进入"Compose"页面，点击"新增项目"

3. 项目名称：填写"xiaomusic"

4. 路径：选择刚才创建的 xiaomusic 文件夹

5. 勾选"创建docker-compose.yml"，点击"确定"

6. 在编辑界面中粘贴以下代码：

services:
  xiaomusic:
    image: docker.hanxi.cc/hanxi/xiaomusic  # 国内镜像加速
    container_name: xiaomusic
    restart: unless-stopped
    ports:
      - 58090:8090  # 端口映射，主机端口:容器端口
    environment:
      XIAOMUSIC_PUBLIC_PORT: 58090  # 对外访问端口
    volumes:
      - /你的NAS路径/xiaomusic/music:/app/music  # 音乐目录映射
      - /你的NAS路径/xiaomusic/conf:/app/conf  # 配置目录映射

7. 修改映射路径：将 /你的NAS路径 替换为实际创建的路径

8. 勾选"创建后立即启动"，点击"确定"

9. 等待2-3分钟，直到容器状态显示"运行中"

网页界面操作（访问 http://NAS的IP:58090 ）

在网页里可以管理音乐和配置：

1. 查看音乐库：主页会显示NAS里 music 文件夹的所有歌曲，支持按歌手、专辑分类。

2. 管理歌单：可以手动创建、编辑歌单，把NAS里的歌曲添加进去。

3. 上传cookie文件：如果要下载YouTube/B站的歌曲，在“上传yt_dlp_cookies.txt文件”按钮上传对应平台的cookie（获取方法可以搜“yt-dlp cookies获取”）。

4. 工具功能：用“歌曲下载工具”手动下载歌曲到NAS，“m3u转换”把歌单转为m3u格式，“调试工具”查看设备连接状态。