instantlinux/weewx Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

weewx

镜像概述和主要用途

WeeWX气象站软件的多架构Docker镜像。支持AMD、ARM、Intel、树莓派等多种平台（详见上方平台支持徽章）。包含WeeGreen皮肤，可查看示例网站了解效果。该镜像用于气象站数据的采集、处理、存储及网页展示，适用于个人或小型气象站的数据管理需求。

核心功能和特性

• 多架构支持：兼容amd64、arm64、arm/v6、arm/v7等多种硬件平台
• 数据处理：支持气象站数据采集、存储及统计分析
• 网页展示：内置多种皮肤（Seasons、Standard、WeeGreen），可生成气象数据网页
• 数据库集成：支持MySQL等数据库存储气象数据
• 灵活配置：通过环境变量和secrets实现参数自定义
• 数据同步：支持通过rsync同步生成的网页文件到外部Web服务器

使用场景和适用范围

适用于个人气象站、小型气象监测点，用于采集温湿度、气压、雨量、风速风向等气象数据，并通过网页界面展示历史和实时数据。支持集成AirLink AQI传感器等配件，可扩展监测空气质量等参数。

使用方法和配置说明

前期准备

1. 创建所需secrets，存储在/var/adm/admin/secrets目录下（详见下方Secrets说明）
2. 确保气象站设备（通常为/dev/ttyUSB0）可被用户"weewx"（uid 2071）或组"dialout"（gid 20）读写，可通过udev规则配置

部署方式

推荐使用docker-compose部署，示例配置见docker-compose.yml。也可通过Kubernetes部署，相关资源定义见wx-nginx.yaml。

如需部署外部访问的网站，可使用提供的nginx.conf配置Nginx服务，或通过Kubernetes部署对应资源。

环境变量

如需使用未包含的皮肤，可将皮肤目录挂载到/home/weewx/skins的子目录。

Secrets

升级说明

升级到4.x版本

4.x版本支持名为wview_extended的可选新数据库模式。官方WeeWX升级指南未提及数据迁移方法，以下是从3.x迁移的简要步骤（以获取AQI等新功能）：

1. 备份当前数据库
2. 创建空白数据库weewx_a_new并授予相同访问权限
3. 启动4.x版本的Docker容器，执行~weewx/bin/wee_database --reconfigure
4. 操作完成后（可能需要数分钟至数小时，取决于数据量），停止weewx运行
5. 将数据库weewx_a替换为weewx_a_new的内容（对于mariadb/mysql，需通过dump/import操作）
6. 确保数据库中仅存在archive表：reconfigure仅生成此表，若存在50+个每日摘要表可能触发ViolatedPrecondition异常
7. 重启weewx，等待其自动重建每日摘要表（可通过SELECT COUNT(*) FROM archive_day_outTemp;跟踪进度）

新数据库模式包含近两倍的列，未来备份将需要近两倍的存储空间。

注意事项

• 该镜像可在Kubernetes中运行，但不支持Swarm，因为需要挂载气象站设备
• Kubernetes可能比docker-compose更安全，因为docker-compose要求secrets以明文文件存储，且容器需以特权模式运行以访问气象站设备
• 包含示例docker-compose.yml、helm chart和kubernetes.yaml，可参考k8s目录下的Makefile通过Kubernetes启动
• 预报功能已不再支持：IBM在2018年9月收购Weather Underground后停用了相关API，且weewx-forecast模块未更新至支持Python3
• 美国地区的潮汐信息可通过xtide库生成，但Alpine Linux无二进制包，需从源码构建，2018年因预报UI失效后不再支持
• WeeWX日志输出较为混乱：前台运行时stdout会有大量冗余信息，实际日志发送至syslog，无法配置至stdout以符合Docker日志标准。可通过SYSLOG_DEST环境变量将日志（通过镜像中包含的rsyslogd进程）发送至中央syslog服务

贡献

如需改进此镜像，详见CONTRIBUTING。