gf78/smartmetervienna

gf78

自动将维也纳Wiener Netze智能电表的测量数据保存到InfluxDB数据库，支持定时任务、手动导入、API访问及Web UI管理。

下载次数: 0状态：社区镜像维护者：gf78仓库类型：镜像最近更新：2 年前

让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

镜像标签列表与下载命令

SmartMeter Vienna

Github: https://github.com/gf78/smartmetervienna/
Docker Hub: https://hub.docker.com/r/gf78/smartmetervienna

功能特性

支持维也纳Wiener Netze使用的智能电表
获取单日或日期范围（最长3年）的电力消耗和平均负载数据
将数据存储到InfluxDB（V2版本）
通过Web界面手动导入单日或日期范围的测量数据
运行每日定时任务以存储前几天的数据
通过Rest API检索测量数据
可选的API-KEY授权机制
Swagger：API定义和交互式Web界面
通过Web界面查看服务配置和日志
接收定时任务结果的邮件通知
定时任务运行时触发Webhook请求
包含Grafana仪表板JSON模型
完善的日志服务
基于Alpine Linux镜像的Docker化部署

截图展示

Grafana仪表板

!https://raw.githubusercontent.com/gf78/smartmetervienna/main/docs/images/grafana_dashboard.png

Rest API的Swagger UI

!https://raw.githubusercontent.com/gf78/smartmetervienna/main/docs/images/swagger_overview.png

!https://raw.githubusercontent.com/gf78/smartmetervienna/main/docs/images/swagger_consumption.png

Web界面

!https://raw.githubusercontent.com/gf78/smartmetervienna/main/docs/images/web_login.png

!https://raw.githubusercontent.com/gf78/smartmetervienna/main/docs/images/web_home.png

!https://raw.githubusercontent.com/gf78/smartmetervienna/main/docs/images/web_import.png

!https://raw.githubusercontent.com/gf78/smartmetervienna/main/docs/images/web_log.png

!https://raw.githubusercontent.com/gf78/smartmetervienna/main/docs/images/web_config.png

!https://raw.githubusercontent.com/gf78/smartmetervienna/main/docs/images/web_info.png

前提条件

Wiener Netze的客户
已安装智能电表
在[***]
选择15分钟间隔测量选项

安装部署

编辑docker-compose.yml文件并创建Docker容器：

yaml
version: "3.3"
services:
  smartmetervienna:
    container_name: smartmetervienna
    image: "docker.xuanyuan.run/gf78/smartmetervienna:latest"
    restart: unless-stopped
    ports:
      - "80:1978"  # 主机端口:容器端口
    environment:
      PORT: 1978  # Web UI端口
      API_KEY: "xxx"  # 用于保护Web UI和Rest API的密钥
      LOG_LEVEL: "error"  # 日志级别：error、info、verbose
      CRON_SCHEDULE: "0 12 * * *"  # 定时任务调度时间
      CRON_DAYS_IN_PAST: "7"  # 要导入的过去天数
      LOGWIEN_USERNAME: "xxx"  # Wiener Netze智能电表门户用户名
      LOGWIEN_PASSWORD: "xxx"  # Wiener Netze智能电表门户密码
      INLUXDB_URL: "http://xxx:8086"  # InfluxDB地址
      INLUXDB_ORGANISATION: "xxx"  # InfluxDB组织
      INLUXDB_BUCKET: "smartmetervienna"  # InfluxDB存储桶（默认值）
      INLUXDB_MEASUREMENT: "Consumption_15min_Wh"  # InfluxDB测量名称（默认值）
      INLUXDB_TOKEN: "xxx"  # InfluxDB令牌
      SMTP_HOST: "xxx"  # SMTP服务器主机
      SMTP_PORT: 587  # SMTP服务器端口
      SMTP_SECURE: false  # SMTP安全连接设置
      SMTP_CIPHERS: "SSLv3"  # SMTP加密套件
      SMTP_USERNAME: "xxx"  # SMTP服务器用户名
      SMTP_PASSWORD: "xxx"  # SMTP服务器密码
      SMTP_FROM: "xxx"  # 发件人邮箱地址
      SMTP_TO: "xxx"  # 收件人邮箱地址
      MAIL_ENABLED: false  # 是否启用邮件通知
      MAIL_SUBJECT: "SmartMeter Vienna"  # 邮件主题
      MAIL_ON_SUCCESS: true  # 成功时发送通知
      MAIL_ON_FAILURE: true  # 失败时发送通知
      MAIL_ON_RESTART: true  # 重启时发送通知
      WEBHOOK_ENABLED: false  # 是否启用Webhook通知
      WEBHOOK_METHOD: POST  # Webhook请求方法
      WEBHOOK_URL_RESTART: "http(s)://xxx"  # 重启时的Webhook URL
      WEBHOOK_URL_SUCCESS: "http(s)://xxx"  # 成功时的Webhook URL
      WEBHOOK_URL_FAILURE: "http(s)://xxx"  # 失败时的Webhook URL
    volumes:
      - "smartmetervienna-logs:/logs"  # 日志存储卷
volumes:
  smartmetervienna-logs:
    external: true
    name: smartmetervienna-logs  # 外部日志卷名称

配置说明

通过以下环境变量配置服务：

变量名	描述	是否必填
PORT	Web UI端口，默认值：`1978`	否
API_KEY	用于保护Web UI和Rest API的密钥	否
LOG_LEVEL	日志级别，可选值：`error`、`info`、`verbose`	否
CRON_SCHEDULE	定时任务调度时间，例如：`0 10,16 * * *`（每天10点和16点执行）	否
CRON_DAYS_IN_PAST	需要导入的过去天数	否
LOGWIEN_USERNAME	Wiener Netze智能电表门户的用户名	是
LOGWIEN_PASSWORD	Wiener Netze智能电表门户的密码	是
METER_ID	Wiener Netze的电表ID（Zählerpunkt）	否
INLUXDB_URL	InfluxDB地址，例如：`http://xxx:8086`	否
INLUXDB_TOKEN	InfluxDB访问令牌	否
INLUXDB_ORGANISATION	InfluxDB组织名称	否
INLUXDB_BUCKET	InfluxDB存储桶名称，默认值：`smartmetervienna`	否
INLUXDB_MEASUREMENT	InfluxDB测量名称，默认值：`Consumption_15min_Wh`	否
SMTP_HOST	SMTP服务器主机	否
SMTP_PORT	SMTP服务器端口，默认值：`587`	否
SMTP_SECURE	SMTP安全连接设置，可选值：`true`、`false`	否
SMTP_CIPHERS	SMTP加密套件，例如：`SSLv3`	否
SMTP_USERNAME	SMTP服务器用户名	否
SMTP_PASSWORD	SMTP服务器密码	否
SMTP_FROM	发件人***地址	否
MAIL_ENABLED	是否启用邮件通知，可选值：`true`、`false`	否
MAIL_TO	收件人***地址	否
MAIL_SUBJECT	邮件主题	否
MAIL_ON_SUCCESS	成功时发送通知，可选值：`true`、`false`	否
MAIL_ON_FAILURE	失败时发送通知，可选值：`true`、`false`	否
MAIL_ON_RESTART	重启时发送通知，可选值：`true`、`false`	否
WEBHOOK_ENABLED	是否启用Webhook通知，可选值：`true`、`false`	否
WEBHOOK_METHOD	Webhook请求方法，可选值：`POST`、`GET`	否
WEBHOOK_URL_RESTART	重启时的Webhook URL	否
WEBHOOK_URL_SUCCESS	成功时的Webhook URL，支持占位符：`%%FROM%%`、`%%TO%%`、`%%DAYS%%`、`%%COUNT%%`、`%%RATE%%`、`%%SUCCESS%%`	否
WEBHOOK_URL_FAILURE	失败时的Webhook URL，支持占位符：`%%FROM%%`、`%%TO%%`、`%%DAYS%%`、`%%COUNT%%`、`%%RATE%%`、`%%SUCCESS%%`	否

定时任务

设置CRON_SCHEDULE环境变量（例如"0 10,16 * * *"），可配置定时任务在每天10点和16点请求过去几天的测量数据并存储到数据库。启用通知后，将在任务成功/失败时收到邮件和/或Webhook通知。建议将CRON_DAYS_IN_PAST设置为大于1的值，以便导入Wiener Netze可能未及时提供的历史数据。

调度格式参考：[***]

Rest API

详细信息请参见Swagger文档。

安全设置

设置API_KEY环境变量可激活Rest API和Web UI的授权机制。ApiKey可通过请求头、查询参数或Cookie提供。

电表数据

智能电表门户原始响应：/api/v1/meter/raw?from=YYYY-MM-DD&to=YYYY-MM-DD
用于数据库存储的基础测量数据：/api/v1/meter/measurements?from=YYYY-MM-DD&to=YYYY-MM-DD
增强的消耗测量数据：/api/v1/meter/consumption?from=YYYY-MM-DD&to=YYYY-MM-DD
增强的负载测量数据：/api/v1/meter/load?from=YYYY-MM-DD&to=YYYY-MM-DD

响应示例：

json
[
  {
    "measurement": "Consumption",
    "unit": "Wh",
    "value": 97,
    "timestamp": "2023-03-31T22:00:00.000Z",
    "start": "2023-03-31T22:00:00.000Z",
    "end": "2023-03-31T22:14:59.999Z",
    "text": "97Wh"
  },
  {}
]

日志信息

获取当天日志：/api/v1/log

响应示例：

json
[
  {
    "level": "info",
    "message": "[WEB] Listening on port 1978",
    "timestamp": "2023-04-27T06:45:46.806Z"
  },
  {}
]

Web界面

访问状态页面：//你的服务器IP:端口/

首页：查看当前版本及是否有更新
导入：手动触发测量数据导入数据库
日志：查看日志条目
配置：查看当前配置信息
信息：获取更多信息和链接

通知功能

邮件通知

配置SMTP/邮件服务，可在服务重启、定时任务成功或失败时接收邮件通知。

Webhook通知

配置Webhook服务，可在服务重启、定时任务成功或失败时接收GET或POST请求。POST请求的 payload 将包含检索到的测量数据。

URL中可使用以下占位符：%%FROM%%、%%TO%%、%%DAYS%%、%%COUNT%%、%%RATE%%和%%SUCCESS%%

Grafana集成

可使用包含的https://raw.githubusercontent.com/gf78/smartmetervienna/main/grafana/dashboard.json%E3%80%82

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 smartmetervienna 镜像标签

docker pull docker.xuanyuan.run/gf78/smartmetervienna:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull gf78/smartmetervienna:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Apple Container

macOS 原生容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

Unraid

Unraid NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

gf78/smartmetervienna

自动将维也纳Wiener Netze智能电表的测量数据保存到InfluxDB数据库，支持定时任务、手动导入、API访问及Web UI管理。

SmartMeter Vienna

目录

功能特性

截图展示

Grafana仪表板

Rest API的Swagger UI

Web界面

前提条件

安装部署

配置说明

定时任务

Rest API

安全设置

电表数据

日志信息

Web界面

通知功能

邮件通知

Webhook通知

Grafana集成

镜像拉取方式

轩辕镜像加速拉取命令点我查看更多 smartmetervienna 镜像标签

DockerHub 原生拉取命令

轩辕镜像配置手册

Docker

登录仓库拉取

专属域名拉取

Linux

Windows / Mac

MacOS OrbStack

Apple Container

Docker Compose

NAS

群晖

飞牛

绿联

威联通

极空间

Unraid

企业仓库

其他仓库

Harbor 镜像源

Portainer 镜像源

Nexus 镜像源

开发工具

Dev Containers

Podman

Singularity / Apptainer

Kubernetes

K8s Containerd

K3s

面板 / 网络

爱快路由

宝塔面板

AI

用 AI 使用轩辕镜像

一键安装

一键安装 Docker

镜像拉取常见问题

功能

版本功能对比

支持的镜像仓库

新手拉取配置

docker search 限制

不支持 push

拉取速度原因

错误码

402 与流量用尽

401 认证失败

manifest unknown

410 Gone 排查

429 限流

其他报错

DNS 超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费