热门搜索:
hucknz/cumulusmx
hucknz
Cumulus MX气象站软件的Docker容器，支持跨平台部署，用于气象数据收集与管理，提供v3和v4版本标签，包含自动数据迁移功能，配置持久化存储，支持自定义日志文件迁移。
下载次数: 0状态：社区镜像维护者：hucknz仓库类型：镜像最近更新：19 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
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 版本变更详情可参考此处。
使用方法
- 确保主机已安装并配置 Docker（推荐使用 DockSTARTer 简化 Docker 入门）
- 克隆 docker-compose.yml 和 .env 文件到本地
- 修改 .env 文件以适配环境
- 重要：若不使用 USB 设备直通，需从 docker-compose.yml 中移除 "devices" 部分（见已知问题）
- 运行
docker compose up启动容器
首次运行
- 首次运行时需启动安装向导，通过
http://{服务器地址}:8998/wizard.html访问 - 向导完成后，系统会提示重启 Cumulus MX，使用命令
docker restart cumulusmx重启容器 - 重启后会生成
Cumulus.ini文件，容器关闭时该文件会复制到./config文件夹；容器重启时，会从/opt/CumulusMX/config复制回/opt/CumulusMX目录
注意：配置变更仅在容器收到 SIGTERM 信号时才会提交到 INI 文件。容器内配置文件在容器重建或更新前保持持久化。
已知问题
- 若使用 docker-compose 文件且
/dev/hidraw0设备不存在，容器将启动失败。
容器构建
每日检查上游 Cumulus MX 仓库是否有新版本，发现更新时会自动触发构建流程，并推送新镜像至 https://hub.docker.com/r/hucknz/cumulusmx 和 GHCR。可使用 v3 或 v4 标签获取对应版本的最新构建。
数据迁移
v4 采用新数据结构，容器默认自动迁移（除非禁用）。
- 禁用迁移：添加环境变量
MIGRATE=false（docker-compose）或-e MIGRATE=false（docker run） - 强制迁移：设置
MIGRATE=force，适用于首次迁移失败的场景 - 自定义日志文件：通过环境变量
MIGRATE_CUSTOM_LOG_FILES="File1 File2 File3"传递文件名（注意：未测试，可能存在问题）
迁移逻辑
预检查
以下任一条件失败，迁移将中止：
- 迁移已被禁用
- 数据目录文件数超过1个（若跳过迁移，会创建
/opt/CumulusMX/config/.nodata文件标记，避免下次启动重复尝试） - 已存在迁移记录
设置 MIGRATE=force 可忽略预检查强制运行迁移。
迁移步骤
- 将
Cumulus.ini备份至/opt/CumulusMX/config/Cumulus-v3.ini.bak - 将数据目录备份至
/opt/CumulusMX/backup/datav3 - 复制数据目录至
/opt/CumulusMX/datav3 - 执行迁移流程
- 迁移完成后创建
/opt/CumulusMX/config/.migrated文件标记 - 正常启动 CumulusMX
恢复方法
迁移设计为可恢复，但不提供保证。恢复所需文件位置：
Cumulus.ini备份：/opt/CumulusMX/config/Cumulus-v3.ini.bak- v3 数据文件：
/opt/CumulusMX/backups/datav3
恢复操作：将 /config/Cumulus-v3.ini.bak 替换为 /config/Cumulus.ini，并将 /backup/datav3/ 复制到 /data/。
鸣谢
感谢 https://github.com/optoisolated/MXWeather 为 Cumulus MX 容器化所做的初步工作。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 cumulusmx 镜像标签
docker pull docker.xuanyuan.run/hucknz/cumulusmx:<标签>
DockerHub 原生拉取命令
docker pull hucknz/cumulusmx:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"