家电换了 IP 地址怎么办?LocalThings reconfigure 的正确姿势
家电换了 IP 地址怎么办?LocalThings reconfigure 的正确姿势
当三星家电换了 IP 地址,在 Home Assistant 里使用 LocalThings 集成时,实体就会集体显示 unavailable。这篇文章教你用 reconfigure 一键把设备指向新地址——实体、历史数据和自动化规则全部保留,不用删掉重加。
🏠 为什么家电的 IP 会突然变?
LocalThings 通过 LAN 内的固定 IP 直接和家电通信,不经过三星云。而大多数路由器用 DHCP 动态分配地址,以下情况都会让家电"搬家":
| 触发场景 | 说明 |
|---|---|
| DHCP 租约到期 | 路由器重新分配,新地址可能完全不同 |
| 路由器 / 光猫重启 | 整个地址表重建 |
| 网络结构调整 | 换了网段、加了 VLAN,旧 IP 直接失效 |
| 多设备同网段 | 三星家电的 DHCP 主机名常相同(如 Samsung-Room-AC),容易"顶掉"别人的地址 |
IP 一变,LocalThings 连的还是旧地址,实体全部离线。
⚠️ 别急着"删除 + 重新添加"
新手最常用的补救办法是删掉设备再重新添加,但代价不小:
- ❌ 实体 ID 全部改变——仪表盘卡片、模板里引用的
entity_id全部失效 - ❌ 历史记录清零——能耗、运行时长等统计曲线断档
- ❌ 自动化、场景要重配——所有指向旧实体的规则全部罢工
而 LocalThings 的 reconfigure 就是为这个问题准备的:它只改地址,不动身份。
✅ 一键更新:Reconfigure 操作步骤
整个过程只需 3 步,全程在 Home Assistant 界面完成:
- 打开 Settings → Devices & Services,找到 LocalThings 集成
- 点击右侧 ⋮ 菜单,选择 Reconfigure(中文界面为"重新配置")
- 在弹出的 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 不变:
- 在路由器后台找到该家电的 DHCP 租约条目
- 把它的 MAC 绑定为一个固定地址(IP 保留 / DHCP 静态分配)
- 重启家电使其生效
这样 LocalThings 条目永远有效,reconfigure 和自动跟随都只是兜底。
📚 小结
| 场景 | 推荐做法 |
|---|---|
| IP 变了,想保留实体和历史 | Reconfigure 填入新 IP(本文主角) |
| 设备经常换 IP | 先 reconfigure 一次补上 MAC,之后 DHCP 自动跟随 |
| 想一劳永逸 | 路由器里绑定静态 IP |
更多网络行为说明可参考 README.md 的 "When an appliance's IP address changes" 一节,深入的技术调研见 docs/investigations/network-discovery.md。
