开放平台部署介绍#
开放平台支持 Nvidia GPU 架构平台与华为昇腾 Ascend 架构平台，覆盖 Ubuntu、银河麒麟 KylinV10、OpenEuler 三类操作系统，deb / rpm 两种安装包。
Nvidia GPU 架构平台支持带视频硬编码芯片的现代英伟达 GPU（驱动需 >= 570）与 Nvidia Jetson Orin NX（Jetpack 6.2）。
Nvidia GPU 架构平台支持 Ubuntu 20.04 lts 及以上版本、银河麒麟 KylinV10 与 OpenEuler 22 操作系统。
昇腾 GPU 架构平台支持鲲鹏 920 CPU + 昇腾 310P3 GPU，支持银河麒麟 KylinV10 与 OpenEuler 操作系统，支持 Atlas 300I Duo、Atlas 300I Pro 推理卡。
部署会依次拉起 5 个 systemd 服务：openapi_minio → openapi_nanomq → openapi_srs → openapi_mysql → zhimou_openapi，安装完成后开机自启。
当前发布版本为 1.1.1，安装包文件名自带版本号（如 zhimou-openapi_1.1.1_amd64.deb、openapi-depends-1.1.1-0.ky10.aarch64.rpm）。
端口说明#
部署涉及的端口按暴露面分为两类：对外开放端口需在外层防火墙 / 云安全组放行，供客户端访问；本地监听端口由服务绑定在 127.0.0.1，仅供本机上的 zhimou_openapi 互访，不需要也不应该对外开放。| 端口 | 用途 | 服务 |
|---|
| 10042 | 开放平台接口服务（API） | zhimou_openapi |
| 11883 | MQTT TCP | openapi_nanomq |
| 18083 | MQTT WebSocket | openapi_nanomq |
| 11935 | 视频流 RTMP | openapi_srs |
| 18000/udp + 18000/tcp | 视频流 WebRTC（UDP 为主，同口兼提供 TCP） | openapi_srs |
本地监听端口（仅 127.0.0.1，无需对外开放）：| 端口 | 用途 | 服务 |
|---|
| 19000 | 对象存储 MinIO | openapi_minio |
| 13306 | 数据库 MySQL | openapi_mysql |
| 11985 | SRS HTTP 接口（api） | openapi_srs |
| 11980 | SRS HTTP 服务（server） | openapi_srs |
install.sh 在执行安装前会检查以上全部 9 个端口：TCP 监听用 ss -ltn 查，WebRTC 的 18000 额外用 ss -lun 查一次 UDP 占用。两类端口在安装前都必须空闲，一旦发现任一端口被占用会直接中止安装，并列出占用端口（区分 18000/tcp 与 18000/udp）及处置提示；需先停止占用进程（如旧版本服务）后重试。MinIO(19000)、MySQL(13306)、SRS 内部 HTTP(11985/11980) 均绑定 127.0.0.1，无需在防火墙放行；若误对外暴露反而带来安全风险。
文档导航#
| 文档 | 内容 | 适用场景 |
|---|
| 一键部署 | install.sh 一键部署、离线服务器部署、自定义安装目录 | 推荐，绝大多数场景 |
| 手动部署 | 分平台手动安装 deb / rpm、首次安装 appsecret 初始化 | 不使用一键脚本时 |
| 集群部署 | 集群代理 openapi_cluster 聚合多个平台实例 | 多平台组集群时 |
| 运维配置 | 卸载与清理、zhimou_openapi 命令行运维工具、config.yaml 配置、常见问题排查 | 部署后的日常运维 |
| 国标接入 | GB28181 国标视频接入 | 需要接入国标设备 / 平台时 |
| 上云API2接入 | 大疆上云 API2（FlightHub 2 基地）对接 | 需要无人机自动开流分析时 |
