资讯动态

EchoMuse Controller 部署教程:Home Assistant 插件与 Docker 两种方式对比,哪种更适合你?

发布时间:2026/10/15 17:40:04 来源:尧图企业网站定制
【免费下载链接】EchoMuseAlexa replacement and controller for Echo Dot 2nd Generation device.项目地址https://gitcode.com/gh_mirrors/ec/EchoMuse点击查看免费下载EchoMuse是一个开源的本地语音助手项目它能把二手的 Amazon Echo Dot 2 代改造成Home Assistant的语音卫星设备——唤醒词检测、LED 灯环、麦克风阵列全部本地运行无需亚马逊账号和云端服务。它的核心是运行在你家庭网络中的EchoMuse Controller控制器本文对比Home Assistant 插件Add-on与Docker 容器两种部署方式帮你快速选出更适合自己的方案。 完整上手流程见官方快速入门docs/quickstart.md部署前你需要了解什么无论选哪种方式Controller 启动后都会提供两个入口服务端口说明管理面板Dashboard8768Web 控制面板审批设备、调 EQ/灯环、看日志WebSocket 数据平面8767明文/ 8770TLSEcho Dot 设备通过 mDNS 自动发现并连接ESPHome 卫星端口16001 起每台设备分配一个端口供 Home Assistant 的 Assist 管线驱动⚠️ 两种部署都必须使用 host 网络模式插件的host_network: true、Docker 的network_mode: host因为 mDNS 组播发现和每台设备独立的 ESPHome 端口都无法穿透 Docker 端口映射。这一要求写在 controller/config.yaml 和 controller/docker-compose.deploy.yml 的注释中。两种方式核心对比一张表看懂差异对比维度 Home Assistant 插件 Docker 容器适用前提已有支持 Add-on 的 Home Assistant任意常开的 Linux 主机NAS、树莓派、服务器安装耗时约 2 分钟加仓库 安装约 5 分钟下载 2 个文件 compose 启动面板访问通过 HA 侧边栏进入无需额外端口http://IP:8768需自行记住地址账号体系自动以 HA 用户登录首个打开者成为管理员需用日志中的 setup token 创建管理员配置方式插件配置选项卡可视化.env环境变量文件数据持久化HA 托管的/data随升级保留主机./data目录自行负责备份唤醒词推理CPUCPU预构建镜像可自行构建启用 NVIDIA GPU升级方式插件商店一键升级docker compose pull up -d两种方式运行的是完全相同的软件只有外壳不同因此可以随时互相迁移。方式一Home Assistant 插件安装步骤推荐新手如果你已经在运行 Home Assistant含 Supervisor这是最省事的路径1. 添加插件仓库并安装路径设置 → Apps → Install App → ⋮ → Repositories → Add填入 EchoMuse 仓库地址后安装EchoMuse。官方 README 还提供了一键添加仓库的徽章。2. 打开面板自动完成认证安装后HA 侧边栏会出现EchoMuse入口。它是仅能通过 Home Assistant 访问的——插件会拒绝一切不经过 HA 转发的连接所以不需要你多开一个端口也不需要第二套密码。 权限规则第一个打开面板的 HA 用户自动成为 EchoMuse 管理员之后打开的用户默认只读录音和对话文本仅管理员可见需要管理员在Settings → Users中提升。3. 配置可选Docker 方式中写在.env的配置项在插件里就是配置选项卡里的字段例如server_ip、oww_model、oww_threshold。全部选项说明见 controller/DOCS.md。 小贴士server_ip留空即可——Controller 会从路由表自动检测本机局域网地址并在启动日志中打印。只有在机器有多个网口、自动判断出错时才需要手动指定。方式二Docker 快速部署教程适合独立服务器如果 Home Assistant 是用 Docker 方式装的没有 Supervisor装不了插件或者你想把 Controller 放在另一台常开主机上就用 Docker。1. 准备部署文件从 EchoMuse 仓库的controller/目录下载这两个文件到同一目录controller/docker-compose.deploy.yml —— 使用官方预构建镜像无需本地编译controller/.env.example —— 配置模板下载后改名为.env2. 编辑.env关键项很少多数可保持默认SERVER_IP10.x.y.z # 本机局域网 IP留空则自动检测 OWW_MODELhey_jarvis # 唤醒词模型 OWW_THRESHOLD0.5 # 唤醒词灵敏度越低越敏感3. 启动容器docker compose -f docker-compose.deploy.yml up -d4. 创建管理员账号浏览器打开http://IP:8768你会看到带琥珀色脉冲光环的初始设置页。它要求输入setup token——这个一次性令牌打印在容器日志里docker logs echomuse-controller粘贴令牌、设置用户名密码即可。之后页面显示绿色光环进入正常登录。5. 升级docker compose -f docker-compose.deploy.yml pull docker compose -f docker-compose.deploy.yml up -d设备、用户和设置都在./data目录中升级不受影响。进阶GPU 唤醒词推理。预构建镜像是 CPU 推理几台设备足够用如需 NVIDIA GPU 加速可克隆仓库后用 controller/docker-compose.yml 本地构建需要移除无 GPU 机器上的deploy:配置块。数据迁移指南Docker 容器切换到插件两者跑的是同一套代码但迁移时有一个致命易错点data/目录必须完整拷贝不能只拷数据库文件data/ ├── echomuse.db ← 设备、设置、用户、历史 ├── tls/ ← 设备的信任证书CA最关键 ├── oww_models/ ← 自训练的自定义唤醒词模型 └── recordings/ ← 保存的语音片段为什么tls/最关键每台 Echo Dot 都保存着你 Controller 的证书副本只信任持有对应密钥的服务器。全新 Controller 会生成新的 CA设备就会静默拒绝连接——仪表盘上什么都看不到非常难排查。官方迁移手册还提醒迁移前务必先docker compose down停掉旧 Controller同一网络内不能有两个 Controller设备会连到先应答的那个。完整步骤见 docs/migrate-to-addon.md。哪种更适合你选型清单✅选 Home Assistant 插件你的 HA 支持 Add-on想让家人也能用、但面板入口收敛在 HA 内不想再维护一套端口和地址。✅选 DockerHA 本身是 Docker 部署无 Supervisor想给 Controller 独立的算力或 GPU 推理或者 HA 与设备不在同一台机器上。⚖️两者皆可多台设备、多房间部署——两种方式都支持设备自动发现 仪表盘统一审批。常见部署踩坑速查设备连不上先确认没有两个 Controller 同时在线再确认主机网络模式是 host。Proxmox LXC 用户需要手动把 mDNS 组播 MAC 加入网桥ip maddr add 01:00:5e:00:00:fb dev vmbr0。HA 里看不到设备同子网下设备会自动被发现跨 VLAN/子网时组播过不去需在 HA 中手动添加 ESPHome 集成输入 Controller IP 设备页面上显示的端口如 16001。唤醒词不灵仪表盘 Activity 页查看 near-miss 记录适当调高灵敏度配置详见 docs/configuration.md。Proxmox / 防火墙放行 8767、8770、8768 和 16001 端口即可。更多问题见官方 docs/faq.md深度排障与硬件细节参考 SETUP.md。部署完成后插上 Echo Dot 等待它出现在仪表盘待审批列表批准、连上 WiFi然后说一句Hey Jarvis——你的本地语音助手就上线了 赞分享【免费下载链接】EchoMuseAlexa replacement and controller for Echo Dot 2nd Generation device.项目地址https://gitcode.com/gh_mirrors/ec/EchoMuse点击查看免费下载相关推荐3种PageSpy部署方案终极对比Node.js、Docker、宝塔面板哪个更适合你3种PageSpy部署方案终极对比Node.js、Docker、宝塔面板哪个更适合你 PageSpy是一款强大的远程调试工具能像Chrome DevToo前端开发工具调试器Seedbox-Lite部署终极指南Docker vs PM2哪种方式更适合你Seedbox Lite部署终极指南Docker vs PM2哪种方式更适合你 Seedbox Lite是一款轻量级的一站式 torrent 媒体中心APDF补丁丁完整指南免费开源PDF编辑工具的终极解决方案PDF补丁丁完整指南免费开源PDF编辑工具的终极解决方案 你是否经常遇到PDF文档无法编辑、书签混乱、页面尺寸不统一的问题PDF补丁丁正是为你量身定制的全能桌面应用文档创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑