小爱音箱播放音乐指南xiaomusic 3 种部署方式把家里 NAS 变成私人音乐库【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicxiaomusic 是一个开源工具让小爱音箱播放你自己的本地音乐和网络歌曲在服务器上部署一次对音箱说播放歌曲它放的就是你音乐库里的歌语音交互能力全部保留。适合有小爱音箱、有一台 NAS 或常开电脑的用户。最短路径上手6 步从零基础到跑通 在服务器上创建两个目录mkdir -p /xiaomusic_music /xiaomusic_conf。前者放音乐后者放配置分开管理更干净。一条命令启动 Dockerdocker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic。国内网络拉不动镜像时把镜像名换成docker.hanxi.cc/hanxi/xiaomusic。浏览器打开http://服务器IP:58090在网页上填入小米账号和密码并保存页面会拉取到你的音箱设备列表。把 MP3 等音乐文件放进音乐目录或在网页的设置里修改目录路径后点刷新列表。对小爱音箱说播放歌曲听到自己的歌就代表本地播放跑通了。再说播放歌曲周杰伦晴天它会先在线搜索下载再播放说明网络歌曲功能也通了。全程不需要命令行交互配置都在网页上完成。想改参数时也可以直接编辑配置文件模板见 config-example.json。能做什么4 个日常使用场景 场景一听本地音乐库。服务会扫描音乐目录下的 mp3、flac、wav、ape、ogg、m4a 文件按目录自动归类成歌单。说播放歌单收藏、播放歌单其他就能切换播放不同文件夹。场景二在线搜歌即点即播。说播放歌曲歌名服务通过 yt-dlp 自动搜索、下载并播放下载的文件会存进下载目录下次再听就不用重新下。README 里提过一个隐藏玩法说播放歌曲小猪佩奇的故事它会把故事音频搜下来播给孩子听。场景三全语音控制播放过程。常用口令包括类别口令示例基础控制播放歌曲 / 播放歌曲歌名 / 上一首 / 下一首 / 停止播放 / 关机播放模式单曲循环 / 全部循环 / 随机播放歌单管理播放歌单目录名 / 播放歌单收藏收藏加入收藏 / 取消收藏口令完全可自定义在配置里把任意一句话映射到任意功能比如让该睡觉了触发停止播放。场景四网页端管理播放。网页上能切歌单、搜歌曲、切换设备、拖进度条、调音量还能全屏看歌词手机浏览器直接访问也能用。格式兼容性注意大部分格式都能直接播但 L05B、L05C、LX06、L16A 这几个型号不支持 flac遇到不响的情况在设置里打开转换为 MP3和型号兼容模式即可。已测试支持的型号覆盖小爱音箱、Redmi 小爱音箱 Play、Xiaomi Sound、小米音箱 Art 等十几款完整清单见 README.md。怎么选3 种部署方式对比 ⚖️方式适合人群优点代价Docker推荐新手、NAS 用户一条命令启动不装 Python镜像升级方便机器上要有 DockerNAS 基本自带Docker Compose长期生产运行restart: always自动拉起配置可版本管理、易扩展需要手写一个 YAML 文件pip 安装开发者、想改源码直接读源码、改完立即生效方便写插件需要 Python 3.8 环境自己负责升级pip 方式就两条命令pip install -U xiaomusic然后xiaomusic --config config.json启动配置文件照 config-example.json 改。默认推荐从 Docker 开始跑通后觉得不够用再考虑源码方式。新手避坑常见 4 个坑 现象网页能打开但拉不到设备列表或控制不了音箱。处理首次运行必须在网页设置里输入小米账号密码并保存设备列表才会出现确认音箱和服务器在同一局域网。现象播放状态正常但音箱没有声音。处理先看音量是否被拉到最低再确认格式是否被当前型号支持部分型号 flac 不响在设置里开启转换为 MP3和型号兼容模式后重试。现象在线搜歌下载失败或很慢。处理检查服务器出网是否正常网络受限就在设置里配置代理搜索前缀search_prefix可更换搜索源。现象音乐目录里有文件列表里却看不到。处理确认文件放在挂载到容器的目录里对应music_path放完对音箱说刷新列表或在网页上手动刷新。遇到问题可以先在网页底部点下载日志文件自查常见问题的答案汇总在 docs/issues/99.md。进阶与下一步 自定义口令和写插件配置里的key_word_dict和user_key_word_dict可以把任意口令映射到功能插件源码在 plugins/内置了 code1、httpget、httppost 等示例照着写自己的即可。网络歌单支持 JSON 格式网络歌单电台歌曲仓库里附带 m3u 转 JSON 工具用法见 docs/issues/78.md。换皮肤xiaomusic/static/ 下内置了 tailwind、pure、xplayer、soundSpace 等多套 Web 主题可按喜好切换。文档与社区docs/ 汇总了 FAQ 和各功能说明安装遇阻时优先查这里。xiaomusic 的价值很直接把只能听单一平台音乐的小爱音箱变成播你自己音乐库的播放器。有 NAS 的话照上面的 6 步做一遍今晚就能用语音听自己的歌。注意本项目已停止维护不再接受新功能开发与 bug 修复建议迁移到社区接力项目 songloft-org/songloft 获取持续更新。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考