Skip to content

设备常离线问题 ​

米家侧偶发把设备标成离线后,Olink 会把对外可达性也打成不可用,苹果「家庭」里读特征时常见 无响应、配件变灰。若设备其实还能控、只是云端状态抖,可用接入配置里的 一直在线(force_online) 解决。

现象 ​

  • 「家庭」里配件显示无响应、不可用,过一会儿又好,反复刷
  • Olink / 米家列表里该设备也常跳离线,但本地偶发仍能控制
  • BLE(blt.)、网关 proxy 子设备(proxy.)一般不会误伤(系统已按一直在线处理);本文主要针对普通 Wi-Fi / 网关设备被云端误判离线的情况

这和 配对卡在连接中(根本搜不到配件)不是一类问题;也和摄像头 配对后一直转圈(画面编码)无关。

Olink 对齐小米 Home / ha_xiaomi_home 的思路:每台米家设备维护多路连通性,再合成一个对外的「是否可用」。

text
云端状态(Cloud)  ──┐
本地网关状态(Gateway)─┼── OR 融合 ──→ 聚合可达
局域网探测(LAN)  ──┘         │
                               ▼
                    Device::available()
                               │
                               ▼
              HomeKit 读特征 / 对外「是否无响应」
步骤含义
各路独立更新云 MQTT、本地网关 MQTT、LAN UDP 等各自上报 online/offline
OR 融合任一路径在线 → 对外在线;三路都离线 → 对外不可用
available()对外读取用的总开关;HomeKit 不可用时读特征会失败 →「无响应」
变化才广播聚合结果真变了才发可达性事件,避免刷屏

另外还有两条「抬高对外在线」的捷径(见后文解决方案):

  • did 以 blt. / proxy. 开头:系统内置一直在线,且跳过连通性 Hub 更新;
  • 接入配置 force_online = true:只让 available() 恒为 true,内部三路仍照常更新。

米家设备如何判断在线 / 离线 ​

小米生态里,设备「在不在线」不是单点结论,而是多通道状态再合并。常见三路:

1. 云端(Cloud) ​

  • 来源:小米云 HTTP 设备列表里的 online,以及云 MQTT 主题(如 device/{did}/state/#)推送的 online / offline 事件。
  • 特点:依赖外网与云连接;云抖动、账号会话、弱网时容易误报离线,即使灯其实在局域网里还能控。
  • 特殊:blt.(蓝牙)、proxy.(经网关代理的子设备)云端往往不推上下线事件,生态侧通常假定一直在线,避免误判。

2. 本地网关(Gateway) ​

  • 来源:家里的米家/智造本地网关上的 MQTT(局域网内),反映网关视角下子设备是否在线。
  • 特点:不依赖公网云链路也能更新;适合「设备挂在网关下」的场景。网关本身掉线、子设备与网关失联时,这一路会变离线。
  • 与云的差异见下一节。

3. 局域网直连(LAN) ​

  • 来源:对可 LAN 的设备做 UDP 探测 / 保活(类似心跳状态机)。
  • 特点:最贴近「同一网段能不能摸到设备」;典型逻辑是连续多次探测失败才判离线(量级约十余秒),上线侧往往还有防抖(网络不稳时延迟上线),形成 「离线快、上线慢」,减少狂闪。
  • 访客 Wi-Fi、AP 隔离、跨网段时,这一路经常帮不上忙。

融合结果 ​

text
云 online  ∨  本地网关 online  ∨  LAN online  →  设备在线
三者皆 offline(或云已移除且另两路也不在) →  设备离线

因此:只有云说离线,但本地网关或 LAN 仍在线时,聚合结果仍应是在线。
常离线刷「无响应」的典型情况是:云报离线,同时 LAN / 本地网关也没能及时证明在线(未建 LAN、跨网段、网关未接入等),三路 OR 变成 false。

云端网关 vs 本地网关(差异) ​

这里的「网关」容易混:一个是云上的状态通道,一个是家里那台本地网关设备。

云端(Cloud)本地网关(Gateway)
路径经公网到小米云,再 MQTT / 列表下发家里网关在局域网 MQTT,Olink 与网关同网即可
依赖外网、云服务、账号会话网关在线、子设备与网关射频/链路正常
延迟与抖动弱网、云波动时易抖一般更稳,但网关重启 / 子设备掉网关会抖
典型误判「米家 App 偶发离线、家里其实能控」「子设备离网关但 Wi-Fi 灯还在」等网关拓扑问题
和 LAN 关系与 LAN 独立;云离线不代表局域网 ping 不通子设备往往只经网关出现,不一定有独立 LAN 探测

补充:

  • 仅走云、没接本地网关、也没有有效 LAN:在线几乎完全听云的 → 云抖就整机抖,HomeKit 最容易刷无响应。
  • 云 + 本地网关 / LAN 齐备:云误报离线时,只要网关或 LAN 仍 online,OR 融合仍应对外在线。
  • 控制台里「米家网关」相关能力,主要增强的是 Gateway / 本地侧 可见性与订阅,不能消灭云通道本身的抖动,但能在融合里多一条「本地在线」票。

注意事项 ​

  1. force_online 不保证能控制成功
    只抬高对外「当作在线」;灯真断电、真离线时,读写仍会失败,只是 Home 不一定先显示无响应。

  2. 不要对所有设备无脑一直在线
    若你要用「离线」做通知、自动化(人离开、设备掉线告警),开了 force_online 后对外看不到离线,告警会失效。

  3. 先改善网络与网关,再考虑强行在线
    优先:手机 / Olink / 设备同网、避免访客 Wi-Fi 隔离、需要时接入本地米家网关、确认 LAN 探测条件。仍被云误伤再对个别设备开 force_online。

  4. blt. / proxy. 一般不用再开
    系统已按一直在线处理;再写 force_online 多为重复。

  5. 保存配置看是否真写上
    force_online = true 须在有效 TOML 里(不是注释行);保存后热生效,不必重配对。

  6. 和「配对 / 画面」问题分开排
    搜不到配件、卡在连接中 → 配对卡在连接中;摄像头配对后转圈 → 配对后一直转圈。

解决方案:接入配置「一直在线」/ force_online ​

在该设备的 接入配置 里打开 一直在线(对应 TOML:force_online = true)。

操作步骤 ​

  1. 打开控制台 设备(或米家设备列表)→ 找到目标设备。
  2. 点该行的 接入配置。
  3. 在 表单 页打开 一直在线 开关(也可切到 TOML 写入 force_online = true)。
  4. 保存。该开关热生效,一般不必重建备、不必重配对。
  5. 回到「家庭」再试读状态 / 控制;无响应应明显减少或消失。

接入配置:点「接入配置」→ 打开「一直在线」→ 保存

TOML 等价写法:

toml
force_online = true

要恢复真实离线语义:关掉「一直在线」,或删掉 / 改回 force_online = false,或恢复默认后保存。

打开之后会怎样 ​

行为说明
「家庭」对外在线一直当在线,不再因云端误判刷无响应
云 / 网关 / LAN 内部状态照常更新(订阅、通道切换仍按真实连通性)
设备真离线时控制仍可能失败(不会伪装成读写成功)

适合: 云端状态不稳、但不希望 HomeKit 频繁无响应。
不适合: 要用真实离线态做自动化、告警的场景——开了之后对外看不到「离线」。

和 blt. / proxy. 的区别 ​

blt. / proxy.(系统内置)接入配置 force_online
对外一直在线是是
连通性 Hub 更新跳过照常
怎么开did 前缀自动手动写 TOML

仍无响应时再查 ​

  1. 确认保存成功、配置里确实是 force_online = true(不是只写在注释里)。
  2. 真离线导致控制失败时,先看米家 App 能否控、Olink 与设备是否同网。
  3. 若是搜不到配件、卡在连接中,见 配对卡在连接中。

相关文档 ​