Skip to main content
PromptQuorumPromptQuorum
主页/Balcony Solar/阳台光伏接入Home Assistant本地控制：品牌逐一指南
Balcony Solar Foundations

阳台光伏接入Home Assistant本地控制：品牌逐一指南

·阅读约11分钟·Hans Kuepper 作者 · PromptQuorum创始人，多模型AI调度工具 · PromptQuorum
选择语言:
🇺🇸en🇩🇪de🇫🇷fr🇯🇵ja🇨🇳zh🇪🇸es🇧🇷pt🇸🇦ar🇰🇷ko

三种协议路径覆盖了几乎所有阳台光伏品牌：Modbus TCP（通过以太网直接访问寄存器，可离线工作）、MQTT桥接（通过本地代理的发布/订阅）和本地REST API（向设备发出HTTP调用）。 可用路径取决于具体产品型号，而非仅取决于品牌。

大多数阳台光伏套件支持与Home Assistant的本地集成，但使用的协议取决于品牌和具体产品线。Anker SOLIX在502端口提供官方Modbus TCP。Hoymiles通过DTU-Pro网关使用同一协议。Zendure SolarFlow 800 Pro具有本地HTTP/MQTT API；旧款Zendure型号需要云端MQTT桥接。EcoFlow PowerStream仍依赖云端。

关键要点

  • 三种本地协议覆盖几乎所有品牌：Modbus TCP、MQTT桥接和本地REST API。正确的选择取决于具体设备型号，而非仅品牌。
  • Modbus TCP是最可靠的离线路径——无需互联网或云代理，通过局域网直接读取寄存器。
  • EcoFlow PowerStream是主要例外：截至2026-07-03验证日期，没有本地Modbus TCP或MQTT路径。所有监控均通过EcoFlow云端。
  • Victron Cerbo GX本地控制能力最强：官方HA集成（HA 2026.5起）、有文档的Modbus TCP和完全离线的本地MQTT。
  • 本地接口支持可能随固件更新而变化——购买前请验证当前集成仓库的状态。

本地集成的三种协议路径

Modbus TCP通过局域网直接读取设备寄存器——无需云账户、代理或适配器软件。 设备（或其本地网关）监听TCP端口（通常为502或8899）并响应寄存器读取命令。即使断开互联网连接也能继续工作。

MQTT桥接集成位于设备和Home Assistant之间。 设备向主题发布数据，适配器脚本或HACS集成订阅并创建HA实体。指向本地代理时完全离线运行。若设备仅连接云端代理，则仍需要互联网。

本地REST API路径使用HTTP GET/POST调用局域网上的设备或其网关。 Zendure SolarFlow 800 Pro原生提供此功能。Marstek通过Marstek本地API（HACS）提供。Kostal Plenticore使用与其内置网页UI相同的REST API。

📍 简单一句话

Modbus TCP通过局域网直接读取寄存器，MQTT桥接使用发布/订阅代理，本地REST API在设备上直接响应HTTP请求。

💬 简单来说

Modbus TCP＝家庭网络上的直接连接；MQTT＝需要代理中间人的消息传递系统；REST API＝设备像网站一样响应请求。

品牌兼容性矩阵

以下所有数据均于2026-07-03针对当前活跃的GitHub集成仓库和制造商文档进行了验证。本地接口支持可能随固件版本变化——将此表作为起点，购买前请验证当前状态。

品牌 / 产品Modbus TCP本地MQTT本地REST API可离线?HA集成
Anker SOLIX（储能）✅ 502端口，官方⚠️ 仅云端桥接—✅ 通过Modbusha-anker-solix-official (HACS)
Zendure SolarFlow 800 Pro—✅ 本地HTTP+MQTT✅ 本地HTTP✅Zendure/Zendure-HA（官方）
Zendure Hub 1200/2000, Hyper 2000—⚠️ 仅云端MQTT—❌z-master42/solarflow（社区）
Hoymiles HMS/HMT（DTU-Pro网关）✅ 通过DTU-Pro✅ OpenDTU / hoymiles-mqtt—✅hoymiles-mqtt-integration (HACS)
Marstek B2500 / Jupiter / Venus⚠️ 仅Venus支持RS485✅ hame-relay+hm2mqtt✅ Marstek本地API✅Marstek Local API v1.0.0 (HACS)
Growatt NOAH 2000 / 逆变器✅ 本地Modbus TCP✅ noah-mqtt / growatt2mqtt—✅Homeassistant-Growatt-Local-Modbus (HACS)
Deye SUN600G3（微型逆变器）✅ 8899端口（非官方）✅ SolarmanV5 / deye-inverter-mqtt—✅Solarman HACS集成
Victron Cerbo GX✅ 官方，已记录✅ 官方（HA 2026.5+）—✅官方HA集成
Sungrow SH-RT系列✅ 社区✅ ModbusTCP2MQTT—✅Sungrow-SHx-Inverter-Modbus (HACS)
Kostal Plenticore（G3+）✅ HACS集成—✅ 官方REST API✅官方HA集成（REST）
EcoFlow PowerStream❌❌ 仅云端MQTT❌❌tolwi/hassio-ecoflow-cloud（仅云端）

验证日期：2026-07-03。固件更新可能添加或移除本地访问——购买前请验证。

路径A：Modbus TCP设置

Modbus TCP有三个要求：设备与Home Assistant在同一局域网中、Modbus接口已启用，以及您的型号的寄存器映射。 大多数社区HACS集成内置寄存器映射——只需提供IP地址即可。

  1. 1
    在设备上启用Modbus TCP：Anker SOLIX → Anker应用 → 设备设置 → 启用Modbus。Hoymiles → DTU-Pro网页界面。Growatt → 默认启用。Deye → 无需设置，Logger Stick的8899端口始终开放。
  2. 2
    在路由器上为设备分配静态IP地址（或使用DHCP保留），确保HA集成地址不变。
  3. 3
    安装相应HACS集成：Anker用ha-anker-solix-official，Hoymiles用hoymiles-mqtt-integration，Growatt用Homeassistant-Growatt-Local-Modbus，Deye用Solarman集成，Victron用官方Victron GX集成。
  4. 4
    在集成设置中输入设备IP和端口。标准Modbus端口为502；Deye使用8899。
  5. 5
    检查HA中的传感器实体——当前输出功率应在5-10秒内更新。若实体显示"不可用"，请检查IP、Modbus启用状态和防火墙规则。

路径B：MQTT桥接设置

MQTT桥接集成通过运行小型适配器脚本（或HA插件）轮询设备或接收推送数据，并将其重新发布到本地Mosquitto代理。 Home Assistant通过MQTT集成订阅这些主题。指向本地代理后完全离线运行。

  1. 1
    将Mosquitto代理安装为HA插件（设置 → 插件 → Mosquitto Broker），配置用户名和密码。
  2. 2
    在HA中设置MQTT集成（设置 → 设备与服务 → 添加集成 → MQTT）并连接到本地代理。
  3. 3
    安装设备专用适配器：Growatt NOAH 2000用noah-mqtt，Marstek用hame-relay+hm2mqtt，Hoymiles用hoymiles-mqtt，Deye用deye-inverter-mqtt，Zendure用Zendure-HA。作为Docker容器或HA插件运行。
  4. 4
    将适配器指向设备IP，以及（可能的话）指向本地Mosquitto代理而非制造商云代理。
  5. 5
    确认数据流：实体应通过MQTT发现自动出现，或在HA MQTT集成的主题部分检查传入消息。

路径C：本地REST API

本地REST API意味着设备在局域网上运行HTTP服务器——无需单独的适配器。 Zendure SolarFlow 800 Pro、Marstek（通过Marstek本地API HACS集成）和Kostal Plenticore使用此路径。

  1. 1
    确认您的型号的本地API可用性：HACS集成README或制造商开发者门户。
  2. 2
    通过HACS安装集成：搜索"Marstek Local API"或"Kostal Plenticore"。Zendure-HA（官方）处理本地API和云MQTT两种路径。
  3. 3
    输入设备IP和（必要时）管理员密码（Kostal使用网页UI密码）。无需单独代理或适配器脚本。
  4. 4
    验证传感器实体和控制——对于Kostal和Marstek，这包括电池充电限制控制，而不仅是监控。

EVCC集成

EVCC（开源电动汽车充电控制器）可使用本地阳台光伏发电数据，将电动汽车充电与太阳能发电峰值同步。EVCC原生支持Modbus TCP和MQTT，因此通过路径A或B工作的任何设备也可作为EVCC电表源。在evcc.yaml中将设备配置为type: modbus（Modbus TCP）或type: mqtt（MQTT桥接）的电表。

常见问题

在Anker SOLIX上启用Modbus TCP会禁用Anker应用吗？

不会。Anker SOLIX官方Modbus集成与Anker应用和云端并行运行。在Anker应用设置中启用Modbus TCP只是添加本地寄存器访问，不会移除云端功能。

为什么矩阵中Zendure有两行？

Zendure SolarFlow 800 Pro具有无需互联网连接即可工作的本地HTTP/MQTT API。旧款Zendure型号（Hub 1200、Hub 2000、Hyper 2000、Ace 1500）只与Zendure的云MQTT代理通信。官方Zendure-HA集成支持两种路径。

EcoFlow PowerStream会获得本地控制支持吗？

EcoFlow在2025年中期表示本地解决方案正在开发中，但未给出发布日期。截至验证日期（2026-07-03），PowerStream没有经过验证的本地API或Modbus TCP路径。请查看EcoFlow开发者社区或hassio-ecoflow-cloud仓库了解当前状态。

哪个品牌整体本地控制能力最强？

Victron Cerbo GX本地控制能力最强：Home Assistant核心的官方集成（HA 2026.5起）、有公开寄存器映射的文档化Modbus TCP以及完全离线的本地MQTT。其次是Anker SOLIX，拥有官方社区HACS集成和502端口Modbus TCP，与云应用并行运行。

← 返回 Balcony Solar