让小爱音箱，放你的音乐
LyraNest XiaoAI Bridge 是律巢的音箱扩展：把一台小爱音箱连到你的 LyraNest，语音搜索并播放自己曲库里的音乐。
简介
LyraNest（律巢）是一套面向个人 NAS、家庭服务器与局域网音乐库的自托管音乐服务。LyraNest XiaoAI Bridge 是它的音箱扩展：将一台小爱音箱连接到你的 LyraNest 服务后，就可以用语音搜索并播放自己曲库中的音乐。
它能做什么
- 登录小米账号并发现局域网中的小爱音箱。
- 在管理台选择要控制的音箱，完成 LyraNest 服务连接。
- 将「播放某首歌」「下一首」「暂停」「停止」等语音请求转成曲库操作。
- 由音箱直接访问 LyraNest 的音乐流，Bridge 不转发音频数据。
- 提供播放测试、连接状态和最近语音指令记录，方便日常排查。
它和 LyraNest 的关系
LyraNest 负责保存音乐、搜索曲库、管理账号并提供播放地址；XiaoAI Bridge 负责把这些能力带给小爱音箱。它是一个独立安装、独立更新的配套应用，不会替代 LyraNest 主服务。
使用前，请先部署可正常访问的 LyraNest。小爱音箱也必须能通过局域网访问你在 Bridge 中填写的 LyraNest 地址。
下载
当前稳定版本 1.0.8。可通过GitHub 最新发行版或官网下载页 · 小爱音箱插件获取， 每个版本的改动见桥接器更新日志：
| 文件 | 适用场景 |
|---|---|
| LyraNest-XiaoAI-Bridge-1.0.8-fnos-native.fpk | 飞牛 fnOS 原生应用安装包 |
| LyraNest-XiaoAI-Bridge-1.0.8-synology-armv8.spk | 群晖 DSM ARM64 原生安装包 |
| LyraNest-XiaoAI-Bridge-1.0.8-synology-x86_64.spk | 群晖 DSM x86_64 原生安装包 |
| LyraNest-XiaoAI-Bridge-1.0.8-qnap-arm_64.qpkg | 威联通 QTS ARM64 原生安装包 |
| LyraNest-XiaoAI-Bridge-1.0.8-qnap-x86_64.qpkg | 威联通 QTS x86_64 原生安装包 |
| LyraNest-XiaoAI-Bridge-1.0.8-ugnas-arm64.upk / -ugnas-amd64.upk | 绿联 UGREEN NAS ARM64 / AMD64 原生安装包 |
| …-synology.spk / …-qnap.qpkg | 群晖 / 威联通「通用包」，不限 CPU 架构的回落包 |
| LyraNest-XiaoAI-Bridge-1.0.8-terramaster-x86_64.deb / -aarch64.deb | 铁威马 TerraMaster TOS x86_64 / ARM64 原生安装包（仅 GitHub 下载） |
| LyraNest-XiaoAI-Bridge-1.0.8-terramaster-x86_64.deb / -aarch64.deb | 铁威马 TerraMaster TOS x86_64 / ARM64 原生安装包（仅 GitHub 下载） |
| LyraNest-XiaoAI-Bridge-1.0.8-docker-image-linux-amd64.tar | Linux AMD64 / x86_64 离线 Docker 部署 |
| docker-compose.yml | Docker Compose 部署配置 |
| SHA256SUMS-1.0.8.txt | 校验下载完整性 |
安装 · 飞牛 fnOS
飞牛 NAS 用户推荐安装 FPK：
- 1下载 LyraNest XiaoAI Bridge 1.0.8 FPK。
- 2在飞牛应用中心选择手动安装，上传 FPK 并完成安装。
- 3在应用设置中选择未被占用的访问端口，默认是
18090。 - 4从飞牛桌面打开应用，首次进入创建 6 位数字访问口令。
- 5登录小米账号，选择音箱，填写 LyraNest 服务地址后保存配置。
飞牛桌面入口使用飞牛统一网关；你也可以通过 http://<飞牛地址>:<端口> 从局域网访问管理台。
安装 · Docker
Docker 镜像适用于 Linux AMD64 / x86_64 设备，与飞牛 FPK 是两种独立的安装方式。下载镜像并导入：
docker load -i LyraNest-XiaoAI-Bridge-1.0.8-docker-image-linux-amd64.tar启动 Bridge：
docker run -d --name lyranest-xiaoai-bridge \
--restart unless-stopped \
-p 18090:8090 \
-v /vol1/1000/lyranest-xiaoai-bridge/data:/data \
-e TZ=Asia/Shanghai \
ghcr.io/whwgogogo/lyranest-xiaoai-bridge:1.0.8然后在浏览器打开 http://<NAS_IP>:18090，完成首次设置即可。Docker 方式不使用飞牛统一网关。
Docker Compose 部署
将下面的配置保存为 docker-compose.yml，也可以直接下载 官方 docker-compose.yml：
services:
xiaoai-bridge:
image: ghcr.io/whwgogogo/lyranest-xiaoai-bridge:1.0.8
container_name: lyranest-xiaoai-bridge
restart: unless-stopped
mem_limit: 128m
environment:
BRIDGE_PORT: "8090"
BRIDGE_DATA_DIR: /data
BRIDGE_ACCESS_TOKEN: "{${BRIDGE_ACCESS_TOKEN:-}"
BRIDGE_RUNTIME: docker
TZ: "{${TZ:-Asia/Shanghai}"
ports:
- "{${BRIDGE_HOST_PORT:-18090}:8090}"
volumes:
- "{${BRIDGE_DATA_DIR:-/vol1/1000/lyranest-xiaoai-bridge/data}:/data:rw}"
healthcheck:
test:
- CMD
- node
- -e
- >-
fetch('http://127.0.0.1:8090/healthz').then((response) =>
process.exit(response.ok ? 0 : 1)).catch(() => process.exit(1))
interval: 30s
timeout: 5s
start_period: 10s
retries: 3下载 Docker 镜像归档并导入：
mkdir -p lyranest-xiaoai-bridge && cd lyranest-xiaoai-bridge
curl -fLO https://github.com/WHWgogogo/LyraNest-Xiaomi-Bridge/releases/latest/download/LyraNest-XiaoAI-Bridge-1.0.8-docker-image-linux-amd64.tar
docker load -i LyraNest-XiaoAI-Bridge-1.0.8-docker-image-linux-amd64.tar启动服务：
docker compose up -d默认使用 18090 端口和 /vol1/1000/lyranest-xiaoai-bridge/data 数据目录。需要调整时，在执行命令前设置环境变量，或在 Compose 文件所在目录创建 .env：
BRIDGE_HOST_PORT=18090
BRIDGE_DATA_DIR=/vol1/1000/lyranest-xiaoai-bridge/data
TZ=Asia/Shanghai首次打开 http://<NAS_IP>:<BRIDGE_HOST_PORT> 时创建 6 位数字访问口令。需要无人值守部署时，再在 .env 中增加 BRIDGE_ACCESS_TOKEN。
首次配置
- 1创建管理台的 6 位数字访问口令。
- 2输入小米账号和密码；小米要求时，再输入短信或邮箱验证码。
- 3刷新并选择一台小爱音箱。
- 4填写 Bridge 访问 LyraNest 的服务地址，以及音箱可访问的 LyraNest 地址。
- 5保存配置并启用 Bridge，随后可用「播放测试」验证全链路。
「LyraNest 服务地址」供 Bridge 搜索音乐；「音箱可达的 LyraNest 地址」供音箱直接播放。两者在反向代理、多网卡或跨主机部署时可能不同。
使用提示与安全
- · 当前支持单账号、单音箱，适合家庭和个人局域网使用。
- · 小爱相关连接基于非官方兼容能力；小米账号风控、验证要求或服务调整可能需要重新登录。
- · 配置和已加密的小米登录会话保存在数据目录；请不要删除 Docker 数据卷或飞牛应用数据。
- · 管理台口令仅适合可信局域网。请勿将端口直接暴露到互联网；远程使用时建议通过防火墙或带认证的反向代理保护。
校验下载
Linux、macOS：
sha256sum -c SHA256SUMS-1.0.8.txtWindows PowerShell：
Get-FileHash .\LyraNest-XiaoAI-Bridge-1.0.8-fnos-native.fpk -Algorithm SHA256
Get-FileHash .\LyraNest-XiaoAI-Bridge-1.0.8-docker-image-linux-amd64.tar -Algorithm SHA256把音乐，
放回你自己家里
现在开始建立属于自己的音乐库。