1. 部署前必须先定的四件事

POC 部署手册章节。按 2026.10 主线代码核对；命令输出以当次交付的安装器为准。

返回概览 · 完整版目录 · 下载完整 PDF

本章内容：安装器一旦开始写入，产品、部署形态和大部分数据依赖选择就不能再改。本章把这几个决定和它们的影响一次说清，读者照本章填完 1.6 节的确认表之后，后面的章节才有唯一答案。读者是负责本次 POC 的实施工程师，以及需要签字确认的客户方系统管理员。

1.1 选哪个产品

定制站第一步就要选产品，安装完成后不能更换。

两个产品用同一个安装器、同一套命令，区别只在离线包里带了哪些能力。换成另一个产品只能清空重装（第 11 章），原有数据全部删除。

怎么定：本次只验证网关能力（模型接入、密钥与调用、路由与护栏、用量与审计）就选 Zentrix 网关；要一并验证知识库、文档解析、智能体就选完整版。拿不准时按完整版选，未启用的能力保留在离线包内，安装后可在控制台启用，不用重新下载。

注意：离线包文件名里带产品字段（zenova-zentrix_gateway-… 或 zenova-zenova-…），安装器文件名不带。同一版本两个产品的安装器文件名相同，下载后分目录存放，否则上传时极易拿错。

1.2 选哪种形态

当前版本提供两种形态，适用场景完全不同。

单机加远端网关节点（业务调用需要在别的网络区域就近接入）在第 9 章。

注意：本手册的验收、备份、升级、故障排查命令全部针对原生安装。Helm 形态的离线包内容、安装方式和日常操作都不同，不要混用。

1.3 主机与容量

安装器在写入任何内容之前先做主机检查，不满足要求会停在检查这一步。

磁盘按所选组件累加，检查对象是安装目录（默认 /opt/zenova）所在文件系统的可用空间。

三种典型组合：

注意：上表是安装检查的门槛，不含业务数据增长、日志与本机备份。POC 期间调用量小，按门槛准备即可；转正式运行前按并发量与数据保留期重新评估。

磁盘不足时的两种行为：不传 --install-dir 时，空间不足直接阻断，并输出诊断代码 HOST_DISK_LOW，Linux 上同时列出本机可用空间最大的三个挂载点供改用。显式传了 --install-dir（包括显式写成默认值 /opt/zenova）时，空间不足只告警并继续。因此不要为了绕过检查而随手加 --install-dir——加了之后这项检查就只剩提示。

1.4 访问地址与端口

访问地址是浏览器和调用方使用的地址，本机监听端口是安装主机实际接收请求的端口。两者在有代理、NAT 或 TLS 入口时可以不同。

注意：填写 https:// 不会让本机提供 HTTPS。证书与加密终结必须在客户的负载均衡或反向代理上完成，转发到本机的仍是明文 HTTP。另外，访问地址为 http:// 时登录页不提供通行密钥，两步验证只能用验证器应用。

管理入口（控制台）默认与业务入口共用一个端口。需要把控制台单独放一个端口时加 --admin-entry-port。业务入口承载模型、MCP、A2A 调用与健康检查，端口被占用时安装停止且不自动更换；管理入口端口被占用时安装器顺延到下一个空闲端口并提示。

开火墙：入站只需放行业务入口端口（与启用时的 443）。安装器在 Linux 上只自动放行业务入口与 443，不放行分离后的管理入口；ufw 与 nftables 不处理，需要运维方手工配置。

1.5 数据依赖

三项数据依赖各自选择「由我们部署」或「使用现有服务」。

选择时按以下约束判断：

POC 建议：三项全部由安装器部署。这样备份恢复、清空重装都能在本机闭环，不受客户数据库管理员的窗口约束。

云数据库的坑：云上「高权限账号」通常不是超级用户（rolsuper 为假），安装器检测会拒绝。选现有 PostgreSQL 前先在客户侧确认 SELECT rolsuper FROM pg_roles WHERE rolname = current_user; 返回 t。

1.6 部署参数确认表

安装前填完下表，由客户确认。口令和密钥不填在表上，只登记保管位置与保管人。

注意：这张表是后续所有步骤的唯一依据。第 6 章初始化完成后，把实际值与这张表核对一遍，不一致的地方记进交付记录——POC 转正式运行时，这张表就是交接材料的第一页。

能力说明

---

下一章：2. 从下载站取得安装物料