ualex73/dsmr-reader-docker Docker 镜像 - 轩辕镜像

DSMR-Reader Docker镜像

镜像概述和主要用途

该镜像用于运行DSMR-Reader（[***] fork 开发，解决了原镜像更新不及时及树莓派多架构支持不足的问题，同时支持通过同一镜像运行远程数据记录器。当Dennis发布新版本时，镜像会自动构建。

支持的架构

• amd64 - 适用于常规Intel/AMD系统（默认）
• arm32v6 - 适用于Raspberry Pi 1/2/Zero
• arm32v7 - 适用于Raspberry Pi 2/Zero 2
• arm64v8 - 适用于Raspberry Pi 3及更高版本

树莓派特殊配置

树莓派版本基于Alpine构建，但Alpine 3.13中对容器日期进行了从32位到64位的破坏性变更。为确保树莓派镜像正常运行，需将"libseccomp2"升级至2.4.2或更高版本。由于稳定版Raspbian仓库中默认不提供该版本，需从backports安装，执行以下命令：

$ sudo su -
# apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 04EE7237B7D453EC 648ACFD622F3D138
# echo 'deb [***] buster-backports main contrib non-free' | tee -a /etc/apt/sources.list.d/debian-backports.list
# apt update
# apt install libseccomp2 -t buster-backports  

暴露端口

• 80 : WebGUI

注意：如需HTTPS，请使用Traefik或其他代理实现，这样可避免修改DSMR-Reader标准配置，便于后续升级。

卷（可选）

/home/dsmr/app/backups

设备

/dev/ttyUSB0 - P1接口连接的串行设备示例

环境变量（可选）

DSMR_MODE - 设置DSMR运行模式（默认值为SERVER）：

• SERVER - 运行所有进程，包括后端、GUI和数据记录器
• SERVER-NO-DATALOGGER - 运行服务器模式但不包含数据记录器进程，需配合远程数据记录器收集DSMR报文
• DATALOGGER - 仅启动数据记录器客户端，将P1报文发送至服务器，需配置DATALOGGER_*环境变量

所有环境变量详见：[***]

数据记录器配置：

• DSMRREADER_DATALOGGER_API_HOSTS - 目标DSMR Reader主机，逗号分隔，使用数据记录器时必填
• DSMRREADER_DATALOGGER_API_KEYS - DSMR Reader API密钥，逗号分隔，使用数据记录器时必填
• DSMRREADER_DATALOGGER_INPUT_METHOD - 连接方式：serial或ipv4（默认值为serial）
• DSMRREADER_DATALOGGER_SERIAL_PORT - 串行端口名称（默认值为/dev/ttyUSB0），仅在输入方式为serial时使用
• DSMRREADER_DATALOGGER_SERIAL_BAUDRATE - 串行端口速率（默认值为***），仅在输入方式为serial时使用
• DSMRREADER_DATALOGGER_NETWORK_HOST - 网络主机（默认值为localhost），仅在输入方式为ipv4时使用
• DSMRREADER_DATALOGGER_NETWORK_PORT - 网络端口（默认值为2000），仅在输入方式为ipv4时使用

数据记录器更多信息：[***]

Docker Run示例

以下命令启动镜像（不含PostgreSQL服务器），示例中假设PostgreSQL运行在"192.168.1.1"：

docker run -d \
  --name dsmr \
  --restart unless-stopped \
  -p 8888:80 \
  -e DJANGO_DATABASE_HOST=192.168.1.1 \
  -e DSMRREADER_ADMIN_USER=admin \
  -e DSMRREADER_ADMIN_PASSWORD=admin \
  -v /dev:/dev \
  --device /dev/ttyUSB0:/dev/ttyUSB0 \
  ualex73/dsmr-reader-docker

docker-compose.yaml示例

yaml
version: '3'
services:
  db-dsmr:
    image: postgres
    container_name: db-dsmr
    volumes:
      - <dir>/db:/var/lib/postgresql/data
    restart: unless-stopped
    environment:
      - POSTGRES_USER=dsmrreader
      - POSTGRES_PASSWORD=dsmrreader
      - POSTGRES_DB=dsmrreader
    networks:
      - net-dsmr

  dsmr:
    container_name: dsmr
    image: ualex73/dsmr-reader-docker
    restart: unless-stopped
    volumes:
      - ./dsmr/backups:/home/dsmr/app/backups
      - /dev:/dev
    environment:
      - DJANGO_DATABASE_HOST=db-dsmr
      - DSMRREADER_ADMIN_USER=admin
      - DSMRREADER_ADMIN_PASSWORD=password
    ports:
      - 8888:80
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0
    networks:
      - net-dsmr

networks:
  net-dsmr:
    driver: bridge

使用docker-compose启动容器：

docker-compose -f docker-compose.yaml up -d db-dsmr
docker-compose -f docker-compose.yaml up -d dsmr

PostgreSQL数据库

docker-compose中的"db-dsmr"使用Docker卷存储数据，因此即使应用和容器被移除，PostgreSQL数据仍会保留。

备份PostgreSQL数据库到SQL文件：

1. 停止DSMR-Reader容器：

docker-compose stop dsmr

2. 导出PostgreSQL数据：

docker exec -t db-dsmr pg_dumpall -c -U dsmrreader >postgresql-dump.sql

3. 重新启动DSMR-Reader容器：

docker-compose start dsmr

从SQL文件恢复数据库：

1. 停止DSMR-Reader容器：

docker-compose stop dsmr

2. 如存在现有数据库，删除它：

docker exec -t db-dsmr dropdb dsmrreader -U dsmrreader

3. 在PostgreSQL中创建数据库：

docker exec -t db-dsmr createdb -O dsmrreader dsmrreader -U dsmrreader

4. 将SQL数据导入数据库：

cat postgresql-dump.sql | docker exec -i db-dsmr psql -U dsmrreader

5. 重新启动DSMR-Reader容器：

docker-compose start dsmr