m0ngr31/genmon

Genmon Docker镜像文档

镜像概述和主要用途

本镜像为Genmon应用的Docker化部署方案，基于skipfire、JMVS和gregmac的开源项目成果构建。项目支持每周自动发布版本，专门优化以兼容ESP32设备，如OpenGenSet商用设备或基于Genmon-ESP32-Serial-Bridge的DIY版本，适用于发电机监控场景的容器化部署。

核心功能和特性

• 自动版本管理：通过脚本实现每周自动发布更新版本，确保功能及时迭代
• ESP32设备兼容：针对ESP32硬件平台优化，支持OpenGenSet及DIY串口桥设备
• 多架构支持：覆盖主流硬件架构，包括amd64/x86_64、aarch64/ARMv8、ARMv7和ARMv6
• 简化部署：通过Docker容器化设计，降低环境配置复杂度，实现快速启停

使用场景和适用范围

适用于需要对发电机运行状态进行监控的场景，特别适合以下用户：

• 使用ESP32设备（如OpenGenSet）进行发电机数据采集的用户
• 采用Genmon-ESP32-Serial-Bridge方案构建DIY监控系统的开发者
• 需要跨架构部署发电机监控服务的企业或个人用户

使用方法和配置说明

基本部署示例

通过以下命令快速启动容器：

sh
docker run -d \
    -e TZ="America/New_York" \  # 设置时区（根据实际需求调整）
    -p 8000:8000 \              # 映射Web管理端口
    -v config_dir:/etc/genmon \ # 挂载配置目录（替换config_dir为本地路径）
    --name genmon \             # 指定容器名称
    m0ngr31/genmon

Home Assistant集成

如需与Home Assistant联动，请参考官方文档：https://github.com/gregmac/Genmon-ESP32-Serial-Bridge

多架构镜像使用

最新版本已支持多种硬件架构，Docker引擎会自动根据宿主机架构拉取匹配镜像：

sh
# 拉取指定版本（不指定TAG则默认拉取latest）
docker pull m0ngr31/genmon:<TAG>

支持架构：amd64/x86_64、aarch64/ARMv8、ARMv7、ARMv6。