跳到主要内容

一键安装（推荐）

如果服务器能联网，一条命令即可启动安装。安装脚本从发布 服务器 product.kopens.io 获取。

curl -fsSL https://product.kopens.io/plantpulse-ai/install.sh | sudo bash

隔离网络下无法使用此方式 → 隔离网络安装。

开始之前​

需确认项内容
权限必须以 root 身份运行（sudo bash）
网络可通过 HTTPS 访问 product.kopens.io · docker.kopens.io
硬件含 GPU 的要求 → 系统要求

会获取什么 — 代码仓库集​

AI 技术栈的 compose 需要三个代码仓库并列存在才能启动。

/opt/kopens/
├── plantpulse-ai-docker/                  ← 설치 본체
├── plantpulse-ai-inference-server/
└── plantpulse-timeseries-insight-server/

一键安装会获取包含这三者的捆绑包（plantpulse-ai-bundle.tar.gz），一次性解压。 无需另行准备任何内容。 脚本解压后会检查三者是否齐全，若有缺失， 会打印其名称并切换到其他路径 — 这是防止以残缺状态启动的保护机制。

若要在内部直接从代码仓库获取

提供 GIT_USER · GIT_TOKEN，即会从 dev.kopens.io 执行 git clone 而非使用捆绑包。 由于客户方没有我们的 GitLab 账号，默认方式为捆绑包。

指定数值进行安装​

环境变量需放在 bash 之前。放在 curl 之后则不会随管道传递。

curl -fsSL https://product.kopens.io/plantpulse-ai/install.sh \
  | sudo START=1 PP_DATALAKE_ADMIN_URL=https://192.168.0.41:4950 PP_DATALAKE_ADMIN_API_KEY=<플랫폼의 키> bash

若想逐一询问空缺的值，请以交互方式运行。

curl -fsSL https://product.kopens.io/plantpulse-ai/install.sh | sudo INTERACTIVE=1 bash
环境变量默认值用途
INTERACTIVE0为 1 时，会以提示方式询问空缺的值
START—为 1 时，安装后立即启动
DEST/opt/kopens/plantpulse-ai-docker安装位置
BRANCHmaster要获取的分支
REPO_HOST（内部 Git 主机）仅在无法获取发布版本时使用的备用路径。值已包含在安装脚本中
REPO_PATHplantpulse-ai/plantpulse-ai-docker.git代码仓库路径
GIT_USER · GIT_TOKEN—私有仓库认证

直接传递给安装脚本（install.sh）的值也放在同一位置。此处仅列出常用项 — 完整列表及各步骤的作用请参见安装概览。

环境变量默认值用途
PP_DATALAKE_ADMIN_URL · PP_DATALAKE_ADMIN_API_KEY—获取 Platform 凭证的地址（https://<플랫폼 호스트>:4950）及密钥。提供后不会再询问
PP_PROXY_CERT_SAN本主机地址写入 TLS 证书的访问地址/名称（可用逗号分隔多个）。若通过公网 IP、VIP 或域名访问，必须提供。env 文件中已有的值在重新安装后仍会保留
ENV_TEMPLATEenv.gb10.exampleAWS g7e（amd64）为 env.g7e.example。若机型与架构不符则会中止
HOST_TUNINGapply（若有其他容器在运行则为 plan）如何处理主机全局设置 skip · plan · apply
ALLOW_DOCKER_RECONFIGURE—为 1 时，允许修改并重启原有 Docker 的设置
SKIP_GPU—为 1 时，跳过 NVIDIA 驱动与 toolkit 的安装
SKIP_WAIT · WAIT_READY_MIN— · 15跳过 START=1 后的响应等待，或修改等待上限（分钟）
交互方式下会询问的值

为 INTERACTIVE=1 时，会先询问 TLS 证书 SAN，接着询问获取 Platform 凭证的地址和密钥 （PP_DATALAKE_ADMIN_URL · PP_DATALAKE_ADMIN_API_KEY）。此后，其余仍为占位符的值（Platform API 令牌、 管理员密码、Neo4j 密码等）会逐一继续询问。Platform 主机与 Platform PG、Aster TSDB、Redis 账号、 密码从 2026.10 起不再询问 — 主机地址由上方地址计算得出，账号与密码在启动时从 Platform 获取。内部密钥（网关密钥、盐值、入站密钥、会话密钥、 存储凭证加密密钥等）不会询问，由安装程序自动生成。

被询问的值也可以用同名环境变量传递，以代替交互方式（… | sudo PP_API_TOKEN=<token> PI_ADMIN_PASSWORD=<password> bash）。 安装程序只会填充仍为占位符的键，不会覆盖已有的值。

信任锚不由安装程序设置（2026.10）

Platform 信任锚 /etc/kopens/ca/root.crt（同一内容也以 CA.crt 形式存在）不由安装程序创建。为 START=1 时， 安装程序会在拉取镜像前先尝试从 Platform 获取一次凭证，若锚不存在或密钥错误，则不启动任何内容并中止。 请先放置锚再以 START=1 方式运行，或不加 START 仅完成准备后放置锚再启动 → 安装概览

安装完成后​

  1. 修改初始密码 — 设置管理控制台账号。 若 PI_ADMIN_PASSWORD 仍为占位符，则 START=1 启动会被拒绝；若为空， 控制台将完全无法启动。
  2. 访问 AI 管理控制台，在主页查看整体状态。
  3. 使用 服务端口映射 整理防火墙规则。
  4. 若要使用视频/音频采集及聊天中的语音提问功能，请在主机 env 中添加 PI_MEDIA_ENABLED=true 一行并获取语音识别模型 — 默认为关闭状态 → 视频·音频采集

相关文档​