【免费下载链接】local_roborock_serverLocal HTTPS and MQTT cloud emulator for Roborock vacuums without rooting or hardware modifications项目地址https://gitcode.com/gh_mirrors/lo/local_roborock_server点击查看免费下载Roborock Local Server 是一个免 Root、免硬件改造的Roborock 扫地机本地云端模拟器它在你家局域网里复刻 Roborock 官方的 HTTPS 和 MQTT 服务让扫地机、Home Assistant 和 Roborock 集成都能绕过官方云直接在本地通信。本文带你用Home Assistant Add-on一键装好它并把 Roborock 集成从官方云重定向到本地服务器——全程不需要改一行代码。一、装好后你能得到什么能力说明️ 本地实时地图清扫地图、房间数据全部走局域网断网也能看 本地 MQTT 通道Add-on 内置 MQTT Broker 和 Topic 桥接集成通过本地 MQTT/TLS 接收设备状态 可逆操作重置扫地机 Wi-Fi 即可恢复官方云配对随时反悔 免 Root不需要拆机、刷固件、解锁 bootloader⚠️ 不同型号扫地机信任的证书链不同。安装前建议先查看已测试机型列表确认你的机型应该用zerossl、actalis还是自带证书。大多数用户选zerossl即可。二、安装前准备1分钟自检✅ 一个自己拥有的域名且家里有本地 DNSPi-hole / AdGuard Home / 路由器✅ 一个以api-开头的子域名如api-roborock.example.com指向运行 Home Assistant 的局域网 IP✅ 一台可以联网配对的备用机器手机或电脑稍后做 Onboarding 用✅ Home Assistant 支持 Add-onOS 发行版网络要求细节可参考安装文档。三、Add-on 安装步骤3分钟第 1 步添加 Add-on 仓库打开设置 → Add-on 商店 → 仓库添加本项目的仓库地址然后找到Roborock Local Server并安装。 请安装稳定版Roborock Local Server当前 1.2.1。Beta 版1.1.0-rc2目前未启用数据和稳定版是分离的。第 2 步填写关键配置在 Add-on 的配置Options标签页中重点填写以下参数完整定义见 config.yaml参数说明stack_fqdn你的api-开头的域名如api-roborock.example.comhttps_portHTTPS 端口默认555mqtt_tls_portMQTT/TLS 端口默认8881region你的地区us/eu/cn/ruadmin_password管理后台/admin的登录密码protocol_login_email本地协议登录邮箱Home Assistant 将用它登录你的本地服务器protocol_login_pin6 位数字协议登录码tls_mode证书模式provided自带证书或cloudflare_acmeCloudflare DNS-01 自动签发证书两种走法tls_mode cloudflare_acme填tls_base_domain、tls_email、cloudflare_token证书自动签发续期acme_server多数人选zerossl老机型选actalis需另填acme_eab_kid和acme_eab_hmac_keytls_mode provided指向你已有的证书文件。如果你用的是 Home Assistant 官方 Lets Encrypt Add-on证书在/ssl目录例如cert_file /ssl/fullchain.pem、key_file /ssl/privkey.pem第 3 步启动并打开管理后台启动 Add-on 后浏览器访问https://api-roborock.example.com:555/admin⚠️ 请用stack_fqdn配置的域名访问不要用 HA 主机地址除非它恰好就是证书覆盖的域名。第 4 步导入云端数据在/admin后台使用Cloud Import拉取你的 Roborock 账号数据此时输入 Roborock 云账号邮箱 验证码确认设备列表中出现你的扫地机从备用机器运行 Onboarding 完成配对完成这三步后你的本地小云就真正上线了。四、重定向 Roborock 集成1分钟Add-on 本身不会自动改写 HA 的 Roborock 集成需要手动指向本地服务器。HA 官方 Roborock 集成支持自定义服务器Region 选Manual无需手改存储文件。方式 A全新添加集成最简单打开设置 → 设备与服务点击添加集成搜索Roborock地区下拉框选择Manual输入本地服务器地址例如https://api-roborock.example.com:555输入protocol_login_email再用你的 6 位protocol_login_pin作为验证码提交集成会自动连上本地服务器、列出设备并建立本地 MQTT 连接。✅方式 B已有云集成改道本地如果集成已经连着官方云有两种选择B1. 删除后重新添加点集成右上角三点菜单 →删除再按上面方式 A重新添加。最干净但会失去原有实体 ID、仪表盘和历史记录B2. 编辑core.config_entries保留实体 ID 和历史。先停用集成或停 HA→ 备份/config/.storage/core.config_entries→ 找到domain: roborock的条目把base_url、a、l改成本地 HTTPS 地址m改为ssl://api-roborock.example.com:8881username改为protocol_login_email→ 保存重启按提示输入protocol_login_pin重新认证️ 手动编辑.storage文件有风险改之前一定先备份。五、常见故障排查日志出现rejected MQTT CONNECT reasoninvalid_mqtt_credentials这是凭据过期导致的依次检查本地服务器是否用同一 Roborock 账号完成过 Cloud Importbase_url、rriot.r.a/l/m是否都指向本地服务器在 HA 中触发重新认证Reauth输入protocol_login_pin让集成从本地服务器拉取最新 MQTT 凭据更多问题排查与集成细节见Home Assistant 官方文档页。六、延伸阅读资料路径Add-on 说明roborock_local_server_addon/DOCS.mdAdd-on 配置定义roborock_local_server_addon/config.yaml版本更新日志roborock_local_server_addon/CHANGELOG.mdOnboarding 配对指南docs/onboarding.md已知限制docs/known_limitations.md装好之后你的扫地机地图、清洁状态、定时任务全部跑在局域网里——隐私留在自己家响应快人一步。赞分享【免费下载链接】local_roborock_serverLocal HTTPS and MQTT cloud emulator for Roborock vacuums without rooting or hardware modifications项目地址https://gitcode.com/gh_mirrors/lo/local_roborock_server点击查看免费下载相关推荐Home Assistant Roborock 项目推荐Home Assistant Roborock 项目推荐 项目基础介绍和主要编程语言 Home Assistant Roborock 是一个开源项目旨在为 H物联网智能家居3步解决Home Assistant Roborock集成失败问题3步解决Home Assistant Roborock集成失败问题 你是否遇到过Home Assistant中Roborock扫地机器人无法连接、地图不加载或状智能家居物联网后端Roborock扫地机器人Home Assistant终极集成指南Roborock扫地机器人Home Assistant终极集成指南 想要让家中的Roborock扫地机器人真正融入智能家居生态系统吗本指南将带你完成从基础配置物联网智能家居上一篇Kubernetes环境下一键部署MySQL集群MySQL Operator完全指南下一篇Octop语义搜索API详解如何跨Agent检索对话与文档创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考