texastribune/thermometer

thermometer 镜像文档

镜像概述

thermometer是一个轻量级Docker镜像，专为温度监控与数据管理设计。该镜像集成温度采集、数据存储、告警通知及报告生成功能，可快速部署于各类环境，实现对目标区域温度的实时监控与管理。

核心功能与特性

• 实时温度采集：支持对接多种温度传感器（如DS18B20、DHT22等），实时获取环境温度数据
• 数据存储：内置轻量级数据库，支持本地文件存储（CSV/JSON）或远程数据库对接（MySQL/InfluxDB）
• 阈值告警：可配置高温/低温阈值，触发时通过日志、HTTP回调或邮件发送告警通知
• 报告生成：支持定时生成温度趋势报告，提供日/周/月数据统计与可视化图表
• 跨平台兼容：基于Alpine Linux构建，镜像体积小，支持x86/ARM架构

使用场景

• 实验室环境：精密实验环境的温度稳定性监控
• 服务器机房：IT设备运行环境温度实时监测，预防过热故障
• 智能家居：家庭环境温度集中监控与空调联动控制
• 工业生产：生产线关键节点温度监控，保障生产工艺稳定性

使用方法与配置说明

基本部署

通过以下命令快速启动容器（默认配置）：

bash
docker run -d --name thermometer \
  -v ./data:/app/data \  # 挂载数据存储目录
  --device /dev/ttyUSB0:/dev/ttyUSB0 \  # 如使用USB传感器需映射设备
  thermometer:latest

环境变量配置

通过环境变量自定义镜像行为，常用参数如下：

示例（配置高温告警阈值为40℃，采集间隔30秒）：

bash
docker run -d --name thermometer \
  -v ./data:/app/data \
  -e ALERT_HIGH=40 \
  -e COLLECT_INTERVAL=30 \
  thermometer:latest

docker-compose配置示例

yaml
version: '3'
services:
  thermometer:
    image: thermometer:latest
    container_name: thermometer
    volumes:
      - ./thermometer_data:/app/data
    environment:
      - TEMPERATURE_UNIT=C
      - COLLECT_INTERVAL=30
      - ALERT_HIGH=38
      - ALERT_LOW=5
      - STORAGE_TYPE=local
    restart: unless-stopped
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0  # 根据实际传感器设备调整

数据访问与报告

• 本地存储数据位于挂载目录下的temperature_log.csv文件
• 访问容器内Web界面（默认端口8080）查看实时温度与历史趋势：http://<容器IP>:8080
• 报告文件默认生成于/app/reports目录，支持通过REPORT_FORMAT环境变量指定格式（csv/json/pdf）

注意事项

• 使用外部传感器时需确保容器有权限访问对应设备（通过--device参数或设备权限配置）
• 远程数据库连接需提前创建对应数据库与表结构（可参考镜像内/app/schema.sql文件）
• 高频率采集（<10秒间隔）建议使用性能较高的主机或调整资源限制

注：具体功能与配置可能因镜像版本不同存在差异，建议结合官方最新文档使用。