snyll/sunnyhome

sunnyhome Docker镜像文档

镜像概述和主要用途

该镜像包含Amazon Linux、Java JDK 18以及一个.jar应用程序，通过Pocket Wifi与Solax X3逆变器的本地API通信，定期获取数据并通过Web界面展示。支持arm64架构（如Raspbian 64位系统），新增amd64平台支持（如部分Synology NAS）。

核心功能和特性

• 定期从Solax逆变器获取数据（每隔几秒）
• 提供Web GUI用于配置和数据展示
• 支持arm64架构设备（如树莓派运行Raspbian 64位系统）
• 新增amd64平台支持（适用于部分Synology NAS等设备）
• 支持Modbus协议（需映射串口设备）
• 数据持久化存储（通过卷挂载/data目录）

使用场景和适用范围

• 适用于需要监控Solax X3逆变器数据的用户（如家庭太阳能系统监控）
• 支持arm64架构设备（如树莓派运行Raspbian 64位系统）
• 支持amd64平台设备（如部分Synology NAS）
• 适合通过Web界面直观查看逆变器运行数据的场景

详细使用方法和配置说明

安装步骤

根据设备架构选择相应命令（以下示例为arm64平台，amd64平台需调整镜像标签和平台参数）：

基础运行命令（arm64平台）

bash
docker run -d -p 8802:8802 --platform=linux/arm64/v8 --name sunnyhome --mount source=sunnyhome,target=/data docker.xuanyuan.run/snyll/sunnyhome:arm64

支持Modbus协议的运行命令（需映射串口设备）

bash
docker run -d --restart always -p 8802:8802 --privileged -v /dev/ttyUSB0:/dev/ttyUSB0 --platform=linux/arm/v7 --name sunnyhome --mount source=sunnyhome,target=/data docker.xuanyuan.run/snyll/sunnyhome:arm64

访问和配置

1. 应用启动后，通过以下地址访问Web界面：
   https://your-ip:8802（将your-ip替换为设备实际IP地址）
2. 在Web GUI中完成应用配置

更新方法

1. 停止当前容器：

   bash
   docker stop sunnyhome
   

2. 删除容器：

   bash
   docker rm sunnyhome
   

3. 拉取最新镜像：

   bash
   docker pull docker.xuanyuan.run/snyll/sunnyhome:arm64
   

4. 使用初始运行命令重新启动容器（基础或Modbus版本，根据需求选择）

注意事项

• 平台参数需与设备架构匹配：arm64设备使用--platform=linux/arm64/v8，amd64设备使用相应amd64平台参数
• Modbus功能需确保物理串口设备正确映射（如/dev/ttyUSB0）
• /data目录通过卷挂载实现数据持久化，请勿删除该卷
• 首次启动后需通过Web GUI完成必要配置才能正常获取数据