youforge-max/solax-domoticz

# Solax Pocket WiFi → Domoticz (本地，无云端) 将 **Solax Pocket WiFi (V2 / MXCHIP)** 数据采集器的实时数据直接拉取到 [Domoticz](https://www.domoticz.com/)，通过数据采集器自带的 WiFi 接入点进行连接 — **无需 Solax Cloud、无需 API 密码、无需注册码**。 整个核心技巧在于**固件**。最新的原厂固件 (`2.034.06`) 锁定了 本地 REST API；而旧版的 `2.033.20` 则在无需密码的情况下保持开放。只要数据采集器运行的是 `2.033.20`，Domoticz 就能直接通过 `http://5.8.8.8/` 与其进行通信。 ``` [Inverter] --USB--> [Solax Pocket WiFi fw 2.033.20] | open AP Wifi_ (network 5.8.8.0/24) | [Pi wlan0 5.8.8.9] --HTTP/0.9 POST--> [Domoticz SolaxHTTP plugin] | | [Pi eth0 LAN] :8080 <----------+ browser / automations ``` - **Cloud：** 关闭（已清除数据采集器的路由器 SSID；关闭了服务器连接）。 - **API 认证：** 在 `2.033.20` 上无需任何认证。 - **传输协议：** 数据采集器使用的是纯 **HTTP/0.9** 协议 —— 客户端必须允许此协议 (`curl --http0.9`)。 ## 为什么会有此项目 Solax 在较新的固件中移除了便捷的本地访问权限。他们官方的 FAQ 提到，本地密码是 `admin`（以 `SW` 开头的注册码）或者是注册码本身 —— 但在原厂的 `2.034.06` 上，如果没有真实的注册码，这两个都无法使用，而真实注册码并没有印在用户可以找到的任何地方。切实可行的解决方案是降级并运行最后一个曾开放提供 API 服务的固件版本。 ## 仓库结构 | 路径 | 内容说明 | |------|------| | [`INSTALL.md`](INSTALL.md) | 完整设置指南：固件降级、Pi WiFi 桥接、Domoticz 插件 + 硬件配置 | | [`docs/USER_GUIDE.md`](docs/USER_GUIDE.md) | 日常使用、故障排除、命令速查表、固件重新降级说明 | | [`docs/API.md`](docs/API.md) | Pocket WiFi 2.0 本地 API 端点参考 | | [`plugin/README.md`](plugin/README.md) | 关于 Domoticz `SolaxHTTP` 插件的说明 + 需注意的密码处理 bug | | [`firmware/`](firmware/) | 获取 `2.033.20` `.usb` 镜像（社区解锁版）的途径 + 用于校验的校验和 | | [`SECURITY.md`](SECURITY.md) | **开放 AP 风险、固件逆向工程 (RE) 发现及缓解措施 —— 请优先阅读** | | [`config.example.env`](config.example.env) | 需要您根据自身网络环境替换的占位符变量值 | ## 快速开始 1. 将数据采集器降级至 `2.033.20`（参见 [安装指南](INSTALL.md#1-firmware-downgrade)）。 2. 将一台备用 Pi 的 `wlan0` 连接到数据采集器的 AP `Wifi_`。 3. 在 Domoticz 中安装 `SolaxHTTP` 插件，添加硬件并指向 `5.8.8.8:80`，模式选择 **V2**，密码字段留**空**。 4. 观察传感器数据的自动填充。 完整操作流程请参见 [INSTALL.md](INSTALL.md)。 ## 范围与安全性 - 本项目介绍的是一种**自托管、仅限局域网 (LAN-only)** 的集成方案。无云依赖。 - 固件降级及社区构建的 `.usb` 镜像属于**使用者风险自负**； 在开始之前，请先阅读 [docs/USER_GUIDE.md](docs/USER_GUIDE.md#security-notes)。 - 该数据采集器会广播一个**开放的**接入点 (AP)。在将其桥接到包含任何敏感数据的网络之前，请充分了解其暴露风险。 ## 许可证 MIT — 详见 [LICENSE](LICENSE)。

标签：Domoticz, Solax, 固件降级, 智能家居, 物联网, 逆变器集成, 逆向工具