weewx-docker 🌩🐳

此Docker容器可用于快速部署和运行WeeWX气象站服务器实例。

运行

启动容器最简单的方法是创建一个类似以下内容的docker-compose.yml文件。如果使用串口连接气象站，请确保容器有权限访问该端口。

根据需要修改路径或设备：

yaml
---
name: "weewx"

services:
  weewx:
    image: felddy/weewx:5
    volumes:
      - type: bind
        source: ./data
        target: /data
    devices:
      - "/dev/ttyUSB0:/dev/ttyUSB0"

1. 在主机上创建目录用于存储配置和数据库文件：

   console
   mkdir data
   

2. 如果是首次运行WeeWX，使用以下命令启动容器并生成配置文件：

   console
   docker compose run --rm weewx
   

3. 配置文件将在data目录中创建。您需要编辑此文件以匹配您的气象站设置。

4. 配置满意后，可在后台启动容器：

   console
   docker compose up --detach
   

升级

1. 停止运行中的容器：

   console
   docker compose down
   

2. 从Docker Hub拉取新镜像：

   console
   docker compose pull
   

3. 更新配置文件（会创建备份）：

   console
   docker compose run --rm weewx station upgrade
   

4. 通读新配置并验证。建议使用diff比较新配置与备份的差异。查看WeeWX升级指南获取特定版本的升级说明。

5. 使用新版本镜像启动容器：

   console
   docker compose up --detach
   

迁移

如果迁移现有WeeWX安装，需配置日志器输出到控制台。在weewx.conf文件中添加以下内容，以便在容器日志中查看输出：

ini
[Logging]
    [[root]]
        level = INFO
        handlers = console,

安装WeeWX扩展

向容器传递的参数会转发给weectl命令，可用于安装扩展：

console
docker compose run --rm weewx \
  extension install --yes \
  [***]

console
docker compose run --rm weewx \
  extension install --yes \
  [***]

安装Python包

要安装并持久化Python包，使用pip命令。库将安装到data卷中，确保在容器重启后保留：

console
docker compose run --rm --entrypoint pip weewx \
  install git+[***]

镜像标签

容器镜像使用语义化版本标签，与所支持的WeeWX版本和构建对齐。

[!提示] 建议用户使用主版本标签:5。使用主版本标签可确保获取与保存数据兼容的最新软件版本，避免意外升级到新主版本。

查看标签页获取所有支持的标签列表。

卷

从源码构建

使用此Git仓库作为构建上下文在本地构建镜像：

console
docker build \
  --tag felddy/weewx:5.1.0 \
  [***]

跨平台构建

要创建兼容其他平台的镜像，可使用Docker的buildx功能：

1. 使用上方的“Clone”按钮或命令行将项目复制到本地：

   console
   git clone [***]
   cd weewx-docker
   

2. 使用buildx构建镜像：

   console
   docker buildx build \
     --platform linux/amd64 \
     --output type=docker \
     --tag felddy/weewx:5.1.0 .
   

贡献

欢迎贡献！详情请参见CONTRIBUTING.md。

许可证

本项目在全球范围内属于公共领域。

本项目在美国属于公共领域，并且通过CC0 1.0通用公共领域奉献放弃在全球范围内对本作品的版权及相关权利。

所有对本项目的贡献将以CC0奉献发布。提交拉取请求即表示您同意遵守此版权放弃声明。