1. 部署上云 API 2 应用运行与设备管控底座
上云 API 2 说明文档(KOC3)
  • 快速开始
  • 申请许可证
  • 联系我们
  • 软件下载
  • 使用上云 API 2 设备模拟器
  • 鉴权接入指南
  • 部署上云 API 2 应用运行与设备管控底座
    • 部署指南
    • 部署前准备
    • 开始部署
    • 能力扩展
  • 设备上云
    • 设备上云
    • 设备固件版本
  • 集成前端独立组件
    • 集成指南
    • 驾驶舱和设备小窗
    • 驾驶舱模块化配置
    • 设备管理组件
    • 航线组件
    • 直播大屏
    • 飞行记录
    • 集成参考
    • PaasJS 新增特性
  • SDK 文档
    • 基本介绍
      • SDK 简介
      • 功能特性
    • 快速入门
      • 准备工作
      • 使用流程
    • 接口调用
      • 接口调用时序图
    • SDK API 文档
      • 使用 API 文档查阅接口详情
    • SDK版本迁移指南
      • 迁移概述
      • 新增方法详情
      • API 变更详情
      • 迁移操作步骤
    • 功能集合
      • SDK初始化
      • SDK配置
      • DRC链路
      • 飞机状态监听
      • 飞向目标点
      • 飞行参数设置
      • 飞行记录导出
      • POI 环绕飞行
      • 一键起飞
      • 航线任务管理
      • 航线任务控制
      • 航线资产管理
      • 机场状态监听
      • 控制权管理
      • 机场控制
      • 飞行控制
      • AI Box 管理
      • AI 智能告警
      • 机载 AI 控制
      • 机载 AI 算法管理
      • PSDK 控制
      • PSDK 资源管理
      • RTK 标定
      • 安全服务
      • 固件管理
      • 媒体服务
      • 日志管理
      • 三维重建
      • 设备管理
      • 设备保修维护
      • 设备健康管理
      • 设备远程调试
      • 设备在线状态
      • 相机控制
      • 直播录制
      • 直播设备管理
      • 直播视频流
      • 直播同步
      • 中继器控制
      • 自定义 SEI
      • WHEP 自定义拉流
      • 网络测速
      • 地图元素管理
      • 频闪灯配置
  • 使用上云 API 2 AI Plugin
    • 上云 API 2 AI Plugin 使用指南
  • 使用上云 API 2 二次开发 Demo
    • 上云 API 2 二次开发 Demo 部署指南
    • 上云 API 2 二次开发 Demo - 无人机管理平台使用说明
  • 排障指南
    • 前端独立组件排障指南
    • SDK排障指南
  1. 部署上云 API 2 应用运行与设备管控底座

部署前准备

本文档说明部署上云 API 2 应用运行与设备管控底座前需要完成的准备工作：关键术语、服务器与网络环境要求、终端设备固件版本要求，以及 Docker 环境安装。

术语说明#

在使用上云 API 2 前，请先了解以下关键术语，有助于更好地理解后续部署与操作。
关键词解释
CodeMeter 服务CodeMeter 是大疆上云 API 2 许可证申请机制的核心组件，负责在服务器上安装、验证和管理许可证授权。部署前需先在服务器上完成 CodeMeter 服务安装，用于在开发者网站申请与绑定对应的许可证。
Terra 建模「Terra 建模」即上云 API 2 软件中依赖大疆智图（Terra）建模引擎开发的私有版建模服务。
MBTiles一种用于存储地图瓦片的文件格式，允许将地图数据打包为单个文件，便于分发和使用。
XYZ 格式地图瓦片一种基于瓦片的地图数据组织方式，通过 X、Y、Z 三个坐标来索引地图瓦片，实现灵活的地图浏览。
NTP 服务即网络时间协议（Network Time Protocol）服务，是一种用于同步计算机时钟的网络服务。它允许计算机客户端与服务器进行时间同步，以确保时间的准确性。NTP 是互联网上最广泛使用的协议之一，用于同步计算机系统的时间。
DockerDocker 是一个开源的应用容器引擎，它允许开发者将应用及其依赖打包到一个轻量级、可移植的容器中，然后发布到任何支持 Docker 的机器上。容器是一个轻量级、可执行的软件包，它将代码和环境封装起来，使得应用可以在几乎任何地方以相同的方式运行，从开发环境到生产环境的无缝迁移。
EMQX一种高性能的分布式消息中间件，支持多种物联网协议，用于处理设备间的实时消息传递。
自签证书由组织或个人自行签发的 SSL / TLS 证书，用于网站或服务的加密传输，但未由公认的证书颁发机构签发，可能不被所有客户端信任。

服务器环境准备#

说明： 本次部署包含三个服务：上云 API 2 平台、Terra 建模服务器、4G 增强图传服务，以下要求已将三个服务合并列出，请按需参考。

服务器配置要求#

上云 API 2 平台服务器配置要求：
配置项推荐配置说明
CPU 核数8C可根据实际情况调整
内存32 GB可根据实际情况调整
数据盘1000 GB可根据实际情况调整
网络纯局域网下，每台机场连接到路由器的网速不低于 100Mbps每台机场开启两路直播时，大概需要 5Mbps 带宽，支持更多设备需要按比例增加网络带宽
说明：
数据盘需要 SSD
如果公网部署，需要固定公网 IP，带宽不低于 100Mbps 稳定且上下行对等的网络环境
此推荐配置经过性能压测，基本可以支持 20 台左右机场同时在线，如果需要同时绑定更多机场使用，请按需增加配置，例如 50 台左右机场，建议使用 16 核、64G 内存的配置。
Terra 建模服务器配置要求：
注意： 建模服务必须部署在一台专有 GPU 服务器上。
配置项推荐配置说明
CPU8C可根据实际情况调整
内存32GB 及以上可根据实际情况调整
硬盘SSD：200GB Free（更佳）可根据实际情况调整
GPU推荐使用计算能力在 6.1 及以上的 NVIDIA 显卡-
显存（VRAM）4GB 及以上-
4G 图传增强服务器配置要求：
4G 增强图传服务部署 可与上云 API 2 部署在同一台服务器，也可单独部署在独立服务器。若单独部署，需确保与上云 API 2 服务器网络互通。

系统要求#

Ubuntu Server 22.04 LTS

核心组件最低版本要求#

上云 API 2 平台 / 4G 图传增强：
核心组件版本匹配
Docker24.0.7（兼容 API version 1.43 的版本均可）
Docker Compose2.21.0
Terra 建模服务器（额外要求）：
核心组件版本匹配
GPU 驱动 cuda 版本>=12.8
注意： 上云 API 2 安装包中提供了 Docker 部署工具，详细安装步骤参考下文「Docker 安装」章节。

网络要求#

上云 API 2 平台网段要求：
网段说明用途（请根据需求开放网段）
10.0.0.0/4上云 API 2 部署时占用的网段SUB_NET_DB
10.0.1.0/4上云 API 2 部署时占用的网段SUB_NET_GATEWAY
10.0.2.0/24上云 API 2 部署时占用的网段SUB_NET_SELF_SERVICE
上云 API 2 平台端口要求：
端口说明用途（请根据需求开放相关防火墙）
40000可视化部署工具需要开通该端口支持办公访问部署工具
80上云 API 2 页面需要开通该端口支持办公访问上云 API 2 前端组件 demo
443上云 API 2 页面（HTTPS）需要开通该端口支持办公访问上云 API 2 服务
123时间同步设备连接上云 API 2，防火墙需要开通端口
1883emqx 服务设备连接上云 API 2，防火墙需要开通端口
8883emqx 加密服务设备连接上云 API 2，防火墙需要开通端口
20000agent-emqx 服务设备连接上云 API 2，防火墙需要开通端口
20001agent-emqx 加密服务设备连接上云 API 2，防火墙需要开通端口
1935rtmp 端口（暂不建议修改）需要开通该端口支持办公访问上云 API 2 服务；设备连接上云 API 2，防火墙需要开通端口
8000webrtc 端口（暂不建议修改）需要开通该端口支持办公访问上云 API 2 服务；设备连接上云 API 2，防火墙需要开通端口
8001webrtc 端口（暂不建议修改）多核方案下，需要开通该端口支持办公访问上云 API 2 服务；设备连接上云 API 2，防火墙需要开通端口
8080网关 dashboard 页面需要开通该端口支持办公访问上云 API 2 服务
30800运维页面需要开通该端口支持办公访问上云 API 2 服务
30801minio 控制台需要开通该端口支持办公访问上云 API 2 服务
30802minio 服务设备连接上云 API 2，防火墙需要开通端口
30804minio-static 服务需要开通该端口支持办公访问上云 API 2 服务；设备连接上云 API 2，防火墙需要开通端口
30805terra 后端服务上云 API 2 自用，无需开通防火墙
30806直播服务需要开通该端口支持办公访问上云 API 2 服务；设备连接上云 API 2，防火墙需要开通端口
30808agent-emqx ws 服务需要开通该端口支持办公访问上云 API 2 服务；设备连接上云 API 2，防火墙需要开通端口
30811grafana 控制台需要开通该端口支持办公访问上云 API 2 服务
30812上云 API 2 后端服务需要开通该端口支持办公访问上云 API 2 服务；设备连接上云 API 2，防火墙需要开通端口
30813map-custom 服务需要开通该端口支持办公访问上云 API 2 服务；设备连接上云 API 2，防火墙需要开通端口
30814map-server 服务需要开通该端口支持办公访问上云 API 2 服务；设备连接上云 API 2，防火墙需要开通端口
30815node-exporter 服务上云 API 2 自用，无需开通防火墙
38080bradge-api 服务需要开通该端口支持办公访问上云 API 2 服务
38081tas-api 服务设备连接上云 API 2，防火墙需要开通端口
30826Terra 连接上云 API 2 的端口需要开通该端口，支持 Terra 访问上云 API 2 服务
30827Terra 连接上云 API 2 的端口需要开通该端口，支持 Terra 访问上云 API 2 服务
19090dronenet-monitor 服务需要开通该端口支持办公访问上云 API 2 服务
30828loki 日志组件需要开通该端口支持办公访问上云 API 2 服务
30816rabbitmq 消息队列需要开通该端口支持办公访问上云 API 2 服务
30824ts-gateway 服务需要开通该端口支持办公访问上云 API 2 服务
30825ts-admin 服务需要开通该端口支持办公访问上云 API 2 服务
30829高程数据服务端口需要开通该端口支持办公访问上云 API 2 服务
30830drtc-manager 上云 API 2 直播服务需要开通该端口支持办公访问上云 API 2 服务
30854live-stream-hub需要开通该端口支持办公访问上云 API 2 服务
30826～30827K3s 服务需要开通该端口支持办公访问上云 API 2 服务
10000～10100直播服务（UDP）需要开通该端口支持办公访问上云 API 2 服务
Terra 建模服务器端口要求：
端口说明
2378Web 服务 HTTP
30819用于运维平台系统指标数据上报
30817用于运维平台容器指标数据上报
30818用于运维平台 GPU 指标数据上报

客户端要求#

浏览器推荐配置说明
谷歌浏览器Chrome 120 及以上版本上云 API 2 仅支持谷歌浏览器，其他浏览器使用可能有性能和可靠性问题

终端设备环境准备#

注意： 终端设备包括机场、飞行器、遥控器，请确保设备固件版本符合上云 API 2 要求。
固件版本支持情况，访问大疆开发者官网部署手册查看，或直接下载固件版本说明查看。
📄 点击查看完整设备固件版本说明
包含大疆机场 3、大疆机场 2、大疆机场、Matrice 4 系列、Matrice 400、Mavic 3 行业系列、Matrice 350 RTK、D-RTK 3 多功能基站、DJI 04 地面站的固件版本要求（发布日期：2026.06.16）。

安装 Docker#

上云 API 2 安装包中内置了 Docker 部署工具，您可以使用该工具快速部署 Docker 环境。若自动安装失败，需根据服务器实际环境自行部署。
工具目录：上云 API 2 安装包解压目录/tool/docker
注意： 如果您的服务器已经安装部署 Docker 且版本不是 27.2.0，请先执行以下命令卸载原有 Docker，再进行安装：

安装步骤#

1.
进入 Docker 工具目录：进入安装包解压目录，找到 docker 工具目录。
2.
执行 Docker 安装脚本：进入 docker 目录并执行安装脚本。
安装过程输出（示例）：
containerd.io_1.7.21-1_amd64.deb
docker-buildx-plugin_0.16.2-1~ubuntu.22.04~jammy_amd64.deb
docker-ce_27.2.0-1~ubuntu.22.04~jammy_amd64.deb
docker-ce-cli_27.2.0-1~ubuntu.22.04~jammy_amd64.deb
docker-compose-plugin_2.29.2-1~ubuntu.22.04~jammy_amd64.deb
(Reading database ... 76335 files and directories currently installed.)
Preparing to unpack .../containerd.io_1.7.21-1_amd64.deb ...
Unpacking containerd.io (1.7.21-1) over (1.7.21-1) ...
Preparing to unpack .../docker-ce_27.2.0-1~ubuntu.22.04~jammy_amd64.deb ...
Unpacking docker-ce (5:27.2.0-1~ubuntu.22.04~jammy) over (5:27.2.0-1~ubuntu.22.04~jammy) ...
Preparing to unpack .../docker-ce-cli_27.2.0-1~ubuntu.22.04~jammy_amd64.deb ...
Unpacking docker-ce-cli (5:27.2.0-1~ubuntu.22.04~jammy) over (5:27.2.0-1~ubuntu.22.04~jammy) ...
Preparing to unpack .../docker-buildx-plugin_0.16.2-1~ubuntu.22.04~jammy_amd64.deb ...
Unpacking docker-buildx-plugin (0.16.2-1~ubuntu.22.04~jammy) over (0.16.2-1~ubuntu.22.04~jammy) ...
Preparing to unpack .../docker-compose-plugin_2.29.2-1~ubuntu.22.04~jammy_amd64.deb ...
Unpacking docker-compose-plugin (2.29.2-1~ubuntu.22.04~jammy) over (2.29.2-1~ubuntu.22.04~jammy) ...
Setting up containerd.io (1.7.21-1) ...
Setting up docker-ce-cli (5:27.2.0-1~ubuntu.22.04~jammy) ...
Setting up docker-buildx-plugin (0.16.2-1~ubuntu.22.04~jammy) ...
Setting up docker-compose-plugin (2.29.2-1~ubuntu.22.04~jammy) ...
Setting up docker-ce (5:27.2.0-1~ubuntu.22.04~jammy) ...
3.
验证安装版本：安装完成后执行以下命令验证版本。
验证输出（示例）：
Client: Docker Engine - Community
 Version:           27.2.0
 API version:       1.47
 Go version:        go1.21.13
 Git commit:        3ab4256
 Built:             Tue Aug 27 14:15:13 2024
 OS/Arch:           linux/amd64
 Context:           default

Server: Docker Engine - Community
 Engine:
  Version:          27.2.0
  API version:      1.47 (minimum version 1.24)
  Go version:       go1.21.13
  Git commit:       3ab5c7d
  Built:            Tue Aug 27 14:15:13 2024
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.7.21
  GitCommit:        472731909fa34bd7bc9c087e4c27943f9835f111
 runc:
  Version:          1.1.13
  GitCommit:        v1.1.13-0-g58aa920
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0
版本输出正常，表示 Docker 安装成功。

下一步#

准备工作完成后，请继续：开始部署
上一页
部署指南
下一页
开始部署
Built with