dbsqp/netatmo-influxdbv2

netatmo-influxdbv2

镜像概述

netatmo-influxdbv2是一个用于从Netatmo API获取数据并存储到InfluxDBv2的工具镜像。该镜像基于turbosnute的https://github.com/turbosnute/netatmo-influxdb%E3%80%81Manabuishii%E7%9A%84https://github.com/manabuishii/docker-netatmo-influxdb-python%E4%BB%A5%E5%8F%8Apypi%E4%B8%8A%E7%9A%84netatmo2influxdb.py%E9%A1%B9%E7%9B%AE%E5%BC%80%E5%8F%91%EF%BC%8C%E5%B7%B2%E6%9B%B4%E6%96%B0%E9%80%82%E9%85%8DInfluxDBv2%EF%BC%8C%E5%B9%B6%E6%96%B0%E5%A2%9E%E4%BA%86%E4%BF%A1%E5%8F%B7%E5%BC%BA%E5%BA%A6%E5%92%8C%E7%94%B5%E6%B1%A0%E7%99%BE%E5%88%86%E6%AF%94%E6%95%B0%E6%8D%AE%E7%9A%84%E4%B8%8A%E4%BC%A0%E5%8A%9F%E8%83%BD%E3%80%82

核心功能与特性

• 从Netatmo API获取环境监测数据
• 支持将数据推送到InfluxDBv2存储桶
• 新增信号强度和电池百分比数据采集
• 适配lnetatmo oauth认证机制
• 支持调试模式，输出详细日志信息

使用场景

适用于需要将Netatmo智能设备（如气象站）的监测数据持久化存储到InfluxDBv2，以便进行数据分析、可视化或长期趋势跟踪的场景。

前置准备

Netatmo API Token 获取

1. 访问：[***]
2. 使用Netatmo账号登录
3. 进入"My Apps"页面
4. 点击"Create"创建新应用
5. 填写应用信息（如名称、描述等）
6. 点击"Save"保存应用
7. 获取生成的"client id"和"client secret"
8. 生成具有"read_station"权限范围的访问令牌（token）
9. 记录刷新令牌（refresh token）

InfluxDBv2 配置

1. 部署并配置InfluxDBv2服务
2. 创建用于存储Netatmo数据的存储桶（bucket）
3. 创建具有该存储桶写入权限的访问令牌（token）

使用方法

Docker 运行命令

bash
docker run -d \
  -e NETATMO_CLIENT_ID="<NETATMO客户端ID>" \
  -e NETATMO_CLIENT_SECRET="<NETATMO客户端密钥>" \
  -e NETATMO_TOKEN="<NETATMO访问令牌>" \
  -e INFLUXDB2_HOST="<InfluxDBv2服务器地址>" \
  -e INFLUXDB2_PORT="8086" \
  -e INFLUXDB2_ORG="Home" \
  -e INFLUXDB2_TOKEN="<InfluxDBv2访问令牌>" \
  -e INFLUXDB2_BUCKET="Staging" \
  --name "Netatmo-InfluxDBv2" \
  dbsqp/netatmo-influxdbv2:latest

环境变量说明

调试模式

如需获取详细日志以排查问题，可添加调试环境变量：

bash
-e DEBUG="true"

状态更新

已更新适配lnetatmo oauth认证机制。