mdzio/ccu-historian

CCU-Historian

这是https://github.com/mdzio/ccu-historian%E7%9A%84%E5%AE%98%E6%96%B9Docker%E9%95%9C%E5%83%8F%E3%80%82CCU-Historian%E7%94%A8%E4%BA%8E%E6%8D%95%E8%8E%B7%E6%99%BA%E8%83%BD%E5%AE%B6%E5%B1%85%E7%B3%BB%E7%BB%9FHomeMatic%E7%9A%84CCU%E4%B8%AD%E5%A4%AE%E6%8E%A7%E5%88%B6%E5%99%A8%E8%BF%90%E8%A1%8C%E6%95%B0%E6%8D%AE%E3%80%82

此Docker镜像兼容不再维护的https://hub.docker.com/r/xjokay/ccu-historian%E9%95%9C%E5%83%8F%EF%BC%8C%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E5%92%8C%E4%BD%BF%E7%94%A8%E7%9A%84%E5%8D%B7%E6%97%A0%E9%9C%80%E4%BF%AE%E6%94%B9%E5%8D%B3%E5%8F%AF%E7%BB%A7%E7%BB%AD%E4%BD%BF%E7%94%A8%E3%80%82

环境变量

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

首次启动必需环境变量

更多信息请参见https://github.com/mdzio/ccu-historian/wiki#konfiguration%E3%80%82

维护用可选环境变量

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

更多信息请参见https://github.com/mdzio/ccu-historian/wiki#startparameter%E3%80%82

开放网络端口

更多信息请参见https://github.com/mdzio/ccu-historian/wiki#firewall-einstellungen%E3%80%82

需配置的卷

在/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=10000000
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