jgoerzen/weewx

WeeWX Docker镜像文档

镜像概述和主要用途

WeeWX Docker镜像是容器化的开源气象站软件部署方案。WeeWX作为专业气象数据处理工具，支持从各类气象站设备采集环境数据（温度、湿度、气压等），进行数据处理、存储及可视化报告生成。该镜像通过容器化技术简化部署流程，避免系统依赖冲突，适用于个人气象站、小型监测项目等场景，提供一致且隔离的运行环境。

核心功能和特性

• 多设备兼容：支持Davis Vantage、Oregon Scientific、Fine Offset等主流气象站设备
• 数据全流程处理：包含数据采集、质量控制、单位转换、聚合分析等功能
• 可视化报告：自动生成HTML格式气象报告，包含实时数据与历史趋势图表
• 灵活存储方案：支持文件系统、MySQL、PostgreSQL等多种数据存储方式
• 扩展能力：通过插件系统支持第三方服务集成（如Weather Underground、CWOP）
• 容器化优势：简化部署、跨平台运行、版本管理便捷，支持快速升级与回滚

使用场景和适用范围

• 个人气象站用户：无需复杂配置，快速搭建个人气象数据监控系统
• 小型监测项目：适用于学校、社区或企业的简易气象环境监测需求
• 教育科研领域：气象数据采集与分析的教学实验或科研项目
• 自动化部署环境：可集成至Docker Compose、Kubernetes等容器编排平台实现自动化运维

详细使用方法和配置说明

前提条件

• Docker Engine 20.10+
• 气象站设备已连接至主机（USB/串口/网络方式）

基本部署（docker run）

1. 生成初始配置文件

首次使用需导出默认配置文件至本地目录：

bash
docker run -it --rm \
  -v $(pwd)/weewx-config:/etc/weewx \
  salsa.debian.org/jgoerzen/docker-weewx \
  /bin/bash -c "cp -r /etc/weewx.orig/* /etc/weewx/"

2. 启动容器

修改配置后启动服务（需根据实际设备调整参数）：

bash
docker run -d \
  --name weewx \
  --restart unless-stopped \
  -v $(pwd)/weewx-config:/etc/weewx \  # 配置文件持久化
  -v $(pwd)/weewx-data:/var/lib/weewx \  # 数据与报告存储
  --device=/dev/ttyUSB0:/dev/ttyUSB0 \  # 气象站设备映射（根据实际调整）
  salsa.debian.org/jgoerzen/docker-weewx

Docker Compose配置示例

创建docker-compose.yml实现更便捷的管理：

yaml
version: '3'
services:
  weewx:
    image: salsa.debian.org/jgoerzen/docker-weewx
    container_name: weewx
    restart: unless-stopped
    volumes:
      - ./weewx-config:/etc/weewx
      - ./weewx-data:/var/lib/weewx
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0  # 气象站USB设备映射
    ports:
      - "8080:80"  # 映射报告访问端口（通过http://localhost:8080访问）

启动服务：

bash
docker-compose up -d

核心配置说明

主要配置文件路径：weewx-config/weewx.conf，关键配置项包括：

• [Station]：气象站基本信息（名称、位置坐标、海拔）
• [WXStation]：设备类型与连接参数（设备路径、通信协议）
• [Database]：存储配置（类型、连接信息或文件路径）
• [Report]：报告输出设置（路径、模板选择、更新频率）

配置修改后需重启容器生效：

bash
docker restart weewx  # 直接运行时
# 或 docker-compose restart  # Compose管理时

运维操作指南

查看运行状态与日志

bash
# 查看容器状态
docker ps | grep weewx

# 查看实时日志
docker logs -f weewx

访问气象报告

• 本地文件访问：报告存储于weewx-data/html目录
• 浏览器访问：通过配置的端口映射（如示例中的http://localhost:8080）

镜像升级流程

1. 拉取最新镜像：

bash
docker pull salsa.debian.org/jgoerzen/docker-weewx

2. 重启服务（配置与数据通过卷持久化，不会丢失）：

bash
docker-compose down && docker-compose up -d  # Compose管理时

注意事项

• 设备映射需根据实际连接方式调整（USB/串口/网络）
• 首次部署需确保气象站设备已正确连接并被主机识别
• 配置文件修改建议先备份，避免格式错误导致服务异常
• 数据卷需定期备份，防止数据丢失