一键部署

推荐：install.sh 一键部署

所有平台都推荐用 install.sh 一键部署：脚本会自动检测平台、检查 GPU 驱动、下载并校验安装包、按依赖顺序安装并拉起服务，无需记忆各平台差异。

需要给脚本传参时（例如自定义安装目录 --prefix），改用管道形式 curl ... | sudo bash -s -- <选项>（-- 之后的参数会作为位置参数传给 install.sh）：

脚本执行完毕后会自动等待服务就绪，并打印 5 个服务的状态与 API 端口探活结果：

常用选项

选项	说明
`--prefix DIR`	自定义安装目录，替代默认的 `/opt/zhimou`（等价于 `OPENAPI_PREFIX` 环境变量），deb 与 rpm 均支持；仅对全新安装生效，已有安装不迁移
`--local`	不下载，直接用当前目录下已有的 deb/rpm 安装
`--download-only`	只下载安装包与 `SHA256SUMS` 到当前目录，不安装（用于离线部署，无需 root）
`--platform DIR`	跳过自动检测，强制按指定平台处理；配合 `--download-only` 可在 A 机下载 B 平台的包
`--skip-driver`	跳过 GPU 驱动检查（驱动已装好的机器）
`--with-ascend-driver`	昇腾平台：自动安装昇腾驱动 + 固件 + CANN Toolkit（安装后需重启）
`--force-new-install`	先卸载/purge 两个包（会清空数据）再全新安装，执行前二次确认
`--dry-run`	只打印将执行的命令，不实际执行
`-h, --help`	查看完整帮助

--platform 的取值：nvidia_ubuntu_x86_64 / jetson_ubuntu_aarch64 / nvidia_kylin_x86_64 / ascend_kylin_aarch64。

部署示例输出

以下为 nvidia_ubuntu_x86_64 平台一次成功的一键部署完整日志。脚本会自动检测平台、检查驱动、下载并校验两个包、按依赖链依次拉起服务，最后探活 API 端口 10042：

# sudo bash -c "$(curl -fsSL https://zhimouyun.com/openapi/install.sh)"
==================================================
 zhimou openapi 一键部署
==================================================
[install] 平台: deb / x86_64 (nvidia_ubuntu_x86_64)  GPU: nvidia
[install] 下载前缀: https://zhimouyun.com/openapi/nvidia_ubuntu_x86_64
[install] 安装目录: /opt/zhimou (默认)

[install] NVIDIA 驱动 OK: 570.172.08 (>= 570)
[install] libaio 运行时库已可用（ldconfig 检出）
[install] 下载 https://zhimouyun.com/openapi/nvidia_ubuntu_x86_64/openapi-depends_1.1.1_amd64.deb ...
[install] SHA256 校验通过: openapi-depends_1.1.1_amd64.deb
[install] 下载 https://zhimouyun.com/openapi/nvidia_ubuntu_x86_64/zhimou-openapi_1.1.1_amd64.deb ...
[install] SHA256 校验通过: zhimou-openapi_1.1.1_amd64.deb
[install] 安装: dpkg -i /home/zhimou/openapi-depends_1.1.1_amd64.deb /home/zhimou/zhimou-openapi_1.1.1_amd64.deb
Selecting previously unselected package openapi-depends.
(Reading database ... 315177 files and directories currently installed.)
Preparing to unpack .../openapi-depends_1.1.1_amd64.deb ...
Unpacking openapi-depends (1.1.1) ...
Selecting previously unselected package zhimou-openapi.
Preparing to unpack .../zhimou-openapi_1.1.1_amd64.deb ...
Unpacking zhimou-openapi (1.1.1) ...
Setting up openapi-depends (1.1.1) ...
bootstrap: MySQL 冒烟检查通过：/opt/zhimou/depends/openapi_mysql/bin/mysqld  Ver 9.6.0 for Linux on x86_64 (MySQL Community Server - GPL)
Created symlink /etc/systemd/system/multi-user.target.wants/openapi_minio.service → /lib/systemd/system/openapi_minio.service.
Created symlink /etc/systemd/system/multi-user.target.wants/openapi_nanomq.service → /lib/systemd/system/openapi_nanomq.service.
Created symlink /etc/systemd/system/multi-user.target.wants/openapi_srs.service → /lib/systemd/system/openapi_srs.service.
Created symlink /etc/systemd/system/multi-user.target.wants/openapi_mysql.service → /lib/systemd/system/openapi_mysql.service.
2026-10-09T14:44:38.406267Z 0 [System] [MY-015017] [Server] MySQL Server Initialization - start.
2026-10-09T14:44:38.407212Z 0 [System] [MY-013169] [Server] /opt/zhimou/depends/openapi_mysql/bin/mysqld (mysqld 9.6.0) initializing of server in progress as process 1938553
2026-10-09T14:44:38.413109Z 1 [System] [MY-013576] [InnoDB] InnoDB initialization has started.
2026-10-09T14:44:38.571993Z 1 [System] [MY-013577] [InnoDB] InnoDB initialization has ended.
2026-10-09T14:44:39.941807Z 6 [Warning] [MY-010453] [Server] root@localhost is created with an empty password ! Please consider switching off the --initialize-insecure option.
2026-10-09T14:44:41.266446Z 0 [System] [MY-015018] [Server] MySQL Server Initialization - end.
mysql: [Warning] Using a password on the command line interface can be insecure.
Setting up zhimou-openapi (1.1.1) ...
Created symlink /etc/systemd/system/multi-user.target.wants/zhimou_openapi.service → /lib/systemd/system/zhimou_openapi.service.
[install] 等待服务启动 (最多 60s)...

[install] 服务状态:
● openapi_minio.service - Openapi Minio Service
     Active: active (running) since Fri 2026-10-09 22:44:46 CST; 57ms ago
● openapi_nanomq.service - Openapi Nanomq Service
     Active: active (running) since Fri 2026-10-09 22:44:37 CST; 9s ago
● openapi_srs.service - Openapi SRS Service
     Active: active (running) since Fri 2026-10-09 22:44:38 CST; 9s ago
● openapi_mysql.service - Openapi MySQL Service
     Active: active (running) since Fri 2026-10-09 22:44:38 CST; 9s ago
● zhimou_openapi.service - Zhimou OpenApi Service
     Active: activating (auto-restart) since Fri 2026-10-09 22:44:47 CST; 496ms ago

[install] 安装目录: /opt/zhimou
[install] 前缀记录: /opt/zhimou
[install] 等待 3s 让服务完全启动...
[install] API 端口 10042 响应: 200 ✓

════ zhimou-openapi 首次安装：生成 appsecret（32 位随机密钥仅此一次明文回显，请立即复制保存）════
2026-10-09 22:44:42     [openapi] build time:             2026-10-09 21:43:29
2026-10-09 22:44:42     [openapi] build hash:             f38da46
2026-10-09 22:44:45 appsecret 已重置
appkey:    19b2717xxxxxxxxxxxxxxxxe566eaeb4
appsecret: F05ON4wXXXXXXXXXXXXXXXXVCt5DRpZH
2026-10-09 22:44:45 请妥善保管上述密钥(仅本次回显, 遗失只能再次重置)
2026-10-09 22:44:45 执行 '-service restart' 后新密钥生效, 旧密钥同时失效
════════════════════════════════════════════════════════════════════════════

[install] 部署完成。

日志中的 appsecret 行（上例已脱敏）是首次安装时唯一一次明文回显，必须当场复制保存；离开这个界面后只能 -show-license 查看掩码，或 -reset-appsecret 重置（旧密钥失效）。上方 appkey 行即控制台登录页要手输的 appkey，应与 appsecret 一并保存。

用 install.sh 一键部署时，这段回显会被挪到最末尾（紧接 [install] 部署完成。 之前），避免密钥被中间的服务状态日志冲走；手动 dpkg -i / rpm -Uvh 安装时仍在包安装过程中按原位置实时回显。

离线服务器部署

在联网机器上只下载、不安装，再把整目录拷到无外网的部署服务器安装：

若需要 GPU 驱动检查但机器无外网，可加 --skip-driver 跳过；昇腾平台若需一并安装驱动，请在有驱动的镜像/机器上执行。

自定义安装目录

默认安装到 /opt/zhimou。如需安装到其他目录：

实际安装目录记录在 /var/lib/zhimou-openapi/prefix；已有安装不会跨目录迁移，若本次 prefix 与已记录的不一致会安装失败，必须先 purge 再重装。

目录必须是绝对路径、不含空白与 | & \ 字符，且不能嵌套在 /opt/zhimou/ 之下。

推荐：install.sh 一键部署#

常用选项#

部署示例输出#

离线服务器部署#

自定义安装目录#

推荐：install.sh 一键部署

常用选项

部署示例输出

离线服务器部署

自定义安装目录