手动部署

如果不使用一键脚本，也可按平台手动安装。安装顺序固定：先装基础库 openapi-depends，再装主应用 zhimou-openapi（主应用依赖基础库）。

安装前请先阅读部署介绍的「端口说明」：install.sh 会做的端口检查，手动安装不会替你检查，9 个端口在安装前都必须空闲。

Nvidia GPU + Ubuntu (x86_64, deb)

安装并确认 Nvidia 驱动

下载并安装基础库 openapi-depends

下载并安装主应用 zhimou-openapi

查看服务信息

Nvidia Jetson Orin NX + Jetpack 6.2 (aarch64, deb)

Nvidia GPU + 银河麒麟 KylinV10 / OpenEuler (x86_64, rpm)

鲲鹏 CPU + 昇腾 GPU + 银河麒麟 KylinV10 / OpenEuler (aarch64, rpm)

昇腾平台若不想手动装驱动，可直接用一键脚本加 --with-ascend-driver，会自动按“驱动 → 固件 → CANN Toolkit”的顺序下载安装（装完需重启后再重跑脚本），见一键部署。

首次安装：初始化 appsecret

zhimou-openapi 在安装脚本于全新安装（非升级）时会自动执行：

随机 32 位密钥仅在终端回显一次，请立刻复制保存。升级不会重跑这一步，以保护既有密钥。若安装时未看到回显，可手动再执行一次上面的命令（旧密钥会失效）。密钥的后续维护（查看掩码、重置）见运维配置的「密钥维护」。