跳到主要内容

修改初始密码(调试必做)

本文档说明在安装 AI 技术栈之后,整理人员登录画面账户的流程。 服务之间使用的密钥轮换,请参见修改密码 · API 密钥。

管理控制台账户​

AI 管理控制台 通过环境变量设定账户。 由于数据库中不存放用户,因此画面上没有修改密码的功能。

环境变量含义默认值
PI_ADMIN_USER登录 IDadmin
PI_ADMIN_PASSWORD登录密码无 — 安装时必须指定
PI_ADMIN_SESSION_SECRET会话签名密钥由安装程序生成(以 ppss_ 开头的随机值)
容器内部的名称不同

控制台容器(plantpulse-admin-api)以 ADMIN_AUTH_USERNAME、ADMIN_AUTH_PASSWORD、 ADMIN_SESSION_SECRET 这些名称接收该值。这是由 compose 转入的,因此运维人员需要修改的 是上表中 PI_* 这个名称。

这里没有默认密码

模板中的 PI_ADMIN_PASSWORD 是占位符(CHANGE_ME_…),安装程序不会生成此值 — 因为是人使用该值登录的。保持占位符原样时,START=1 启动会被拒绝;留空时 控制台会拒绝启动。也就是说,不可能出现"一直在用默认值"的情况。 安装时设定的值就是运行值,因此请在调试时检查一次该值是否只是临时设定的弱密码。

修改方法​

控制台账户不在 bin/passwd.sh 所管理的密钥列表中。 需要直接修改环境文件并重新创建容器。

sudo vi /etc/kopens/plantpulse-ai.env      # PI_ADMIN_PASSWORD 수정
cd /opt/kopens/plantpulse-ai-docker/bin
./up.sh                                    # 컨테이너 재생성
修改会话签名密钥会导致全体登出

PI_ADMIN_SESSION_SECRET 在安装时生成一次。修改该值会使此前的所有登录 全部失效。留空时 compose 会拒绝启动。

LiteLLM 管理画面账户​

这是人员进入模型网关(LiteLLM)管理画面 http://<AI 서버>:4000/ui 时使用的 账户(若已将端口改为 PI_LITELLM_PORT,则使用该端口)。不用于 API 调用(那边使用主密钥或虚拟密钥)。

环境变量含义默认值
PI_LITELLM_UI_USERNAME登录 IDadmin(模板中已被注释)
PI_LITELLM_UI_PASSWORD登录密码admin123!
此密码在所有安装中都相同 — 请在调试时修改

admin123! 是模板中写定的值,安装程序不会重新生成。4000 端口在 LAN 上是开放的, 若保持原样,同一网络中的任何人都可以进入网关管理画面。

请勿删除此行

PI_LITELLM_UI_PASSWORD 是必需的 — 若为空或不存在,compose 会拒绝启动。 LiteLLM 在没有该值时会将主密钥(PI_LLM_API_KEY)用作 UI 密码,为了防止 让人输入能开放整个 API 的密钥,因此单独设置了此项。

修改方法与控制台账户相同 — 由于不在 passwd.sh 列表中,需修改环境文件后用 ./up.sh 重新创建。

若将 2026.08 及以下版本安装的主机升级到 2026.09

此账户是在 2026.09 中新增的。由于安装程序不会重建已存在的环境文件,因此旧 文件中没有这一行。若直接升级, 会因缺少 PI_LITELLM_UI_PASSWORD 而报错并停止启动。请直接添加到 /etc/kopens/plantpulse-ai.env 中(值请设为新设定的密码)。

PI_LITELLM_UI_PASSWORD=<password>

基础设施账户与 API 密钥​

这是服务之间使用的凭证。bin/passwd.sh 持有目标列表。

cd /opt/kopens/plantpulse-ai-docker/bin

./passwd.sh --list          # 무엇을 바꿀 수 있는지 (현재값은 마스킹)
./passwd.sh --list --show   # 현재값 전체
./passwd.sh PI_INBOUND_API_KEY
./passwd.sh --generate PI_INBOUND_API_KEY   # 값을 직접 만들지 않고 도구가 만들게
密钥内容
PI_NEO4J_PASSWORDNeo4j — LightRAG 知识图谱与工厂图镜像,需同时修改两个实例
PI_RAG_API_KEYRAG API 密钥 — copliot-web · lightrag · rag-api 共用
PI_VLLM_API_KEYvLLM API 密钥 — lightrag · insight-api 共用
PI_LLM_API_KEYLiteLLM 主密钥
PI_LITELLM_SALT_KEYLiteLLM 盐值密钥 — 🔴 修改后将无法解开已注册的外部模型密钥。请勿轮换
PI_INBOUND_API_KEY后端入站密钥 — rag · insight · parser · vision · 数字线程接收(为空时这五者会拒绝启动),copilot · 管理控制台以相同值调用
有两个存储凭证加密密钥不在此列表中

PI_COPILOT_SECRET_KEY、PI_DT_SECRET_KEY 由安装程序在首次安装时生成,不是调试时需要修改的值 — 修改后将无法解开用该密钥加密的凭证。需要做的有两件事。

  1. 确认值是否存在。 若 PI_COPILOT_SECRET_KEY 为空,copilot 会拒绝启动。2026.09 及以下版本 升级的主机中根本没有这一行 → 环境变量设置
  2. 确保两个值都包含在 env 文件备份中。

如确实需要更换,请按照 _PREVIOUS 流程进行 → 修改密码 · API 密钥

入站密钥的"占位符"很危险

为空时,启动前判定会完全不启动整个技术栈,后端服务也会各自拒绝启动(自 2026.10 重新发布起 — 在此之前的服务是"没有密钥也放行")。但是 CHANGE_ME_… 占位符并非空值,因此会通过该 检查,并且该值在所有安装中都是相同的字符串。安装程序会将占位符替换为新值, 因此安装完成后请用 bin/doctor.sh 确认没有残留的占位符。轮换时请按 passwd.sh 先修改文件再重启的顺序进行。手动修改时也请遵循相同顺序。

有许多密钥由多个服务共用

PI_RAG_API_KEY、PI_VLLM_API_KEY、PI_INBOUND_API_KEY 的使用方不止一个。只修改一处的话, 其余服务会认证失败,因此请用 passwd.sh 修改后重启整个技术栈。

确认​

# 콘솔이 떴는가 — HTTP 5959 · HTTPS 5960 (2026.09 까지는 9080)
curl -sf http://127.0.0.1:5959/health && echo OK
curl -sfk https://127.0.0.1:5960/health && echo OK

请在浏览器中亲自确认使用旧密码无法登录。

本文档未涵盖的内容​

对象位置
后端入站密钥 · LLM 密钥 · Neo4j 等修改密码 · API 密钥
公开 API(/api/v1)机器认证密钥 CO_API_V1_KEY(至 2026.09 为 CH_API_V1_KEY)环境变量设置
AI Chat Web 用户账户遵循 Platform 用户体系 → Platform 用户管理
Platform · Edge · Studio 的初始账户各产品文档中的同名页面

相关文档​