命令行安装

适用场景与限制

命令行安装通过命令完成部署，无需使用浏览器操作安装向导，安装结果与可视化方式一致。

建议先阅读《可视化安装部署》，了解安装流程。

适用于批量或标准化装机、无法使用浏览器的机房环境，以及需要将安装纳入自动化脚本的场景。

须以 root 身份执行；同一台服务器同一时间只能运行一个安装进程。
安装失败后，进程会退出。处理错误后，重新执行原安装命令重试。
此命令用于安装，不用于节点扩容或日常运维；节点操作请通过管理后台完成，参见「节点管理」章节。

部署前准备

环境须满足《部署前准备》章节的要求。
获取许可证
- 按《生成服务器指纹文件》章节生成服务器指纹文件。
- 按《下载许可证与安装包》章节获取许可证和安装包。
在对应授权服务器上，进入司空安装包根目录，执行以下命令安装许可证。请将 ${许可证 license.tar.gz 路径} 替换为实际文件路径。
```
./InstallLicense.sh ${许可证 license.tar.gz 路径}
```
浏览器所在电脑与服务器的系统时间差不得超过 30 秒，请提前校时。

安装配置准备

编辑物料包内的 resources/site.yaml 模板，填写安装配置。字段说明如下：

字段	必填性	填写说明
`internalIP`	必填	集群节点通信使用的内网 IP，须填写本机静态网卡 IP。
`externalIP`	必填	对外访问 IP：集群的统一入口，供网页、API 和设备访问。地址变更后，设备需重新上云。 - 单节点：填写本机局域网 IP。 - 多节点：填写对外 VIP 或统一入口 IP，并自行配置入口转发和自动故障切换。 - NAT／云主机：填写公网 IP（如弹性 IP），并确保所需端口可达。
`serviceDomain`	非必填	对外服务域名，可留空。未配置时使用 `externalIP`；如需通过独立域名访问，请填写已指向 `externalIP` 的域名。
`adminPassword`	必填	管理后台初始密码，长度为 12～15 位，须同时包含大写字母、小写字母和数字。允许的特殊字符为 `_ @ - ! # % ^ * .`。密码以明文保存在配置文件中，请妥善保管，并在安装完成后及时修改。
`license.node.ip`	必填	实际持有许可证的授权服务器 IP。
`license.node.mode`	非必填	授权节点模式，默认值为 `local`。`local`：授权安装在集群内本机；`remote`：授权安装在集群外独立服务器，适用于云服务器指纹变化的场景。
`dataRoot`	非必填	数据根目录，默认值为 `/data/flighthub2`，安装后不可修改。须使用持久文件系统，不能使用 NFS、tmpfs 或 overlay；可用空间不得小于 200 GB。
`deploymentType`	非必填	部署类型，默认值为 `SAAS`。`SAAS` 表示私有化纯软件部署，`FHAIO` 表示一体机部署。
`podCIDR` / `svcCIDR`	非必填	Pod 网段默认值为 `10.42.0.0/16`，Service 网段默认值为 `10.43.0.0/16`；须避免与现有网络冲突。

启动安装时会检查配置。若提示配置缺失或无效，请按提示检查 resources/site.yaml，修正后重新执行安装命令。

执行安装

# 私有化纯软形态
sudo ./flighthub2-installer bootstrap --auto

# 一体机形态
sudo ./flighthub2-installer bootstrap --auto --deployment-type=FHAIO

终端会实时显示安装进度。安装日志位于 /opt/flighthub2/log/install.log，可用于排查问题。

安装结果验证

安装成功后，访问 http://<对外访问 IP>:30888 进入管理后台。
在「集群管理」中确认节点健康，且无待处理告警。
继续按「业务初始化」章节导入高程数据、绑定机场到组织。

异常处理与重试

安装失败时，先查看终端输出和 install.log 中的原因；处理后重新执行原安装命令。
执行 flighthub2-installer cli log-download 打包并导出日志。
若提示配置缺项，按提示补齐 site.yaml 后重新执行安装命令。

# 命令行安装

# 适用场景与限制

# 部署前准备

# 安装配置准备

# 执行安装

# 安装结果验证