opendronemap/node-opendronemap

NodeODM

NodeODM是一个Node.js应用和REST API，用于访问https://github.com/OpenDroneMap/ODM，它暴露的API被https://github.com/OpenDroneMap/WebODM使用。

镜像概述

NodeODM是OpenDroneMap生态系统的核心组件，提供轻量级API接口，帮助用户通过编程方式调用ODM的无人机影像处理能力，生成点云、正射影像、数字表面模型等地理空间数据，是WebODM平台的后端处理服务。

核心功能

• 提供REST API接口，支持无人机影像上传与任务提交
• 对接ODM的影像处理能力，生成点云、正射影像等结果
• 支持任务状态查询与结果下载
• 与WebODM无缝集成，作为后端处理节点

使用场景

• 无人机影像数据自动化处理
• 地理信息系统（GIS）数据生成
• WebODM平台的后端处理支持
• 无人机测绘项目的工作流集成

配置说明

Docker快速部署

推荐使用Docker启动NodeODM：

bash
docker run -p 3000:3000 docker.xuanyuan.run/opendronemap/node-opendronemap

• Windows/OSX用户：通过docker-machine ip获取Docker机器IP，访问http://<Docker机器IP>:3000
• Linux用户：直接访问http://127.0.0.1:3000

外部存储配置

若需将结果存储在外部硬盘，映射/var/www/data目录：

bash
docker run -p 3000:3000 -v /mnt/external_hd:/var/www/data docker.xuanyuan.run/opendronemap/node-opendronemap

本地运行（Ubuntu）

1. 安装依赖：

bash
apt-get install -y libboost-dev libboost-program-options-dev
# 安装LASzip和PotreeConverter（详见原项目文档）
sudo curl --silent --location https://deb.nodesource.com/setup_6.x | sudo bash -
sudo apt-get install -y nodejs python-gdal
git clone https://github.com/OpenDroneMap/NodeODM && cd NodeODM
npm install

2. 启动服务：

bash
node index.js --odm_path /path/to/OpenDroneMap

PM2后台运行

使用PM2管理进程：

bash
npm install pm2 -g
pm2 start processes.json
pm2 save && pm2 startup

测试模式

无需实际ODM环境时，启用测试模式：

bash
node index.js --test

API文档

详见https://github.com/OpenDroneMap/NodeODM/blob/master/docs/index.adoc