上云API2接入
dji_api2.enable=false）。配置在安装目录 config.yaml（默认 /opt/zhimou/config.yaml）的 dji_api2 段，修改后需重启服务生效。config.yaml 的整体结构与其余段落见 运维配置。网络与鉴权要求
scheme://address:port；无人机画面拉流地址（WHEP，典型端口 30806）由基地在开流响应里带回，不在本平台配置，需保证该地址平台可达。POST /api/dji/webhook（即 http_bind:http_port，默认 10042）。该路径免 JWT（基地不持本平台 token），按共享凭据校验，需基地能直连本平台。auth 既是平台出站请求基地时出示的凭据，也是入站 webhook 逐键比对的基准——同一份共享密钥，两侧必须一致。缺省用 Authorization: Bearer {APPKEY}，{APPKEY} 运行期自动换成本机 appkey（落盘只存占位，不存真实密钥）。基地侧 ISV 配置里必须填入与本平台完全相同的凭据。address（要求基地直连）；经反向代理会改写来源地址使判源恒失败，需显式配 allow_from 放行代理来源。{"allowed":…} 中，基地侧 3s 超时即视为拒绝。auth 删空而基地回调仍带凭据 → 一律 credential mismatch 拒绝；日志会记录被拒来源、原因与期望键名，鉴权失败是唯一有完整现场日志的路径。接入步骤
编辑 config.yaml 的 dji_api2 段
在基地侧登记本平台为 ISV 应用
向基地管理员提供本平台地址（供回调的 webhook：
http://<平台 IP>:10042/api/dji/webhook）与 auth 里约定的共享凭据，由基地管理员在 PaaS 控制台完成 ISV 配置。凭据与 auth 不一致时表现为设备状态全部回调被拒。重启服务并查看启动日志
验证设备与映射
签发 token 后查基地设备拓扑（经同一套 JWT 鉴权，与 webhook 不是一条路径）：
appkey / appsecret 见 zhimou_openapi -show-license。配置项说明
| 字段 | 缺省 / 必须满足 | 说明与填错的典型现象 |
|---|---|---|
enable | false | 总开关；关闭时 0 goroutine、0 外连 |
address | 必填 | 基地网关 host。开着但 address 为空 → 启动期直接 skip，日志仅一行 djiapi2: address empty, skip；它同时是空凭据回调的默认判源依据 |
port / scheme | 30812 / http | 只指 HTTP 网关（含通知 WS）；媒体 WHEP 地址由基地响应带回，不在这里配 |
auth | 内置 Authorization: Bearer {APPKEY} | 头名 → 整串头值；出站鉴权与入站 webhook 比对的同一份共享密钥。{APPKEY} 运行期换成本机 appkey，与基地侧登记值必须逐字符一致，否则一路 credential mismatch；显式配空 map 而基地带凭据回调 → 全量拒绝（fail-closed） |
allow_from | 空 = 按 address 解析 IP 判源 | 仅影响空凭据回调；反向代理 / NAT 后需加代理来源（IP/CIDR/域名），否则内部流量全被拒 |
camera / video | 空 = 自动探测 | 多镜头 / 多码流机型固定选哪一路；留空由库按基地返回的清单自动挑 |
5s→60s，单轮跑满 60s 视为真连上并复位）。若某次起飞没起分析任务，另查日志 model registry not ready 行：起飞早于模型池就绪时该次飞行不会重试，下一架次恢复正常。修改于 2026-11-03 06:53:25