weewx Docker镜像文档

镜像概述和主要用途

本Docker镜像用于运行weewx气象软件，集成Belchertown、mqtt和WeatherLinkLive扩展，实现气象站数据的采集、处理、存储（如SQLite数据库）及网页展示。通过Docker简化部署流程，支持自定义配置、数据持久化及与Web服务器协同展示气象数据。

核心功能和特性

• 支持weewx核心功能：气象数据采集、处理、存储与报表生成
• 集成扩展：Belchertown（网页界面）、mqtt（数据传输）、WeatherLinkLive（气象站支持）
• 灵活的卷挂载：支持挂载配置文件（weewx.conf）、生成的HTML文件（public_html）、扩展插件、用户脚本及数据存档
• 自定义配置：通过卷或子镜像实现个性化配置，支持多环境部署
• 数据持久化：关键数据（如数据库）可通过卷挂载实现主机存储，避免容器重启丢失数据

使用场景和适用范围

适用于个人气象站、小型气象监测系统部署，尤其适合：

• 希望通过Docker简化weewx安装配置的用户
• 需要将气象数据网页通过外部Web服务器（如Apache、Nginx）展示的场景
• 需自定义扩展插件、用户脚本或多环境配置的场景
• 采用容器编排工具（如docker-compose、Kubernetes）管理服务的环境

详细使用方法和配置说明

基本用法

挂载配置文件

将本地weewx.conf挂载到容器，基础命令如下：

bash
docker run -d --volume /Users/tom/weewx.conf:/home/weewx/weewx.conf mitct02/weewx:5.1.0-6

说明：生成的HTML文件默认存储在容器内，需通过weewx.conf配置rsync等工具导出，或挂载外部目录（见下文）。

与Web服务器配合展示HTML

挂载本地目录作为容器public_html，实现Web服务器直接访问生成的气象网页：

bash
docker run -d \
  --volume /Users/tom/weewx.conf:/home/weewx/weewx-data/weewx.conf \
  --volume /var/www/html/weewx/public_html/:/home/weewx/public_html/ \
  mitct02/weewx:5.1.0-6

之后可启动Web服务器（如Nginx），将/var/www/html/weewx/public_html/设为网页根目录。

完整挂载示例

挂载扩展、用户脚本、配置、HTML输出及数据存档的综合示例：

bash
docker run -it --rm \
  --volume /Users/tom/extensions:/home/weewx/extensions \    # 扩展插件
  --volume /Users/tom/weewx.conf:/home/weewx/weewx.conf \    # 配置文件
  --volume /tmp/public_html:/home/weewx/public_html \        # HTML输出
  --volume /Users/tom/bin/user:/home/weewx/bin/user \        # 用户脚本
  --volume /Users/tom/archive:/home/weewx/archive \          # 数据存档（含数据库）
  mitct02/weewx:5.1.0-6

参数说明：-it（交互模式）、--rm（容器退出后自动删除）适合测试；生产环境建议使用-d（后台运行）和--restart=always（自动重启）。

构建子镜像

如需自定义插件或多环境部署，可基于本镜像构建子镜像：

构建步骤

1. 创建Dockerfile，指定基础镜像版本：

   dockerfile
   FROM mitct02/weewx:5.1.0-6  # 替换为所需版本
   

2. 准备配置和密钥：

   • 在工作目录创建conf目录，存放多环境配置（如conf/default对应默认配置）
   • 创建keys目录（可空），存放rsync用SSH公钥，内容会复制到容器/root/.ssh/（支持跨主机同步网页内容）

3. 构建子镜像：

   bash
   docker build -t my-weewx
   

运行子镜像示例

配合Web服务器容器（如httpd）展示网页：

bash
# 启动Web服务器（挂载主机目录作为网页根）
docker run -d --name=weewx-webserver --restart=always -p 80:80 -v /tmp/httpdroot:/usr/local/apache2/htdocs httpd

# 启动weewx子镜像（挂载Web服务器目录，指定配置环境）
docker run -d --name=weewx-default --restart=always -e CONF=default -v /tmp/httpdroot:/home/weewx/public_html my-weewx

Docker Compose示例

以下配置适用于docker-compose部署，替换/mnt/docker/weewx为实际存储路径：

yaml
version: '2.3'
services:
  weewx:
    image: mitct02/weewx
    container_name: weewx
    volumes:
      - /mnt/docker/weewx/weewx.sbd:/home/weewx/weewx.sbd
      - /mnt/docker/weewx/public_html:/home/weewx/public_html
      - /mnt/docker/weewx/weewx.conf:/home/weewx/weewx.conf
#      - /mnt/docker/weewx/gw1000.py:/home/weewx/bin/user/gw1000.py  # 可选：挂载gw1000驱动
    networks:
      - internal
    restart: unless-stopped

环境变量配置

• 时区设置：默认时区为America/New_York，可通过TZ环境变量自定义（需符合区域/城市格式），示例：

  bash
  docker run -d -e TZ=Asia/Shanghai --volume /path/to/weewx.conf:/home/weewx/weewx.conf mitct02/weewx:5.1.0-6