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

Cumulus MX 气象站应用 Docker 镜像

概述

Cumulus MX 是气象站软件的跨平台版本，本 Docker 镜像提供了该软件的容器化部署方案。详情可参考 Cumulus 维基。

v4 版本重要变更

自2024年7月9日起，cumulusmx:latest 标签已运行 CumulusMX v4 版本。

cumulusmx:v3 标签将继续提供 v3 版本构建，会定期更新以避免容器过时或遗留安全漏洞。

数据迁移

v4 采用全新数据结构，因此需要迁移现有文件。v4 版本默认会自动从 v3 数据结构迁移至 v4。 可通过添加环境变量 MIGRATE=false（docker-compose）或 -e MIGRATE=false（docker run）禁用迁移。若使用自定义每日日志文件，需通过环境变量传递文件名列表，详见下方迁移详情。

更新至 v4 前请务必备份数据文件，无法保证迁移完全适用于所有场景。

迁移逻辑详见下方，CumulusMX 版本变更详情可参考此处。

使用方法

1. 确保主机已安装并配置 Docker（推荐使用 DockSTARTer 简化 Docker 入门）
2. 克隆 docker-compose.yml 和 .env 文件到本地
3. 修改 .env 文件以适配环境
4. 重要：若不使用 USB 设备直通，需从 docker-compose.yml 中移除 "devices" 部分（见已知问题）
5. 运行 docker compose up 启动容器

首次运行

1. 首次运行时需启动安装向导，通过 http://{服务器地址}:8998/wizard.html 访问
2. 向导完成后，系统会提示重启 Cumulus MX，使用命令 docker restart cumulusmx 重启容器
3. 重启后会生成 Cumulus.ini 文件，容器关闭时该文件会复制到 ./config 文件夹；容器重启时，会从 /opt/CumulusMX/config 复制回 /opt/CumulusMX 目录

注意：配置变更仅在容器收到 SIGTERM 信号时才会提交到 INI 文件。容器内配置文件在容器重建或更新前保持持久化。

已知问题

• 若使用 docker-compose 文件且 /dev/hidraw0 设备不存在，容器将启动失败。

容器构建

每日检查上游 Cumulus MX 仓库是否有新版本，发现更新时会自动触发构建流程，并推送新镜像至 Docker Hub 和 GHCR。可使用 v3 或 v4 标签获取对应版本的最新构建。

数据迁移

v4 采用新数据结构，容器默认自动迁移（除非禁用）。

• 禁用迁移：添加环境变量 MIGRATE=false（docker-compose）或 -e MIGRATE=false（docker run）
• 强制迁移：设置 MIGRATE=force，适用于首次迁移失败的场景
• 自定义日志文件：通过环境变量 MIGRATE_CUSTOM_LOG_FILES="File1 File2 File3" 传递文件名（注意：未测试，可能存在问题）

迁移逻辑

预检查

以下任一条件失败，迁移将中止：

1. 迁移已被禁用
2. 数据目录文件数超过1个（若跳过迁移，会创建 /opt/CumulusMX/config/.nodata 文件标记，避免下次启动重复尝试）
3. 已存在迁移记录

设置 MIGRATE=force 可忽略预检查强制运行迁移。

迁移步骤

1. 将 Cumulus.ini 备份至 /opt/CumulusMX/config/Cumulus-v3.ini.bak
2. 将数据目录备份至 /opt/CumulusMX/backup/datav3
3. 复制数据目录至 /opt/CumulusMX/datav3
4. 执行迁移流程
5. 迁移完成后创建 /opt/CumulusMX/config/.migrated 文件标记
6. 正常启动 CumulusMX

恢复方法

迁移设计为可恢复，但不提供保证。恢复所需文件位置：

1. Cumulus.ini 备份：/opt/CumulusMX/config/Cumulus-v3.ini.bak
2. v3 数据文件：/opt/CumulusMX/backups/datav3

恢复操作：将 /config/Cumulus-v3.ini.bak 替换为 /config/Cumulus.ini，并将 /backup/datav3/ 复制到 /data/。

鸣谢

感谢 @optoisolated 为 Cumulus MX 容器化所做的初步工作。