mdzio/ccu-historian Docker 镜像 - 轩辕镜像

CCU-Historian

这是CCU-Historian的官方Docker镜像。CCU-Historian用于捕获智能家居系统HomeMatic的CCU中央控制器运行数据。

此Docker镜像兼容不再维护的xjokay/ccu-historian镜像，环境变量和使用的卷无需修改即可继续使用。

环境变量

以下环境变量需在容器首次启动时设置。若配置文件ccu-historian.config不存在，将根据这些变量生成该文件。配置文件也可直接在卷/opt/ccu-historian/config（见下文）中编辑。

首次启动必需环境变量

更多信息请参见CCU-Historian手册的配置章节。

维护用可选环境变量

以下环境变量用于维护目的，为可选设置，每次容器启动时都会重新评估：

更多信息请参见CCU-Historian手册的启动参数章节。

开放网络端口

更多信息请参见CCU-Historian手册的防火墙设置章节。

需配置的卷

在/opt/ccu-historian/config目录中，若配置文件ccu-historian.config不存在，将基于环境变量生成该文件。

在/database目录中，首次启动时会创建数据库文件history.mv.db。

配置自动备份

可按以下步骤配置数据库自动备份：

1. 在/database卷中创建backup目录。
2. 在配置文件ccu-historian.config中添加以下行，将每周创建一次备份：

database.backup='/database/backup/db_%Y-w%W.zip'

记录日志输出

为便于故障排查，可将CCU-Historian的日志输出写入文本文件：

1. 在/database卷中创建log目录。
2. 在配置文件ccu-historian.config中添加以下行，将创建最多10个日志文件：

logSystem.fileLevel=Level.INFO
logSystem.fileName='/database/log/ccu-historian-%g.log'
logSystem.fileLimit=***
logSystem.fileCount=10

使用示例

Docker Compose启动

yml
services:
  app:
    image: mdzio/ccu-historian
    volumes:
      - ./data/database:/database
      - ./data/config:/opt/ccu-historian/config
    ports:
      - 80:80
      - 2098:2098
      - 2099:2099
      - 8082:8082
    environment:
      - CONFIG_CCU_TYPE=CCU3
      - CONFIG_CCU_IP=192.168.1.10
      - CONFIG_HOST_IP=192.168.1.100
      - CONFIG_HOST_BINRPCPORT=2099
      - CONFIG_HOST_XMLRPCPORT=2098
      - CONFIG_CCU_PLUGIN1_TYPE=CUXD
      - CONFIG_KEEP_MONTHS=12

Docker Run启动

sh
docker run -d \
  -v ./data/database:/database \
  -v ./data/config:/opt/ccu-historian/config \
  -p 80:80 \
  -p 2098:2098 \
  -p 2099:2099 \
  -p 8082:8082 \
  -e CONFIG_CCU_TYPE=CCU3 \
  -e CONFIG_CCU_IP=192.168.1.10  \
  -e CONFIG_HOST_IP=192.168.1.100 \
  -e CONFIG_HOST_BINRPCPORT=2099 \
  -e CONFIG_HOST_XMLRPCPORT=2098 \
  -e CONFIG_CCU_PLUGIN1_TYPE=CUXD \
  -e CONFIG_KEEP_MONTHS=12 \
  mdzio/ccu-historian