sallius/tsun-gen3-proxy

TSUN-Gen3-Proxy

概述

TSUN-Gen3-Proxy是TSUN第三代（GEN3）和GEN3PLUS微型逆变器的专用代理工具，用于建立逆变器与MQTT broker之间的可靠连接。通过该代理，可实时获取逆变器的功率、电流、日发电量等关键数据，并集成到家庭自动化系统中。其核心工作机制是介入逆变器与TSUN Cloud的TCP连接：逆变器先连接代理，代理再选择性连接TSUN Cloud（默认启用），解析数据后同时转发至MQTT broker和TSUN Cloud（若启用）。该工具支持无互联网环境运行，禁用TSUN Cloud连接后数据仅本地流转，但会失去固件更新和远程参数调整功能。

核心功能与特性

• 设备兼容性：支持TSUN GEN3/GEN3PLUS系列微型逆变器（如TSOL MS600、MS800、MS2000）
• 数据采集：实时解析并转发逆变器的功率、电流、日发电量等运行数据
• 双向转发：同时向MQTT broker和TSUN Cloud（可选）传输数据，确保数据完整性
• 离线运行：无互联网环境下仍可通过MQTT broker实现本地数据采集与监控
• 隐私控制：可选禁用TSUN Cloud连接（默认启用），防止数据上传至互联网
• 自动化集成：支持与主流家庭自动化系统对接，实现基于发电数据的联动控制

使用场景与适用范围

• 家庭太阳能监控：实时查看户用光伏系统的发电状态和历史数据
• 家庭自动化：将发电数据接入智能家居平台，实现用电设备智能调节（如优先使用太阳能供电）
• 本地数据管理：对网络隐私敏感场景，通过禁用云连接实现数据本地化存储与分析
• 无网环境部署：适用于偏远地区或网络不稳定的太阳能系统，确保基础监控功能可用

使用方法与配置说明

基本部署要求

• 确保逆变器与代理所在主机网络互通，逆变器需配置为连接代理IP而非默认TSUN Cloud地址
• 已部署MQTT broker（如Mosquitto、EMQX），并获取其连接地址、端口及认证信息（若需）

Docker部署示例

1. 简单运行（默认启用TSUN Cloud）

bash
docker run -d \
  --name tsun-gen3-proxy \
  --restart unless-stopped \
  -p 8080:8080 \  # 代理服务端口（需与逆变器配置一致）
  -e MQTT_BROKER="mqtt://your-mqtt-ip:1883" \  # MQTT broker地址:端口
  -e MQTT_USER="mqtt-user" \  # MQTT用户名（可选）
  -e MQTT_PASSWORD="mqtt-pass" \  # MQTT密码（可选）
  s-allius/tsun-gen3-proxy:latest

2. 禁用TSUN Cloud连接（本地数据模式）

bash
docker run -d \
  --name tsun-gen3-proxy \
  --restart unless-stopped \
  -p 8080:8080 \
  -e MQTT_BROKER="mqtt://your-mqtt-ip:1883" \
  -e DISABLE_CLOUD="true" \  # 禁用TSUN Cloud连接
  s-allius/tsun-gen3-proxy:latest

关键配置参数说明

注意事项

• 逆变器需通过本地管理界面或物理配置，将服务器地址修改为代理所在主机的IP，端口与PROXY_PORT一致
• 禁用TSUN Cloud后，逆变器的固件更新、远程功率调整等功能将不可用，需手动维护
• 详细配置与故障排查请参考项目GitHub文档：https://github.com/s-allius/tsun-gen3-proxy/blob/main/README.md