# Zafro AC：本地替代 I4season 设备云服务

> zafro-ha-local 用局域网服务器替代 Zafro A9092R 空调使用的云端点。协议笔记根据抓取的设备流量记录 REST 登录、MQTT 3.1 WebSocket 消息、主题及状态命令；Python 服务处理设备连接，并通过 MQTT Discovery 向 Home Assistant 发布实体。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-06
- 收录于：2026-11-08
- 原始资源：<https://github.com/cgstever/zafro-ha-local>
- 一手来源：<https://github.com/cgstever/zafro-ha-local/blob/400d22ec1586bacf2192816149ea4c1fc3836eea/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/zafro-ha-local-case/>
- 记录 JSON：<https://awesomerea.org/resources/zafro-ha-local-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/zafro-ha-local-case/index.md)

## 使用条件与局限

- **前提条件：**需要常开的 Linux 主机、启用 MQTT 的 Home Assistant、消息代理、nginx、Python 3.9 或更新版本，以及本地 DNS 覆盖能力。
- **测试证据：**作者测试的设备为固件 1.0.28 的 Zafro A9092R-12K；其他 I4season 型号尚未确认。
- **范围：**空调使用旧式 TLS 1.2 RSA 密码套件且不发送 SNI，仓库提供的 nginx 配置对此作了适配。
- **许可：**采用 MIT 许可证。

## 一手来源

1. <https://github.com/cgstever/zafro-ha-local/blob/400d22ec1586bacf2192816149ea4c1fc3836eea/README.md>
2. <https://github.com/cgstever/zafro-ha-local/blob/400d22ec1586bacf2192816149ea4c1fc3836eea/docs/PROTOCOL.md>

## 同分区更多条目：协议

- [open-apt-flash：重建 APT 860C 的 UART 刷写协议](https://awesomerea.org/zh/resources/open-apt-flash-case/index.md) · 案例
- [MADLIONS 60 Configurator：重建 MAD60 USB HID 配置通信](https://awesomerea.org/zh/resources/madlions-configurator-case/index.md) · 案例
- [ax206-usb-display-macos：通过 USB 驱动 QDtech 显示屏](https://awesomerea.org/zh/resources/ax206-usb-display-macos-case/index.md) · 案例
- [SP542E MQTT ↔ BLE bridge：通过控制器协议实现本地控制](https://awesomerea.org/zh/resources/sp542e-ha-bridge-case/index.md) · 案例
- [ESPHome — Technibel SCDF32C5I IR Climate：重建空调红外控制](https://awesomerea.org/zh/resources/esphome-technibel-scdf32-case/index.md) · 案例
- [Atomberg BLDC IR Remote：重建风扇红外命令](https://awesomerea.org/zh/resources/atomberg-bldc-ir-remote-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。