xirixiz/dsmr-reader-docker

dsmr-reader Docker镜像文档

概述

本镜像为https://github.com/xirixiz/dsmr-reader-docker%E9%A1%B9%E7%9B%AE%E6%8F%90%E4%BE%9B%E5%AE%B9%E5%99%A8%E5%8C%96%E9%83%A8%E7%BD%B2%E6%96%B9%E6%A1%88%EF%BC%8Cdsmr-reader%E6%98%AF%E4%B8%80%E6%AC%BE%E5%BC%80%E6%BA%90%E5%BA%94%E7%94%A8%EF%BC%8C%E7%94%A8%E4%BA%8E%E8%AF%BB%E5%8F%96%E3%80%81%E5%AD%98%E5%82%A8%E5%92%8C%E5%88%86%E6%9E%90%E7%AC%A6%E5%90%88DSMR%EF%BC%88%E6%95%B0%E5%AD%97%E5%BC%8F%E7%94%B5%E8%A1%A8%E9%80%9A%E4%BF%A1%E5%8D%8F%E8%AE%AE%EF%BC%89%E6%A0%87%E5%87%86%E7%9A%84%E6%99%BA%E8%83%BD%E7%94%B5%E8%A1%A8%E6%95%B0%E6%8D%AE%EF%BC%8C%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87Web%E7%95%8C%E9%9D%A2%E8%BF%9B%E8%A1%8C%E6%95%B0%E6%8D%AE%E5%8F%AF%E8%A7%86%E5%8C%96%E5%92%8C%E6%8A%A5%E8%A1%A8%E7%94%9F%E6%88%90%E3%80%82

核心功能与特性

• 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=115200  # 串口波特率
    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加密和访问控制

更多详细配置请参考项目官方文档：https://github.com/xirixiz/dsmr-reader-docker/blob/master/README.md