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格式,“调试工具”查看设备连接状态。