【免费下载链接】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 是一个把石头Roborock扫地机的云端 HTTPS 和 MQTT 服务搬到家庭局域网的本地模拟服务器而 Onboarding 配对是其中最关键的一步让你的扫地机改头换面不再连接官方云转而直连你自己搭建的本地服务器。本教程带你用 8 步完成 Roborock 本地服务器配对——即使是一台从未注册过官方云的全新机器也能通过盲配blind onboarding成功接入。 前置条件请已完成 安装流程服务器已能在api-...主机名下访问并且已经做完云端导入cloud import / fetch-data步骤。参考 docs/installation.md 和 docs/onboarding.md。一、配对前检查清单开始之前确认以下条件全部满足检查项说明服务器已部署Docker Compose 或 Home Assistant 插件方式均可默认 HTTPS 端口555、MQTT TLS 端口8881云端导入已完成服务器库存里能看到你的扫地机否则会报No known vacuums are available for onboarding.备机已就绪需要一台第二台电脑不能是跑服务器的那台装有 Python 3.11 和uv备机 Wi-Fi 可切换能在家庭 Wi-Fi 和扫地机临时热点之间来回切换容器资源充足至少 1 核 CPU 1 GB 内存公钥恢复是加密运算资源不足会卡住 如果是全新机器建议先用官方 Roborock App 完成一次初始设置让 App 拉取机器元数据但不要升级固件除非你确认最新固件受支持。二、选择一种配对方式Roborock Local Server 提供三种 Onboarding 方式任选其一命令行 CLI—— 运行 start_onboarding.py适合习惯终端的用户浏览器 Web UI—— 运行 start_onboarding_gui.py自动打开图形界面新手推荐 ⭐手机 AppLocalRock—— 用第三方应用 LocalRockAndroid / iOS直接在手机上配对无需第二台电脑。三者底层流程完全一致只是界面不同。三、第 1~2 步启动配对工具并登录在第二台电脑上可以从仓库检出目录直接运行执行uv run start_onboarding.py --server api-roborock.example.com--server填你安装时用的api-...主机名自定义端口要写成api-roborock.example.com:8443的形式省略端口时默认555。如果你不想用终端改用 GUI 版uv run start_onboarding_gui.py浏览器会自动打开配置页所有参数在表单里填写即可。⚠️ 注意最终发给扫地机的host[:port]/值去掉api-前缀后有32 字符的硬上限主机名越短越安全例如rr.example.com:555/可以roborock-local-server.example.com:555/就超长了。启动后CLI 会先要求输入本地服务器的admin 密码就是访问/admin后台的密码登录成功后会列出可配对的扫地机清单每台设备后面带有状态标签例如Qrevo MaxV [Public Key Determined] [Disconnected]四、第 3 步选择扫地机全新机器选 New vacuum 盲配普通设备直接从列表里选你的机器即可。全新机器从未上过云它没有云端库存记录不会出现在列表里。此时在设备选择步骤选择New vacuum选项CLI 中输入newGUI 里是已导入设备下方的 New vacuum 按钮开启盲配会话。盲配的原理很简单不指定目标设备服务器直接接收配对流量里出现的第一台扫地机身份did由服务器签发localKey。设备走到 NC Prepare 并注册后服务器会自动把它加入设备清单之后就和普通设备一样出现在后台和 Home Assistant 里。V1、V2 协议机型均支持。五、第 4 步填写家庭 Wi-Fi 与时区参数脚本会提示你补全缺失的信息也可以在命令行一次性传参省得反复输入参数含义ssid你家的2.4 GHzWi-Fi 名称password家庭 Wi-Fi 密码timezoneIANA 时区字符串如America/New_York中国用户用Asia/Shanghaicst扫地机固件用的 POSIX 时区串如美东EST5EDT,M3.2.0,M11.1.0country-domain区域域名官方云区域为eu/us/cn/ru欧洲用户填eu 好消息如果填的时区在脚本内置表里美、欧、日、悉尼等主流时区都覆盖了cst和country-domain会自动推导不用手填。中国时区Asia/Shanghai对应的 POSIX 串是CST-8。uv run start_onboarding.py --server api-roborock.example.com \ --ssid My Wifi --password Password123 \ --timezone Asia/Shanghai --country-domain cn六、第 5 步重置扫地机 Wi-Fi 并连接热点这一步需要物理操作长按底座上的两个按键或机身左右按键3~5 秒听到 Wi-Fi 重置提示音后松手在第二台电脑上连接扫地机发出的临时 Wi-Fi 热点回到脚本按下 EnterGUI 则点击 Send onboarding packet。 关键区分做的是Wi-Fi 重置不是完整恢复出厂如果你不确定自己机型的重置方法搜索该型号的具体步骤。这一步是整个流程中唯一需要动手的环节。脚本随后会把cfgwifi配对数据包发送到扫地机的192.168.8.1告诉它回家的 Wi-Fi 叫这个名字密码是这个云端地址指向我的本地服务器。七、第 6 步切回家庭 Wi-Fi等待自动轮询发送成功后把电脑切回正常家庭 Wi-Fi。接下来工具会自动接管等待主服务器重新可达GUI 最长等 2 分钟已知在线可点 Im back online, skip the wait 跳过每 5 秒轮询一次最长 5 分钟观察三项进展query 样本数是否增长、公钥是否恢复Public Key determined、设备是否连上 MQTT全程有实时日志窗口GUI 下方 log pane / CLI 终端输出不用再盯着管理后台看。八、第 7~8 步确认结果必要时多跑一轮公钥恢复可能需要几分钟部分新机型在恢复期间 query 样本数会一直是 0盯住 Public Key determined 状态即可。脚本会明确告诉你下一步该retry、wait、换设备还是结束首轮成功通常表现为 query 样本数上涨样本涨了但公钥还没恢复 → 再跑一轮完整配对循环公钥就绪后 → 脚本会提示你做最后一轮配对让设备完全连上有些机器总共需要2~4 轮最后一轮也可能慢几分钟才显示 Wi-Fi connected耐心等即可。 当脚本报告扫地机已连接本地服务器时Onboarding 就全部完成了。Home Assistant 的设备列表此时也能看到它。想随时撤销再做一次 Wi-Fi 重置机器就回到出厂配对状态整个过程可逆。九、手机端替代方案用 LocalRock 盲配如果没有第二台电脑可以用开源应用LocalRockAndroid / iOS直接在手机上完成配对在 App 中填入本地服务器地址和管理凭据完成连接选择Add vacuum长按按键 3~5 秒重置扫地机 Wi-Fi按 App 指引让手机连上扫地机热点并发送家庭 Wi-Fi 凭据App 自动完成握手、公钥恢复并验证扫地机已连上本地服务器。详见 docs/roborock_app.md。十、常见问题速查症状原因与处理No known vacuums are available for onboarding.云端导入没做——先回 Installation 完成 fetch-data或改用 New vacuum 盲配点击发送后提示 Onboarding send failed还没连上扫地机热点或机器不在配对模式重新 Wi-Fi 重置再试GUI 卡在 Polling...给足 5 分钟超时个别机器公钥就绪后最后一轮特别慢公钥恢复阶段服务器卡住无报错容器资源不足加密恢复会吃满 CPU/内存确保至少 1 核 1 GB浏览器没自动打开手动复制终端里打印的完整 URL含?token...部分打开小结Roborock Local Server 的 Onboarding 配对可以概括为启动工具 → 登录选机 → 填 Wi-Fi → 重置连热点 → 发送配对包 → 切回等轮询 → 多轮循环 → 完成。其中全新机器的 New vacuum 盲配选项让从未上云的扫地机也能直接接入本地服务器无需任何 Root、拆机或固件修改。延伸阅读配对官方文档docs/onboarding.md安装与网络配置docs/installation.md配对入口脚本start_onboarding.py、start_onboarding_gui.py、共享逻辑 onboarding_shared.py已测机型兼容列表docs/tested_vacuums.mdHome Assistant 接入docs/home_assistant.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点击查看免费下载相关推荐Roborock Local Server 逆向工程揭秘如何让扫地机把云端请求打到你的本地服务器Roborock Local Server 逆向工程揭秘如何让扫地机把云端请求打到你的本地服务器 一、为什么扫地机离不开云端 Roborock Local石头扫地机为什么离不开云Roborock Local Server 让你的扫地机实现100%离线本地控制石头扫地机为什么离不开云Roborock Local Server 让你的扫地机实现100%离线本地控制 Roborock Local Server 是一个把HomeAssistant智能家居集成轻松配置Roborock扫地机器人HomeAssistant智能家居集成轻松配置Roborock扫地机器人 想要实现真正的智能家居集成让您的Roborock扫地机器人完美融入HomeAssi物联网智能家居上一篇Baguette虚拟相机把Mac摄像头或视频文件喂给iOS模拟器相机下一篇90DaysOfDevOps 之 Ansible 入门Day 64从控制节点安装到主机清单与 Ad-hoc 命令实战创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
