对话笔记直发：7.11美的空调midea_ac_lan插件迁移记录。分类：网络基建。
title: 美的空调 midea_ac_lan 插件迁移记录 date: 2026-07-11 tags: [Home Assistant, 美的, midea_ac_lan, 智能家居, 运维记录]
美的空调 midea_ac_lan 插件迁移（georgezhao2010 → wuwentao）
背景
- Home Assistant 升级到最新版后，老插件
georgezhao2010/midea_ac_lanv0.3.22 失效（作者已停更） - 改用维护中的 fork：
wuwentao/midea_ac_lan（要求 HA ≥ 2024.4.1，当前满足）
核心原理：为什么能避开”重新登录美的”
- 4 台美的空调全是 v3 协议（protocol=3），局域网控制必须靠 token + key
- 老插件登录时拿到的 v1 LAN token 设计上不过期，至今仍有效
- 新插件升级文档明确：设备不删、不需重新添加 → 直接复用老 token 接管
- 美的已关闭云 token API（新设备难加），但已登录设备的旧 token 仍可用
环境事实
- HA 配置目录：
/opt/ha/config（属 root；hermes 用户只有读权限，无 sudo/写权限） - HA 由 s6 监管（
s6-supervise home-assistant），kill 后自动重启 - 老插件版本：v0.3.22｜新插件版本：v0.6.12
- 4 台设备：主卧/次卧/卧室/客厅空调，IP 192.168.2.x，type 172（AC）
迁移步骤
- 备份（最关键）：把
/opt/ha/config/.storage/midea_ac_lan/（4 个设备 json + account.json）和core.config_entries复制到 HA 外/opt/data/backups/midea_ac_lan_2026-07-10/ - 换代码（需 root）：hermes 无写权限，在 HA 的 Terminal & SSH addon（root）执行：
- 下载 wuwentao v0.6.12 解压到
custom_components/midea_ac_lan - 删旧目录、清理残留
midea_ac_lan*.zip
- 下载 wuwentao v0.6.12 解压到
- 重启：
pkill -f 'homeassistant --config'，s6 自动拉起新版
验证结果
- ✅ 新插件 v0.6.12 就位，旧残留清干净
- ✅ token 5 文件全在，4 台 config_entries 在
- ✅ 实体注册表 103 个 midea 实体全部保留（climate 主控 / 温湿度 / 实时功率 / 新风 / 各开关）
- ✅
midea_ac_lan日志零错误 - ✅ 4 台空调实测均可控制，无需重新登录美的
回滚方案
恢复 /opt/data/backups/midea_ac_lan_2026-07-10/ 下的 .storage/midea_ac_lan + core.config_entries + 旧代码目录，重启即可。
注意事项
- HA 升级后其他老集成有兼容警告（xiaomi_miot 设备发现失败、蓝牙权限、template/ping 配置写法过时、MQTT 连不上）——与本次 midea 迁移无关，多为重启后瞬时错误，通常自愈
- 备份目录含明文 token，注意
/opt/data/backups权限 - 路由器给 4 台空调设静态 IP，避免 IP 变动导致连不上
经验教训
- 迁移自定义集成套路：先备份 .storage（token）→ 换代码不碰 .storage → s6 监管下重启安全
- hermes 对 HA 配置目录只读，涉及 HA 写操作需 root（Terminal & SSH addon）