alexjunk/emoncms

emoncms Docker镜像文档

镜像概述

本镜像提供完整的emoncms安装环境，将所有必要组件整合到单个容器中，无需依赖其他第三方容器或插件即可独立运行。适用于能源监控、数据采集与管理场景，支持本地部署及Home Assistant集成。

核心功能与特性

• 集成核心服务：包含apache2（Web服务器）、redis（缓存）、mariadb（数据库）、eclipse mosquitto（MQTT broker）
• emoncms组件：集成emoncms核心及三个主要工作器（emoncms_mqtt、service-runner、feedwriter）
• 扩展模块：内置graph、dashboard、postprocess、backup、sync等模块
• 服务管理：采用s6-overlay进行容器内多服务管理
• 兼容性：可作为Home Assistant插件运行，也支持独立部署

使用场景

• Home Assistant用户需要集成能源监控系统
• 本地部署能源数据采集与分析平台
• 测试或开发基于emoncms的应用
• 生产环境中需要稳定运行的能源管理系统

使用方法

测试运行（无数据持久化）

适用于快速测试，容器停止后数据将丢失：

bash
# 拉取镜像
docker pull alexjunk/emoncms

# 运行容器（映射端口8081用于Web访问，7883用于MQTT）
docker run --rm -p 8081:80 -p 7883:1883 -it alexjunk/emoncms

持久化运行（保留数据）

创建主机数据目录并挂载卷以持久化存储数据：

bash
# 在主机创建数据目录
mkdir -p /path/to/host/data

# 带数据卷运行容器
docker run --rm -p 8081:80 -p 7883:1883 -v /path/to/host/data:/data -it alexjunk/emoncms

说明：/path/to/host/data 替换为主机实际目录，容器内/data目录将映射至此，实现数据持久化。

Docker Compose配置

完整的Docker Compose配置文件可参考 https://github.com/Open-Building-Management/compose-files 仓库。

测试数据集

可下载测试数据集进行功能验证：

bash
# 下载测试数据集
wget https://github.com/alexandrecuer/smartgrid/raw/master/datasets/no_user_table/bloch-2021.tar.gz

数据恢复方法：

1. 访问emoncms Web界面（http://localhost:8081）
2. 进入"备份"模块
3. 选择"导入归档"并上传下载的测试数据集压缩包

注意事项

• 版本选择：生产环境部署时，请勿拉取dev_test标签镜像（可能存在未完成或不可用版本）。建议选择Home Assistant插件中使用的版本，具体参考 https://github.com/Open-Building-Management/emoncms/blob/main/CHANGELOG.md%E3%80%82
• 在线文档：更多详细使用说明请参考 https://emoncms-docker.github.io%E3%80%82
• 详细变更日志：查看 https://github.com/Open-Building-Management/emoncms/discussions/8 获取详细更新记录。