家电换了 IP 地址怎么办?LocalThings reconfigure 的正确姿势

原创2026-11-11 16:45:431,672 阅读
文章标签:物联网智能家居插件系统

家电换了 IP 地址怎么办?LocalThings reconfigure 的正确姿势

当三星家电换了 IP 地址,在 Home Assistant 里使用 LocalThings 集成时,实体就会集体显示 unavailable。这篇文章教你用 reconfigure 一键把设备指向新地址——实体、历史数据和自动化规则全部保留,不用删掉重加。

LocalThings 集成 Logo:通过家庭网络直连三星家电的 Home Assistant 集成

🏠 为什么家电的 IP 会突然变?

LocalThings 通过 LAN 内的固定 IP 直接和家电通信,不经过三星云。而大多数路由器用 DHCP 动态分配地址,以下情况都会让家电"搬家":

触发场景 说明
DHCP 租约到期 路由器重新分配,新地址可能完全不同
路由器 / 光猫重启 整个地址表重建
网络结构调整 换了网段、加了 VLAN,旧 IP 直接失效
多设备同网段 三星家电的 DHCP 主机名常相同(如 Samsung-Room-AC),容易"顶掉"别人的地址

IP 一变,LocalThings 连的还是旧地址,实体全部离线。

⚠️ 别急着"删除 + 重新添加"

新手最常用的补救办法是删掉设备再重新添加,但代价不小:

  • ❌ 实体 ID 全部改变——仪表盘卡片、模板里引用的 entity_id 全部失效
  • ❌ 历史记录清零——能耗、运行时长等统计曲线断档
  • ❌ 自动化、场景要重配——所有指向旧实体的规则全部罢工

而 LocalThings 的 reconfigure 就是为这个问题准备的:它只改地址,不动身份。

✅ 一键更新:Reconfigure 操作步骤

整个过程只需 3 步,全程在 Home Assistant 界面完成:

  1. 打开 Settings → Devices & Services,找到 LocalThings 集成
  2. 点击右侧 ⋮ 菜单,选择 Reconfigure(中文界面为"重新配置")
  3. 在弹出的 Change appliance address 表单中填入家电的新 IP 地址,提交

表单下方会明确提示:

Enter the appliance's current IP address. Everything else about this device stays as it is — its entities, history and automations are kept.

提交后 LocalThings 会先向新地址发起探测,确认回答的确实是这台家电才写入新地址,成功后提示 Address updated,设备随即重新上线。这个"先验人、再写地址"的逻辑就实现在 config_flow.py 的 async_step_reconfigure 中。

🔍 常见报错对照表

提交后没有成功?对照下面这张表快速定位:

报错 含义 解决办法
no_response 该 IP 上探不到任何本地 API 端口(UDP 49152-49160) 确认 IP 正确、家电已上电、与 HA 同网段,检查防火墙是否拦 UDP
ports_closed IP 可达但主动拒绝所有本地 API 端口 大概率不是三星家电,或本地 API 未启用
no_dtls_server 端口可达但没有 DTLS 握手 地址指向了别的设备,核对路由器里的 DHCP 表
wrong_device 该地址上是另一台三星家电 填错了地址;要添加那台请用 Add 而不是 Reconfigure
handshake_timeout 家电响应了但 DTLS 握手未完成 重试一次;仍失败就重启家电,释放它占着的连接

💡 家电同时只接受一个本地连接。如果手机上的 SmartThings 应用正长时间连着它,探测可能失败——先关掉 App 再试。

📡 进阶技巧:让 IP 变化自动跟随

LocalThings 还内置了 DHCP 自动跟随:约半数三星家电会上报自己的 Wi-Fi MAC 地址,manifest 中声明了 "dhcp": [{ "registered_devices": true }]](custom_components/localthings/manifest.json#L8),一旦 Home Assistant 在 DHCP 流量里发现这台 MAC 出现在新 IP 上,就会自动更新条目并重新加载,全程无需你动手。相关逻辑见 [config_flow.py 的 async_step_dhcp。

两个实用推论:

  • 第一次手动 reconfigure 之后,探测结果里带回的 MAC 会被存进条目(见 registry/identity.py 的 resolve_mac)。从此以后它换 IP,DHCP 发现会自动跟上,你只需再管这一回。
  • 老条目也能补上 MAC:哪怕设备当前离线,reconfigure 时读取的离线快照也会把 MAC 补录进条目,为下一次的自动修复铺好路。

🔒 双保险:给家电固定 IP

自动跟随虽好,最省心的做法还是让 IP 不变:

  1. 在路由器后台找到该家电的 DHCP 租约条目
  2. 把它的 MAC 绑定为一个固定地址(IP 保留 / DHCP 静态分配)
  3. 重启家电使其生效

这样 LocalThings 条目永远有效,reconfigure 和自动跟随都只是兜底。

📚 小结

场景 推荐做法
IP 变了,想保留实体和历史 Reconfigure 填入新 IP(本文主角)
设备经常换 IP 先 reconfigure 一次补上 MAC,之后 DHCP 自动跟随
想一劳永逸 路由器里绑定静态 IP

更多网络行为说明可参考 README.md 的 "When an appliance's IP address changes" 一节,深入的技术调研见 docs/investigations/network-discovery.md。

登录后查看全文
localthings