30 分钟告别云端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 却在登录页转圈转到你想摔手机周末想提前把屋里凉下来得先等状态刷新三秒然后眼睁睁看着它超时。更离谱的是某天片区断网满屋智能家电集体失忆还不如墙角那台老红外遥控器——人家按一下空调当场嗡一声响应绝不迟到。问题出在哪不是你家的网不行而是你把控制权交给了云端。Midea AC LAN 这个开源项目就是要帮你把控制权拿回来它绕过厂商服务器在局域网里直接与美的 M-Smart 设备对话让 Home Assistant 统一接管空调、风扇、热水器、洗衣机等 30 多种设备实现真正的智能家居本地化控制。一、先搞清楚你被智能绑架了多久先别急着装东西我们得认清云端控制的三个代价这决定了你为什么要折腾这么一趟。代价一慢。一条指令从你家出发飞到厂商服务器再飞回来落进设备单程旅行少说几百毫秒。听起来不多但每次调温、开关都要等攒一年就是无数个卡顿瞬间。代价二裸奔。你今天几点开的空调、设了多少度、设备什么状态这些数据全都躺在厂商的服务器上。你不想被知道但你没法选择。代价三脆弱。厂商服务器一挂、你家宽带一出故障、或者 App 停止维护你的设备就只剩一个功能当摆设。而局域网直连的思路完全不同设备就在你家路由器下面指令走网线/ Wi-Fi 直达不绕路、不上传、不断供。这就是 Midea AC LAN 的核心价值——把智能的定义权还给你。二、一张表看懂本地控制 vs 云端控制光说没用直接上对比。同一台空调两种控制方式差距一目了然对比维度云端中转局域网直连Midea AC LAN指令响应300–500ms肉眼可见的延迟20–50ms几乎无感隐私数据上传厂商服务器你无法掌控全程留在家里不出局域网断网可用性完全瘫痪设备变砖完全可用照常控制数据所有权归厂商归你额外依赖App、账号、服务器状态只要路由器活着就行看懂这张表你就明白了为什么越来越多人愿意折腾本地化控制它不是更麻烦的方案而是更靠谱的方案。云端是便利的幻觉本地才是真实力。三、最快上手路径10 分钟跑通第一次本地控制理论铺垫够了动手。这一节的目标是让你用最短时间、最少步骤看到设备出现在 Home Assistant 里并能被控制。第 1 步检查环境3 分钟动手之前先确认四件事缺一个都可能让你白折腾检查项要求怎么验证同一子网设备与 Home Assistant 在同一网段ping 设备IP看是否通AP 隔离路由器需关闭该功能进路由器管理页找AP隔离/访客网络IP 分配设备用静态 IP别用 DHCP 租约在路由器里做 MAC 绑定HA 版本2022.5 及以上设置 → 系统信息里看版本号小提示AP 隔离是新手踩坑重灾区。路由器开了它设备之间默认互相看不见你的控制指令自然发不出去。排查时先看这里。第 2 步安装集成5 分钟走 HACS 最快最快上手路径就是 HACS全程鼠标点击不用碰命令行Home Assistant → HACS → 集成 → 右下角浏览并下载存储库 → 搜索 Midea AC LAN → 下载 → 重启 Home Assistant如果你是手动党也只需要两步git clone https://gitcode.com/gh_mirrors/mi/midea_ac_lan cp -r midea_ac_lan/custom_components/midea_ac_lan /path/to/homeassistant/custom_components/容器玩家就把custom_components/midea_ac_lan挂载进/config/custom_components/再重启道理一样。第 3 步添加设备并完成首次控制2 分钟重启完成后进入设置 → 设备与服务 → 添加集成搜Midea AC LAN。接下来按你的网络情况选自动发现标准家庭网络下点一下发现设备列表直接出来选设备确认即可手动添加自动发现失灵时填设备 IP、Token、Key 三个信息手动接进来。等实体加载完去概览里找到你的空调实体点一下开机、调个温度。当温度数值在你的操作下瞬间跳动的那一刻你就正式完成了第一次智能家居本地化控制——全程不到 10 分钟。四、深入原理它凭什么不靠云端能跑通当然好但知其然还要知其所以然。Midea AC LAN 不靠云端的技术底气来自三个方面。1. 协议逆向破译设备自说自话的方言美的的 M-Smart 协议本来是给自家 App 用的就像设备只说一种别人听不懂的方言。项目作者做的事相当于蹲在设备旁边偷听它和官方 App 的对话一句句记下来、推敲语法、总结规律最后整理成一本完整的方言词典。这就是协议逆向工程——没有官方说明书全靠观察和推理硬是把通信规则摸了个底朝天。2. 分层架构各司其职的通信流水线搞清楚了怎么说还要解决怎么组织。整个通信链路被拆成清晰的四层每一层只管自己的事应用层 Home Assistant 集成气候、风扇、传感器等实体 ↓ 适配层 Midea AC LAN 组件设备类型分发、状态映射 ↓ 通信层 TCP/UDP 协议处理握手、心跳、长连接 ↓ 安全层 Token 认证 AES 加密身份与数据保护你只要知道上层负责干什么下层负责怎么送。项目里custom_components/midea_ac_lan/midea/devices/目录下按设备型号分了 30 多个子目录每种设备一套专属适配逻辑新增设备类型时只需照着模板加一个这就是模块化的好处。3. 双重安全回家要过两道门没有云端安全性怎么保证项目用了两道锁Token 认证每台设备出厂带一个唯一 Token相当于家门钥匙。钥匙不对门铃都不会响。AES 加密所有指令在发送前加密相当于信纸上的字只有收件人看得懂中途被截获也是一堆乱码。用一句话概括先验明正身再加密通话。两道锁都在本地完成不需要任何外部服务器参与。再说说 TCP 长连接——这是局域网直连体验好的关键。它不像 HTTP 那样每次请求都要重新敲门而是一次握手后保持一条常开的通道设备状态一变消息立刻顺着通道推过来你不用轮询、不用等待自然又快又省。五、进阶玩法3 个让设备变聪明的联动思路设备接进来了接下来才是智能家居最好玩的部分——让设备之间互相协作。给你三个可以直接抄的作业玩法 1热了才制冷冷了才升温温湿度舒适联动接一个温湿度传感器让空调自己判断该不该干活# 体感指数低于阈值才启动制冷 automation: - alias: 闷热自动开空调 trigger: platform: time_pattern minutes: /5 # 每 5 分钟检查一次 condition: - condition: numeric_state entity_id: sensor.living_room_temperature above: 28 - condition: numeric_state entity_id: sensor.living_room_humidity above: 60 action: - service: climate.turn_on target: entity_id: climate.midea_ac_living温湿度都超了才开机省电又不至于冻着人。比起人肉盯遥控器这才是智能该有的样子。玩法 2电价贵的时候少用点分时电价调度如果你家所在地区有峰谷电价可以做个简单的省钱逻辑# 高峰时段自动调高设定温度 automation: - alias: 峰电时段空调省电模式 trigger: platform: time at: 14:00:00 action: - service: climate.set_temperature target: entity_id: climate.midea_ac_living data: temperature: 27同理晚上低谷时段可以反向操作把热水器加热时间挪到便宜的电价区间。一台热水器一年省下的电费可能就够你吃顿好的了。玩法 3出门一键清场离家全屋关闭把离家变成一键完成的事而不是挨个房间关设备script: leave_home: alias: 离家清场 sequence: - service: climate.turn_off target: entity_id: climate.midea_ac_living - service: fan.turn_off target: entity_id: fan.midea_fa_bedroom - service: switch.turn_off target: entity_id: switch.midea_water_heater把这段脚本挂到门磁传感器上开门即触发从此再也不用担心出门忘关空调。六、排障速查一份拿来就用的对照表折腾过程中遇到问题很正常别慌按表排查90% 的问题十分钟内能解决症状优先检查解决办法设备完全找不到ping 设备 IPping 不通就查网线、Wi-Fi、AP 隔离找到了但连不上Token / Key 是否正确重新抓取认证信息再填一遍一直提示超时防火墙是否挡了 6444 端口放行 TCP 6444 端口能连上但状态不更新刷新间隔是否过大调低 refresh_interval日志报 decrypt error密钥不匹配确认 Key 与设备固件版本对应排障思路也可以用一张流程图走一遍怎么开启调试日志在configuration.yaml里加一段logger: default: warn logs: custom_components.midea_ac_lan: debug然后用tail -f /config/home-assistant.log盯日志。看到connect failed是网络问题invalid token是认证问题timeout是设备无响应decrypt error是密钥不匹配——关键词对上了病因基本就清楚了。顺手做两个调优想要更跟手的控制体验把刷新间隔从默认值调到 15 秒左右如果网络环境不太稳把超时时间放宽到 10 秒减少误判重试带来的抖动。七、继续进阶官方文档与社区资源到这里你已经能独立完成本地化控制了。想更进一步下面这些资源按顺序吃透你就是半个专家官方设备文档按需查阅每种设备都有专门说明空调官方文档见 doc/AC.md风扇官方文档见 doc/FA.md热水器官方文档见 doc/E3.md其他 30 设备类型文档都在doc/目录下翻对应型号即可核心源码阅读顺序想搞懂实现原理按这个顺序读midea/core/device.py— 设备通信基类先看它理解整体通信骨架midea/core/message.py— 消息的编解码看它理解数据怎么在线上跑midea/core/security.py— 加密与认证看它理解安全机制midea/devices/ac/device.py— 拿空调当范例看具体设备如何适配社区求助的正确姿势先搜有没有人遇到过同样的问题贴问题时带上设备型号、Home Assistant 版本、网络拓扑和 debug 日志再把复现步骤写清楚。信息越全别人越能帮你定位。八、写在最后本地化控制是大势但路要一步步走回头看看这一路从被云端绑架的伪智能到 10 分钟跑通局域网直连再到让设备自己协作——你做的事情其实是在给智能家居松绑。趋势也很明显边缘计算让设备本地处理能力越来越强隐私法规让数据留在家里成为刚需而厂商也渐渐意识到开放本地接口才是长期主义。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），仅供参考 30 分钟告别云端：Midea AC LAN 智能家居本地化控制完全上手指南
30 分钟告别云端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 却在登录页转圈转到你想摔手机周末想提前把屋里凉下来得先等状态刷新三秒然后眼睁睁看着它超时。更离谱的是某天片区断网满屋智能家电集体失忆还不如墙角那台老红外遥控器——人家按一下空调当场嗡一声响应绝不迟到。问题出在哪不是你家的网不行而是你把控制权交给了云端。Midea AC LAN 这个开源项目就是要帮你把控制权拿回来它绕过厂商服务器在局域网里直接与美的 M-Smart 设备对话让 Home Assistant 统一接管空调、风扇、热水器、洗衣机等 30 多种设备实现真正的智能家居本地化控制。一、先搞清楚你被智能绑架了多久先别急着装东西我们得认清云端控制的三个代价这决定了你为什么要折腾这么一趟。代价一慢。一条指令从你家出发飞到厂商服务器再飞回来落进设备单程旅行少说几百毫秒。听起来不多但每次调温、开关都要等攒一年就是无数个卡顿瞬间。代价二裸奔。你今天几点开的空调、设了多少度、设备什么状态这些数据全都躺在厂商的服务器上。你不想被知道但你没法选择。代价三脆弱。厂商服务器一挂、你家宽带一出故障、或者 App 停止维护你的设备就只剩一个功能当摆设。而局域网直连的思路完全不同设备就在你家路由器下面指令走网线/ Wi-Fi 直达不绕路、不上传、不断供。这就是 Midea AC LAN 的核心价值——把智能的定义权还给你。二、一张表看懂本地控制 vs 云端控制光说没用直接上对比。同一台空调两种控制方式差距一目了然对比维度云端中转局域网直连Midea AC LAN指令响应300–500ms肉眼可见的延迟20–50ms几乎无感隐私数据上传厂商服务器你无法掌控全程留在家里不出局域网断网可用性完全瘫痪设备变砖完全可用照常控制数据所有权归厂商归你额外依赖App、账号、服务器状态只要路由器活着就行看懂这张表你就明白了为什么越来越多人愿意折腾本地化控制它不是更麻烦的方案而是更靠谱的方案。云端是便利的幻觉本地才是真实力。三、最快上手路径10 分钟跑通第一次本地控制理论铺垫够了动手。这一节的目标是让你用最短时间、最少步骤看到设备出现在 Home Assistant 里并能被控制。第 1 步检查环境3 分钟动手之前先确认四件事缺一个都可能让你白折腾检查项要求怎么验证同一子网设备与 Home Assistant 在同一网段ping 设备IP看是否通AP 隔离路由器需关闭该功能进路由器管理页找AP隔离/访客网络IP 分配设备用静态 IP别用 DHCP 租约在路由器里做 MAC 绑定HA 版本2022.5 及以上设置 → 系统信息里看版本号小提示AP 隔离是新手踩坑重灾区。路由器开了它设备之间默认互相看不见你的控制指令自然发不出去。排查时先看这里。第 2 步安装集成5 分钟走 HACS 最快最快上手路径就是 HACS全程鼠标点击不用碰命令行Home Assistant → HACS → 集成 → 右下角浏览并下载存储库 → 搜索 Midea AC LAN → 下载 → 重启 Home Assistant如果你是手动党也只需要两步git clone https://gitcode.com/gh_mirrors/mi/midea_ac_lan cp -r midea_ac_lan/custom_components/midea_ac_lan /path/to/homeassistant/custom_components/容器玩家就把custom_components/midea_ac_lan挂载进/config/custom_components/再重启道理一样。第 3 步添加设备并完成首次控制2 分钟重启完成后进入设置 → 设备与服务 → 添加集成搜Midea AC LAN。接下来按你的网络情况选自动发现标准家庭网络下点一下发现设备列表直接出来选设备确认即可手动添加自动发现失灵时填设备 IP、Token、Key 三个信息手动接进来。等实体加载完去概览里找到你的空调实体点一下开机、调个温度。当温度数值在你的操作下瞬间跳动的那一刻你就正式完成了第一次智能家居本地化控制——全程不到 10 分钟。四、深入原理它凭什么不靠云端能跑通当然好但知其然还要知其所以然。Midea AC LAN 不靠云端的技术底气来自三个方面。1. 协议逆向破译设备自说自话的方言美的的 M-Smart 协议本来是给自家 App 用的就像设备只说一种别人听不懂的方言。项目作者做的事相当于蹲在设备旁边偷听它和官方 App 的对话一句句记下来、推敲语法、总结规律最后整理成一本完整的方言词典。这就是协议逆向工程——没有官方说明书全靠观察和推理硬是把通信规则摸了个底朝天。2. 分层架构各司其职的通信流水线搞清楚了怎么说还要解决怎么组织。整个通信链路被拆成清晰的四层每一层只管自己的事应用层 Home Assistant 集成气候、风扇、传感器等实体 ↓ 适配层 Midea AC LAN 组件设备类型分发、状态映射 ↓ 通信层 TCP/UDP 协议处理握手、心跳、长连接 ↓ 安全层 Token 认证 AES 加密身份与数据保护你只要知道上层负责干什么下层负责怎么送。项目里custom_components/midea_ac_lan/midea/devices/目录下按设备型号分了 30 多个子目录每种设备一套专属适配逻辑新增设备类型时只需照着模板加一个这就是模块化的好处。3. 双重安全回家要过两道门没有云端安全性怎么保证项目用了两道锁Token 认证每台设备出厂带一个唯一 Token相当于家门钥匙。钥匙不对门铃都不会响。AES 加密所有指令在发送前加密相当于信纸上的字只有收件人看得懂中途被截获也是一堆乱码。用一句话概括先验明正身再加密通话。两道锁都在本地完成不需要任何外部服务器参与。再说说 TCP 长连接——这是局域网直连体验好的关键。它不像 HTTP 那样每次请求都要重新敲门而是一次握手后保持一条常开的通道设备状态一变消息立刻顺着通道推过来你不用轮询、不用等待自然又快又省。五、进阶玩法3 个让设备变聪明的联动思路设备接进来了接下来才是智能家居最好玩的部分——让设备之间互相协作。给你三个可以直接抄的作业玩法 1热了才制冷冷了才升温温湿度舒适联动接一个温湿度传感器让空调自己判断该不该干活# 体感指数低于阈值才启动制冷 automation: - alias: 闷热自动开空调 trigger: platform: time_pattern minutes: /5 # 每 5 分钟检查一次 condition: - condition: numeric_state entity_id: sensor.living_room_temperature above: 28 - condition: numeric_state entity_id: sensor.living_room_humidity above: 60 action: - service: climate.turn_on target: entity_id: climate.midea_ac_living温湿度都超了才开机省电又不至于冻着人。比起人肉盯遥控器这才是智能该有的样子。玩法 2电价贵的时候少用点分时电价调度如果你家所在地区有峰谷电价可以做个简单的省钱逻辑# 高峰时段自动调高设定温度 automation: - alias: 峰电时段空调省电模式 trigger: platform: time at: 14:00:00 action: - service: climate.set_temperature target: entity_id: climate.midea_ac_living data: temperature: 27同理晚上低谷时段可以反向操作把热水器加热时间挪到便宜的电价区间。一台热水器一年省下的电费可能就够你吃顿好的了。玩法 3出门一键清场离家全屋关闭把离家变成一键完成的事而不是挨个房间关设备script: leave_home: alias: 离家清场 sequence: - service: climate.turn_off target: entity_id: climate.midea_ac_living - service: fan.turn_off target: entity_id: fan.midea_fa_bedroom - service: switch.turn_off target: entity_id: switch.midea_water_heater把这段脚本挂到门磁传感器上开门即触发从此再也不用担心出门忘关空调。六、排障速查一份拿来就用的对照表折腾过程中遇到问题很正常别慌按表排查90% 的问题十分钟内能解决症状优先检查解决办法设备完全找不到ping 设备 IPping 不通就查网线、Wi-Fi、AP 隔离找到了但连不上Token / Key 是否正确重新抓取认证信息再填一遍一直提示超时防火墙是否挡了 6444 端口放行 TCP 6444 端口能连上但状态不更新刷新间隔是否过大调低 refresh_interval日志报 decrypt error密钥不匹配确认 Key 与设备固件版本对应排障思路也可以用一张流程图走一遍怎么开启调试日志在configuration.yaml里加一段logger: default: warn logs: custom_components.midea_ac_lan: debug然后用tail -f /config/home-assistant.log盯日志。看到connect failed是网络问题invalid token是认证问题timeout是设备无响应decrypt error是密钥不匹配——关键词对上了病因基本就清楚了。顺手做两个调优想要更跟手的控制体验把刷新间隔从默认值调到 15 秒左右如果网络环境不太稳把超时时间放宽到 10 秒减少误判重试带来的抖动。七、继续进阶官方文档与社区资源到这里你已经能独立完成本地化控制了。想更进一步下面这些资源按顺序吃透你就是半个专家官方设备文档按需查阅每种设备都有专门说明空调官方文档见 doc/AC.md风扇官方文档见 doc/FA.md热水器官方文档见 doc/E3.md其他 30 设备类型文档都在doc/目录下翻对应型号即可核心源码阅读顺序想搞懂实现原理按这个顺序读midea/core/device.py— 设备通信基类先看它理解整体通信骨架midea/core/message.py— 消息的编解码看它理解数据怎么在线上跑midea/core/security.py— 加密与认证看它理解安全机制midea/devices/ac/device.py— 拿空调当范例看具体设备如何适配社区求助的正确姿势先搜有没有人遇到过同样的问题贴问题时带上设备型号、Home Assistant 版本、网络拓扑和 debug 日志再把复现步骤写清楚。信息越全别人越能帮你定位。八、写在最后本地化控制是大势但路要一步步走回头看看这一路从被云端绑架的伪智能到 10 分钟跑通局域网直连再到让设备自己协作——你做的事情其实是在给智能家居松绑。趋势也很明显边缘计算让设备本地处理能力越来越强隐私法规让数据留在家里成为刚需而厂商也渐渐意识到开放本地接口才是长期主义。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），仅供参考