安装部署

Q：上云 API 2 SDK 的运行环境要求是什么？

操作系统：x86 架构的 Linux 环境，推荐 Ubuntu 22.04 及以上版本

JDK 版本：JDK 8 或更高版本

CPU 架构：x86_64

内存要求：建议至少 4GB 可用内存

Q：上云 API 2 SDK 是否需要配套底座服务使用？

需要。上云 API 2 SDK 依赖底座服务提供 API 鉴权、设备（机场/无人机）绑定、设备上云、设备远程调试、远程操控等功能。

Q：上云 API 2 进行 SDK 集成及功能测试前，是否需要先完成底座部署？

是的。进行 SDK 集成及功能测试前，请先完成以下准备工作：

上云 API 2 底座部署完成，并可正常访问管理后台；

设备（机场/无人机）已完成绑定。

Q：上云 API 2 底座首次部署时，Terra 建模、4G 图传增强等扩展功能是否需要全部安装？

扩展功能支持按需安装。首次部署可先安装核心底座平台，后续根据业务需要补充安装 Terra 建模、4G 图传增强等服务。

Q：上云 API 2 可以先单独验证前端组件，再通过 SDK 接入底座吗？

不可以。上云 API 2 前端组件和 SDK 均基于底座运行，需结合底座、SDK 和前端组件进行完整集成验证，无法脱离底座单独验证前端组件。

Q：重新安装上云 API 2 底座时，是否可以直接复用此前使用的 `env` 配置文件？

可以。若服务器环境和 IP 地址未变更，可复用原 env 文件。部署前需验证 INTERNAL_IP、EXTERNAL_IP、BIND_CODE 等关键字段是否准确。

Q：上云 API 2 安装新版本底座会覆盖 data 目录吗？

不会覆盖。

Q：之前安装过上云 API 2 底座且没有删除镜像，重新安装同版本底座时可以跳过镜像加载吗？

可以。如果服务器中仍保留对应版本镜像，可执行以下命令跳过镜像加载：

Q：上云 API 2 部署是否需要使用桌面版 Ubuntu？支持命令行版 Ubuntu 吗？

上云 API 2 支持在命令行版 Ubuntu 环境下进行部署。

Q：通过命令行部署上云 API 2 底座后，如何安装 AIO 管理后台？

底座安装完成后，执行以下命令：

Q：上云 API 2 底座可视化部署能否跳过磁盘容量校验？

不能。磁盘容量校验属于部署必检项，需满足检查要求后继续安装，以保证镜像、日志和业务数据具备足够存储空间。

Q：上云 API 2 底座存储配置是否支持自有 S3 在线存储桶？是否支持阿里云 OSS？

上云 API 2 支持配置标准 S3协议的自定义存储桶，暂不支持阿里云 OSS。

Q：上云 API 2 底座部署完成后还能修改端口吗？

支持修改可配置端口，可在 AIO 管理后台 → 服务配置 → 服务端口 中完成调整。

Q：上云 API 2 底座部分端口没有配置入口，应该如何调整？

没有管理后台配置入口的端口，需查看 env 配置文件中的备注：

标注为不建议修改的端口，应保持默认配置；

其他端口可按部署文档修改对应配置项。

Q：上云 API 2 底座部署手册标注"办公访问"的端口是否必须开放到公网？

需确保办公电脑能够访问对应端口。是否开放到公网取决于办公电脑与底座服务器的网络拓扑；处于同一内网时，配置内网访问即可。

Q：上云 API 2 的底座与 4G 私有化增强图传服务是否可以部署在同一台服务器上？端口是否会冲突？

可以，上云 API 2 底座与 4G 私有化增强图传服务支持部署在同一台服务器上，服务端口不存在冲突。

Q：安装 HTTPS 证书后，前端仍通过 80 端口访问，应该如何处理？

可在 AIO 管理后台 → 服务配置 → 服务端口 中，将前端访问端口由 80 调整为 443，并确认 HTTPS 证书及反向代理配置已生效。

Q：在 AIO 管理后台修改外部 IP 地址没有生效应如何处理？

修改外部 IP 地址需同步更新配置文件中的 EXTERNAL_IP 字段：

Q：AIO 管理后台是否支持通过 HTTPS 访问？

暂不支持。管理后台（30888 端口）仅支持 HTTP 访问：http://<服务器IP>:30888。

Q：上云 API 2 底座运维平台密码在哪里设置？

可在 AIO 管理后台 → 账号设置 中设置或修改密码。

Q：上云 API 2 后端底座中 `fhaio-install` 目录的作用是什么？

fhaio-install 是 AIO 管理后台容器的挂载目录，用于存放地图瓦片、高程数据、升级包、证书等文件，是容器与宿主机交换数据的专有存储空间。

Q：上云 API 2 AIO 管理后台中的运维日志和操作日志有什么区别？

运维日志： 整套后端各服务（容器）的运行日志，用于查看底座业务服务运行情况。

操作日志： 管理后台接口的调用流水，主要记录 path、返回码、耗时等信息，用于接口审计，不包含设备业务日志。

Q：上云 API 2 的底座部署完成后，无法访问底座前端页面/使用 IP + 80 端口无法访问前端页面，应如何处理？

上云 API 2 底座不提供前端页面入口，属于正常情况，80 端口不支持直接访问前端页面。目前相关管理操作需通过 AIO 管理后台完成，访问地址为：

http://底座服务器IP:30888

即可进入 AIO 管理后台，主要用于底座服务配置、设备上云管理等功能。管理后台默认访问端口为 30888。

如需访问设备绑定等操作页面，请通过管理平台进入前端页面。

Q：上云 API 2 前端组件页面加载失败，如何解决？

前端组件默认使用 80 端口加载资源。若修改前端端口，可能导致组件资源加载失败。

请确认前端组件配置的端口与实际部署端口保持一致。

Q：如何升级上云 API 2 的底座？

上云 API 2 底座支持在线升级和本地升级两种方式。

升级前，请先登录上云 API 2 管理平台（默认访问地址：http://底座服务器IP:30888），然后选择以下任一方式进行升级：

在线升级

进入「系统更新还原」→「上云 API 2 在线升级检测」，根据页面提示完成升级。

本地升级

进入「系统更新还原」→「上云 API 2 本地升级」，上传升级包并根据页面提示完成升级。

Q：上云 API 2 单个前端组件（驾驶舱、航线编辑器、设备管理、飞行回放）能否与底座解耦，单独更新？

目前不支持单个前端组件的独立更新。

Q：AIO 管理后台的自签名证书更新后如何生效？

证书更新后执行以下命令生效：

Q：上云 API 2 底座中 Portainer、MinIO、EMQX、Grafana、RabbitMQ 等组件的控制台账号密码在哪里设置？

登录上云 API 2 管理平台，进入 账号设置 ---> 其他账号，即可查看和设置相关组件的控制台账号密码。管理平台访问地址如下：

http://底座所在服务器IP:30888

Q：上云 API 2 SDK 的运行环境要求是什么？#

Q：上云 API 2 SDK 是否需要配套底座服务使用？#

Q：上云 API 2 进行 SDK 集成及功能测试前，是否需要先完成底座部署？#

Q：上云 API 2 底座首次部署时，Terra 建模、4G 图传增强等扩展功能是否需要全部安装？#

Q：上云 API 2 可以先单独验证前端组件，再通过 SDK 接入底座吗？#

Q：重新安装上云 API 2 底座时，是否可以直接复用此前使用的 env 配置文件？#

Q：上云 API 2 安装新版本底座会覆盖 data 目录吗？#

Q：之前安装过上云 API 2 底座且没有删除镜像，重新安装同版本底座时可以跳过镜像加载吗？#

Q：上云 API 2 部署是否需要使用桌面版 Ubuntu？支持命令行版 Ubuntu 吗？#

Q：通过命令行部署上云 API 2 底座后，如何安装 AIO 管理后台？#

Q：上云 API 2 底座可视化部署能否跳过磁盘容量校验？#

Q：上云 API 2 底座存储配置是否支持自有 S3 在线存储桶？是否支持阿里云 OSS？#

Q：上云 API 2 底座部署完成后还能修改端口吗？#

Q：上云 API 2 底座部分端口没有配置入口，应该如何调整？#

Q：上云 API 2 底座部署手册标注"办公访问"的端口是否必须开放到公网？#

Q：上云 API 2 的底座与 4G 私有化增强图传服务是否可以部署在同一台服务器上？端口是否会冲突？#

Q：安装 HTTPS 证书后，前端仍通过 80 端口访问，应该如何处理？#

Q：在 AIO 管理后台修改外部 IP 地址没有生效应如何处理？#

Q：AIO 管理后台是否支持通过 HTTPS 访问？#

Q：上云 API 2 底座运维平台密码在哪里设置？#

Q：上云 API 2 后端底座中 fhaio-install 目录的作用是什么？#

Q：上云 API 2 AIO 管理后台中的运维日志和操作日志有什么区别？#

Q：上云 API 2 的底座部署完成后，无法访问底座前端页面/使用 IP + 80 端口无法访问前端页面，应如何处理？#

Q：上云 API 2 前端组件页面加载失败，如何解决？#

Q：如何升级上云 API 2 的底座？#

Q：上云 API 2 单个前端组件（驾驶舱、航线编辑器、设备管理、飞行回放）能否与底座解耦，单独更新？#

Q：AIO 管理后台的自签名证书更新后如何生效？#

Q：上云 API 2 底座中 Portainer、MinIO、EMQX、Grafana、RabbitMQ 等组件的控制台账号密码在哪里设置？#