xiaomusic配置指南3条Docker命令让小爱音箱播放你自己的音乐【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicxiaomusic 是一个开源服务把小爱音箱接入你自己的音乐库本地文件直接播放本地没有的歌则通过 yt-dlp 联网下载后播放全程语音控制不依赖任何在线音乐平台的会员体系。本指南按先决策、再落地、后排障的顺序带你在 Docker 上跑起来并配好设备最后列出新手最常卡住的几个坑。它和官方方案差在哪值不值得搭先明确它能做什么再决定要不要花时间音乐来源自由本地目录里的 mp3/flac/wav/ape/ogg/m4a 都能播也可以对音箱说播放歌曲某首歌让它联网下载再播语音控制完整切歌、换播放模式、定时关机等都是小爱原生交互部署成本低一个 Docker 容器占用资源很小NAS 也能常驻。和官方音乐服务的差别在于官方方案音质和曲库受平台限制xiaomusic 的曲库就是你自己说了算。代价是你要自己维护一个常驻服务并且注意该项目作者已公告停止维护社区有接力项目songloft-org/songloft可供迁移参考。如果你只是想长期稳定使用选型时把这一点算进去。结论手上有小爱音箱、有一台能常驻开机的机器NAS/旧电脑/树莓派均可、且能接受自己维护服务就值得搭。最短路径把服务跑起来推荐 Docker 方式。先建目录再写一个 compose 文件mkdir -p /xiaomusic_music /xiaomusic_confservices: xiaomusic: image: hanxi/xiaomusic # 国内拉取慢可换 docker.hanxi.cc/hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 # 左侧改成本机空闲端口右侧 8090 是容器端口不要动 volumes: - /xiaomusic_music:/app/music # 音乐目录 - /xiaomusic_conf:/app/conf # 配置目录建议和音乐分开然后执行docker compose up -d。预期结果浏览器打开http://你的机器IP:58090能看到 Web 管理面板。不想用 Docker 也可以用 pippip install -U xiaomusic后运行xiaomusic默认监听 8090 端口。配置文件参考仓库里的 config-example.json 自行整理一份即可。填账号、选设备唯一必填的两项打开面板后所有带*的配置里你真正必须填的只有两项小米账号和密码。填完保存服务会自动拉取账号下的设备列表你在列表里勾选要控制的小爱音箱保存即可。不需要手动去查 DID设备标识符也不需要通过环境变量MI_DID设置——账号保存后系统会自动获取。已测试支持的型号覆盖了 L06A、L07A、LX06、L17A、OH2 等常见小爱音箱完整清单见 README.md 的设备支持一节。预期结果面板顶部能切换设备且设备列表里出现你的音箱对音箱说一句播放歌曲音箱有语音响应即使还没放歌说明链路已通。让音箱找到你的音乐目录把音乐文件放进/xiaomusic_music目录compose 里映射的宿主机路径面板的播放列表会自动出现所有歌曲。目录支持多层结构每一层文件夹会被识别为一个播放列表按歌手-专辑建文件夹是很自然的组织方式。格式上注意部分老型号如 L05B、L05C、LX06、L16A不支持 flac。如果你的音乐里有 flac 却不出声去设置页打开转换为 MP3即可。语音口令怎么用Web 页面上可以点歌、切歌、删歌、切模式界面布局可参考下图每个区域都有标注说明但对音箱说话才是主要用法。常用口令口令效果播放歌曲周杰伦晴天本地没有就联网下载然后播放下一首 / 上一首切歌单曲循环 / 随机播放 / 顺序播放切换播放模式播放歌单收藏播放收藏列表10分钟后关机定时停止播放两个容易忽略的点语音口令开关默认是关闭的。去设置页打开获取对话记录语音口令开关口令才会生效不用时随手关掉频繁抓取对话可能触发账号风控。口令可以在设置页的口令字典里改。比如加一句放点爵士映射到playlocal字典结构参考 config-example.json 中的key_word_dict字段。新手最常卡住的三个环节现象定位解决保存账号后看不到设备列表登录失败多为代理干扰或小米风控关闭本地代理到 mi.com 官网重新登录一次做滑块验证仍不行可改用 cookie 登录。详见 docs/issues/99.md日志报 601 / illegal argument设备 DID 未配置或配错在设置页重新选择正确的设备类型和 DID 后保存网页后台能播语音控制没反应语音口令开关未开设置页打开获取对话记录开关再试网页打不开宿主机端口被占改 compose 里58090:8090左侧为本机空闲端口还有一类过段时间就看不到设备的问题通常是长时间开着语音口令高频拉取导致的同样见 docs/issues/99.md 的处理建议。排障时优先用面板底部的下载日志文件功能取日志提交前检查里面别带账号密码。可选进阶定时任务与多设备这部分按需启用即可定时播放配置crontab_json指向一个 JSON 文件按标准 crontab 表达式定时放歌甚至支持仅工作日/仅休息日触发格式说明见 docs/issues/182.md多台音箱mi_did用逗号分隔多个 DID 即可同时控制公网访问如果要把面板暴露到公网务必关闭免登录并设置强密码对应httpauth_username/httpauth_password且不建议把绑定了摄像头的小米账号用来跑这个服务。下一步行动遇到本文没覆盖的问题先查 docs/issues/99.md这是项目维护的 FAQ 集合多数报错都有现成解法功能细节与历史方案查 docs/issues/ 目录下的各篇说明需要提 bug 或建议时在项目的 issue 区提交附上设置页下载的日志文件注意先脱敏。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
