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

dsmr-reader Docker镜像文档

概述

本镜像为dsmr-reader项目提供容器化部署方案，dsmr-reader是一款开源应用，用于读取、存储和分析符合DSMR（数字式电表通信协议）标准的智能电表数据，支持通过Web界面进行数据可视化和报表生成。

核心功能与特性

• DSMR协议支持：兼容DSMR v2.2至v5.0等主流协议版本，适配多数欧洲智能电表
• 数据采集：支持通过串口（USB-to-serial）或网络（TCP/IP）方式读取电表数据
• 数据存储：集成数据持久化功能，支持PostgreSQL数据库存储历史数据
• 分析与报表：提供用电量趋势分析、日报/周报/月报统计、峰值用电识别等功能
• Web界面：内置响应式Web管理界面，支持数据可视化、配置管理和用户权限控制
• 扩展性：支持数据导出（CSV/Excel）、API接口对接第三方系统

使用场景

• 家庭用户：监控住宅 electricity/gas 用量，优化能源消耗
• 小型企业：跟踪办公场所能源使用情况，降低运营成本
• 能源管理：配合智能家居系统实现能源自动化控制
• 研究用途：收集历史能源数据用于节能分析或学术研究

使用方法

1. 基础Docker运行命令

bash
docker run -d \
  --name dsmr-reader \
  -p 8000:8000 \  # Web界面端口映射
  -e TZ=Europe/Amsterdam \  # 设置时区
  -e DJANGO_SECRET_KEY=your-secure-key \  # Django应用密钥
  -e DB_ENGINE=django.db.backends.postgresql \  # 数据库引擎
  -e DB_NAME=dsmr \  # 数据库名称
  -e DB_USER=dsmruser \  # 数据库用户
  -e DB_PASSWORD=your-db-password \  # 数据库密码
  -e DB_HOST=db \  # 数据库主机（需单独部署PostgreSQL）
  -e DB_PORT=5432 \  # 数据库端口
  --device=/dev/ttyUSB0:/dev/ttyUSB0 \  # 映射电表串口（若使用串口连接）
  xirixiz/dsmr-reader

2. Docker Compose部署（推荐）

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  dsmr-reader:
    image: xirixiz/dsmr-reader
    container_name: dsmr-reader
    restart: always
    ports:
      - "8000:8000"
    environment:
      - TZ=Europe/Amsterdam
      - DJANGO_SECRET_KEY=your-secure-key-here
      - DB_ENGINE=django.db.backends.postgresql
      - DB_NAME=dsmr
      - DB_USER=dsmruser
      - DB_PASSWORD=secure-db-password
      - DB_HOST=db
      - DB_PORT=5432
      - DSMR_READER_INTERFACE_TYPE=serial  # 接口类型：serial/tcp
      - DSMR_READER_SERIAL_PORT=/dev/ttyUSB0  # 串口路径（仅serial模式）
      - DSMR_READER_SERIAL_BAUDRATE=***  # 串口波特率
    volumes:
      - dsmr_backup:/app/backups  # 数据备份目录
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0  # 映射电表串口
    depends_on:
      - db

  db:
    image: postgres:14-alpine
    container_name: dsmr-db
    restart: always
    environment:
      - POSTGRES_DB=dsmr
      - POSTGRES_USER=dsmruser
      - POSTGRES_PASSWORD=secure-db-password
    volumes:
      - postgres_data:/var/lib/postgresql/data  # 数据库数据持久化

volumes:
  postgres_data:
  dsmr_backup:

启动服务：

bash
docker-compose up -d

访问Web界面：打开浏览器访问 http://<主机IP>:8000，初始用户名/密码为 admin/admin（首次登录需修改）。

配置参数说明

核心环境变量

高级配置

• 数据备份：通过/app/backups卷挂载实现自动备份
• 日志配置：设置LOG_LEVEL（可选：DEBUG/INFO/WARNING/ERROR）控制日志详细程度
• 安全设置：通过SECURE_SSL_REDIRECT=True启用HTTPS（需配合反向代理）

注意事项

• 首次启动需等待数据库初始化完成（约1-2分钟）
• 电表连接需确保串口权限（容器内用户需有权限访问/dev/ttyUSB0）
• 数据库密码和DJANGO_SECRET_KEY需使用高强度随机字符串
• 生产环境建议配合Nginx反向代理实现HTTPS加密和访问控制

更多详细配置请参考项目官方文档：[***]