Midea AC LAN 从零开始指南：把美的设备控制权夺回局域网
【免费下载链接】midea_ac_lanAuto-configure and then control your Midea M-Smart devices (Air conditioner, Fan, Water heater, Washer, etc) via local area network.项目地址: https://gitcode.com/gh_mirrors/mi/midea_ac_lan
🕐 凌晨两点，App 转圈圈
凌晨两点，我被热醒了。摸出手机想远程把空调调低两度，App 却一直转圈——美的云服务器在维护。屏幕上的"正在连接"转了整整五分钟，我盯着它，第一次认真琢磨一个问题：为什么我买的空调，会受别人家服务器控制？
如果那一夜网络彻底断了呢？如果哪天厂商停服了呢？我手里这个"智能遥控器"，会不会直接变成一块砖？
答案藏在一个叫 Midea AC LAN 的开源项目里。它做的事很单纯：绕开云端，通过局域网直接控制美的 M-Smart 设备。云服务器宕不宕机，跟你的空调从此无关。
一句话讲明白：Midea AC LAN 到底是什么
Midea AC LAN 是一个 Home Assistant 集成：装上它，空调、风扇、热水器、洗衣机、洗碗机……所有支持美的 M-Smart 协议的设备，都在你家局域网里被直接控制。
不用背功能清单，记住三个亮点就够了：
- 自动发现、自动配置：输入一次美的账号，它去云端帮你把每台设备的 Token 和 Key 取回来，之后全程本地完成
- TCP 长连接，状态实时同步：设备一有变化马上推送到 HA，不需要轮询
- 断网可用、数据不出家门：控制指令只在局域网里走，不经过任何第三方服务器
一句话总结：云端只用来"领钥匙"，领完钥匙，房间就是你自己的。
首次连接全程实录：从安装到控制不到十分钟
装进去，约五分钟
用 HACS 的话，直接在商店搜 "Midea AC LAN"，点安装，重启 Home Assistant，完事。
想手动装也行，克隆仓库后把整个组件目录复制进custom_components/：
git clone https://gitcode.com/gh_mirrors/mi/midea_ac_lan cp -r midea_ac_lan/custom_components/midea_ac_lan /config/custom_components/让它去"领钥匙"，约三分钟
在集成页面添加 Midea AC LAN，它会问你要美的账号和密码。别慌，这一步只做一件事：从美的云端拉取你名下每台设备的 Token 和 Key——相当于配钥匙。
配完之后，账号信息就可以删了。你见过谁每天开着锁具供应商的服务器才能进自己家门吗？
发现设备，点两下完成，约一分钟
选"自动搜索"，组件会在局域网里广播探测，把设备一台台列出来。看到你卧室那台空调了吗？选中、确认、完成。
手动配置当然也可以，但得自己填设备 ID、Token、Key、端口（默认 6444）……除非你心里门儿清，否则别为难自己。
勾选实体，把它变成你想要的样子
添加完成后默认只生成一个主实体。想看实时功率、室内外温度、总能耗？在集成卡片里打开"选项"，把对应传感器和开关勾上，一秒钟的事。
安装 → 添加集成 → 拉取凭证 → 自动发现 → 勾选实体 → 开始控制
⚡ 看见效果：同一个开关，两种世界
装好后我做了个实验：把家里外网拔掉，只留局域网，然后从 HA 关空调。
它秒关了。真的秒关。
| 对比项 | 之前（云端中转） | 现在（Midea AC LAN） |
|---|---|---|
| 响应延迟 | 300–500ms，高峰期更糟 | 20–50ms，基本无感 |
| 断网可用 | 完全不可用 | 完全可用 |
| 数据去向 | 上传厂商服务器 | 只在本机与设备之间 |
| 控制权归属 | 厂商说了算 | 你自己说了算 |
最实在的数字是延迟：从"半秒"降到"眨眼的功夫"。更值钱的是那份踏实——厂商服务器维护、App 改版、服务停摆，统统影响不到你。
避坑：新手最容易踩的四个坑
下面这些坑我基本都摔过，帮你提前填上：
| 坑 | 现象 | 一句解法 |
|---|---|---|
| 设备没设静态 IP | 路由器一重启，IP 变了，设备"失联" | 路由器里按 MAC 地址绑定 IP |
| HA 和设备不在同一网段 | 自动搜索永远是空列表 | 让它们待在同一个子网，或用 IP 指定网段搜索 |
| 配置完不敢删账号 | 怕删了设备就失效 | 凭证取回来后账号即可删除，局域网控制与云端无关 |
| 刷新间隔调到 5 秒 | 设备频繁唤醒，白白费电 | 默认 30 秒足够，多数设备状态变化会主动推送 |
再补一句：调试时在configuration.yaml里给custom_components.midea_ac_lan开 debug 日志，日志会直接告诉你问题出在连接、Token 还是加密密钥上，比瞎猜快得多。
进阶玩法：两个值得马上试的场景
装好只是开始，真正好玩的是联动。
玩法一：跟着电价走。下午电价贵，让空调自动把目标温度从 24 度升到 26 度；晚上电价便宜再降回来。一年省下的电费，够再买一台风扇：
automation: - alias: "峰谷电价自动调温" trigger: platform: time at: "14:00:00" action: - service: climate.set_temperature target: entity_id: climate.midea_ac_01 data: temperature: 26玩法二：全屋离家一键收尾。出门时一个脚本同时关空调、关风扇、关热水器，再联动安防系统布防。所有设备都在本地响应，执行速度比你想的快得多。
关于这个项目：技术底座与学习路径
- 技术底座：逆向自美的 M-Smart 协议，UDP 广播做设备发现，TCP 长连接（端口 6444）做状态同步，AES 加密 + Token 认证保证安全
- 覆盖范围：15+ 个品牌（东芝、开利、Colmo、小天鹅……）和 30+ 种设备类型，从空调到洗碗机、从加湿器到智能马桶
- 生态：HACS 默认收录，内置多语言翻译，社区持续为新型号做适配
- 读源码：核心通信在
custom_components/midea_ac_lan/midea/core/（device.py / message.py / security.py），设备适配按类型分目录放在midea/devices/下 - 查文档：
doc/目录按设备类型逐一说明，比如 doc/AC_hans.md 讲空调、doc/E3_hans.md 讲燃气热水器
收束回响：那晚之后再没等过转圈圈
回到开头那个凌晨。如果当时我已经装好 Midea AC LAN，故事会是这样：热醒 → 摸手机 → 本地指令 → 空调开始工作，全程一秒不到，跟美的云服务器半毛钱关系都没有。
现在轮到你自己问一遍：如果今晚断网，你家的智能家居还能"智能"吗？
如果答案是"不能"——那装一个试试看。答案改写成"能"，只需要十分钟。
【免费下载链接】midea_ac_lanAuto-configure and then control your Midea M-Smart devices (Air conditioner, Fan, Water heater, Washer, etc) via local area network.项目地址: https://gitcode.com/gh_mirrors/mi/midea_ac_lan
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
