jheddings/wxdat

Weather Data Recorder 镜像文档

镜像概述

Weather Data Recorder 镜像是一个轻量级工具，旨在帮助用户便捷地收集、存储和管理天气数据。该镜像集成了数据采集、格式转换和基础分析功能，无需复杂配置即可快速部署，适用于个人、开发者及小型项目的气象数据记录需求。

核心功能与特性

• 多数据源支持：兼容主流天气API（如OpenWeatherMap、WeatherAPI）及本地传感器数据输入
• 灵活数据存储：支持CSV、JSON文件存储及SQLite数据库，可通过挂载卷自定义存储路径
• 定时数据采集：内置任务调度功能，支持自定义采集频率（如每小时、每天）
• 数据格式转换：自动将原始数据转换为标准化格式，便于后续分析和可视化
• 轻量级部署：基于Alpine Linux构建，镜像体积小，资源占用低

使用场景与适用范围

• 个人天气记录：记录日常温度、湿度、气压等数据，生成个人天气日志
• 小型气象站：配合硬件传感器，实现小型气象站的自动化数据管理
• 开发测试：为依赖天气数据的应用提供模拟数据或测试环境
• 教育项目：用于气象相关课程或学生项目的数据收集实践

使用方法与配置说明

基本部署

通过以下命令快速启动容器：

bash
docker run -d \
  --name weather-recorder \
  -v /path/to/local/storage:/app/data \  # 挂载本地目录存储数据
  -e DATA_SOURCE="openweathermap" \      # 指定数据源（如openweathermap、sensor、custom）
  -e API_KEY="your_api_key" \            # 若使用API数据源，需提供对应API密钥
  -e COLLECT_INTERVAL="3600" \           # 采集间隔（秒），默认3600秒（1小时）
  weather-data-recorder:latest

环境变量配置

数据存储与访问

容器默认将数据存储在/app/data目录下，建议通过-v参数挂载本地目录以持久化数据。例如：

bash
docker run -d \
  --name weather-recorder \
  -v $(pwd)/weather-data:/app/data \  # 将当前目录下的weather-data文件夹挂载为数据存储目录
  -e DATA_SOURCE="sensor" \
  -e COLLECT_INTERVAL="1800" \       # 每30分钟采集一次
  weather-data-recorder:latest

注意事项

• 使用API数据源时，需确保API密钥有效且网络连接正常
• 本地传感器数据源需通过设备挂载（如--device=/dev/ttyUSB0:/dev/ttyUSB0）与容器通信
• 数据存储目录需设置适当权限，避免容器写入失败