opendronemap/clusterodm Docker 镜像 - 轩辕镜像

ClusterODM

镜像概述和主要用途

ClusterODM是一款为NodeODM API兼容节点设计的反向代理、负载均衡器和任务跟踪器，具备可选的云自动扩展能力。它能将多个NodeODM节点整合到单一网络地址下，实现任务的智能分配（考虑最大图像数、队列大小和插槽可用性等因素），并支持通过主流云服务提供商（DigitalOcean、Hetzner、Scaleway、AWS）自动扩缩容节点。该工具已在WebODM Lightning Network上经过实战检验，可可靠处理数千个数据集。

!image

核心功能和特性

• 反向代理：将所有Web请求转发至集群中的NodeODM节点，提供单一访问入口
• 智能负载均衡：基于节点负载（队列大小、可用插槽、最大图像处理能力）分配任务
• 任务跟踪：监控所有节点上的任务状态和进度
• 云自动扩展：根据任务需求自动启动/关闭云节点（支持DigitalOcean、Hetzner、Scaleway、AWS）
• Web UI兼容：通过3000端口提供与NodeODM一致的用户界面
• 节点状态监控：通过***端口查看集群节点状态和健康状况
• CLI节点管理：通过telnet连接8080端口执行节点添加、列出、锁定等操作
• 高可靠性：在WebODM Lightning Network上经过长期实战验证，稳定处理大量数据

使用场景和适用范围

• 需要扩展NodeODM处理能力，通过多节点分担任务负载的场景
• 管理多个分布式NodeODM节点，实现集中式任务分配与监控
• 按需使用云资源以降低成本（仅在任务需求时启动云节点）
• 企业或个人处理大量无人机影像数据，需要可靠的分布式处理方案
• 希望通过单一界面统一管理多个NodeODM节点的用户

详细使用方法和配置说明

安装方式

ClusterODM支持多种安装方式：

1. NodeJS源码安装

需先安装NodeJS：

bash
git clone [***]
cd ClusterODM
npm install

2. Docker安装（推荐）

直接使用官方Docker镜像：

bash
docker pull opendronemap/clusterodm

3. Windows捆绑包

从发布页面下载最新clusterodm-windows-x64.zip，解压后运行：

bash
clusterodm.exe

基本使用方法

参数说明

通过node index.js --help或Docker运行时添加--help查看所有参数选项。

启动命令

源码启动

bash
node index.js [参数]

Docker启动

bash
docker run --rm -ti -p 3000:3000 -p 8080:8080 opendronemap/clusterodm [参数]

• -p 3000:3000：映射Web UI端口（NodeODM兼容界面）
• -p 8080:8080：映射CLI管理端口（节点管理）

节点管理（CLI）

通过telnet连接8080端口管理节点：

bash
telnet localhost 8080

常用命令：

• HELP：查看命令帮助
• NODE ADD <主机> <端口>：添加NodeODM节点
• NODE LIST：列出所有节点及其状态
• NODE LOCK <节点ID>：锁定节点（不分配新任务）
• NODE UNLOCK <节点ID>：解锁节点

示例：添加并锁定本地NodeODM节点

> NODE ADD localhost 3001
> NODE LOCK 1
> NODE LIST
1) localhost:3001 [online] [0/2] <version 1.5.1> [L]

访问界面

• Web UI：http://localhost:3000（与NodeODM界面一致）
• 节点状态监控：http://localhost:***（集群状态页面）

自动扩展配置

ClusterODM可根据任务需求自动扩缩容云节点，配置步骤如下：

前提条件

• 安装docker-machine
• 准备S3兼容存储桶（用于存储处理结果）
• 创建云平台配置文件（参考各平台配置文档）

启动自动扩展

bash
# 源码启动
node index.js --asr configuration.json

# Docker启动（需挂载配置文件和docker-machine目录）
docker run --rm -ti -p 3000:3000 -p 8080:8080 \
  -v $(pwd)/configuration.json:/configuration.json \
  -v ~/.docker/machine:/root/.docker/machine \
  opendronemap/clusterodm --asr /configuration.json

配置参考节点

自动扩展需至少添加一个"参考节点"（用于UI转发和选项验证），建议添加本地NodeODM并锁定：

bash
telnet localhost 8080
> NODE ADD localhost 3001  # 添加本地NodeODM节点（需先启动NodeODM）
> NODE LOCK 1              # 锁定节点，避免任务分配到该节点
> NODE LIST                # 确认节点状态
1) localhost:3001 [online] [0/2] <version 1.5.1> [L]

Docker Compose部署示例

使用docker-compose快速部署ClusterODM和NodeODM（含参考节点）：

yaml
# docker-compose.yml
version: '3'
services:
  clusterodm:
    image: opendronemap/clusterodm
    ports:
      - "3000:3000"   # Web UI端口
      - "8080:8080"   # CLI管理端口
      - "***:***" # 节点状态端口
    depends_on:
      - nodeodm
  nodeodm:
    image: opendronemap/nodeodm
    ports:
      - "3001:3000"   # NodeODM端口

启动命令：

bash
docker-compose up

路线图

ClusterODM有多个增强功能计划，详情参见GitHub issues。欢迎通过OpenDroneMap社区论坛参与贡献或获取帮助。