跳到主要内容

密码 · API 密钥更改

Studio 使用的数据库账户和 AI 密钥在所有安装中的初始值都是相同的。在调试时更改一次， 然后就不需要再动了。

更改工具只有一个：bin/passwd.sh。platform · ai · studio 三个产品都拥有相同的名称， 相同的用法。

设置正本是 /etc/kopens/plantpulse-studio.env 这一个

该产品的秘密在于 /etc/kopens/plantpulse-studio.env 中。它不是位于安装目录（/opt/kopens/plantpulse-studio-docker）内，而是 在 repo 树之外，权限为 0600。

安装目录根目录下的 .env 是旧路径。现已无人读取——即使在这里修改， 栈也不会改变。

在 2026-08-16 之前，passwd.sh 写入 /etc/kopens/plantpulse-studio.env，而 compose 和其余脚本则读取 repo 根目录下的 .env。因此，轮换静默地 无效，passwd.sh 声称成功，但栈仍在使用旧值继续运行 （PS_ANTHROPIC_API_KEY · PI_LLM_API_KEY 当时就是那种状态）。请勿再次写入旧路径。

应用登录账户不在这个范围内​

不要把两者混淆。

是什么在哪里更改
应用登录账户人员登录 Studio 的账户应用内的 环境设置 → 用户管理
AI 密钥Anthropic · OpenAI 兼容网关密钥本文档 — bin/passwd.sh
不要尝试用 .env 更改应用账户——这会成为死值

Studio 服务器在登录时会按 ①DB → ②环境变量 的顺序查看。如果数据库中存在该账户，就会在那里 结束，因此之后修改 env 中的 STUDIO_LOCAL_USERS 不会产生任何效果。

应用账户应在 环境设置 → 用户管理 中创建、分配角色、重置密码。 详细内容请参阅 环境设置（管理员） 的用户管理章节。 来源为 환경변수 的账户无法在界面中修改或删除。

引导账户（STUDIO_LOCAL_USERS）是用于首次进入的临时手段。当运营账户准备就绪后， 请清空它并重新启动。

可以更改什么​

首先查看列表。即使不带任何参数运行，结果也相同。

cd /opt/kopens/plantpulse-studio-docker
bin/passwd.sh --list

会显示密钥 · ID · 当前值（仅前 3 个字符） · 目标 · 该值所在位置。 如果需要查看完整值，请使用 --list --show。

密钥是什么如何更改
PS_ANTHROPIC_API_KEYAnthropic API 密钥文件 — agent-server 启动时加载
PI_LLM_API_KEYOpenAI 兼容网关密钥文件 — agent-server 启动时加载

只有这两个。 密钥名称与 .env 中的变量名完全相同，无需像 anthropic 这样的 别名——因为如果设置别名，就需要单独维护一张连接名称与变量的表，而这张表必定会与实际 不符。

数据库密码不能在这里更改

🔴 没有名为 PG_PASSWORD 的密钥。 Studio 仅使用外部 PostgreSQL （捆绑容器已于 2026-08-28 移除），连接信息包含在 .env 的 DATABASE_URL 一行 中。该账户的正本在 PG 内部，所以先在数据库端更改，然后 调整 DATABASE_URL，最后执行 bin/restart.sh。

平台的 PP_* 也不在这里。如果传递它，将像拼写错误一样被拒绝。

与容器内的名称不同

在日志或源代码中显示为 ANTHROPIC_API_KEY · AI_API_KEY。.env 和 passwd.sh 中使用的名称是上述两个 → 环境变量参考

更改​

推荐采用省略值并通过提示符输入的方式。 这样密码不会出现在 ps 输出或 shell 历史中。会要求输入两次以确认一致性。

bin/passwd.sh PI_LLM_API_KEY

也可以直接传递值作为参数。

bin/passwd.sh PS_ANTHROPIC_API_KEY=<new-value>

一次性传多个值可将重启合并为一次。 在调试时请使用此形式。

bin/passwd.sh PI_LLM_API_KEY=<new-value> PS_ANTHROPIC_API_KEY=<new-value>

如果只想看哪些会更改而不做任何操作，请使用 --dry-run。

bin/passwd.sh --dry-run PI_LLM_API_KEY=<new-value>

执行时，会先显示要更改的项目和影响，然后通过 [y/N] 确认。在自动化流程中 若需跳过确认，请使用 --yes。

在非交互模式下不能省略值

在脚本 · cron 等没有终端的环境中，如果省略值，将无法显示提示符，导致错误 结束。此时请以 KEY=<value> 形式传递。

执行后会发生什么​

顺序已固定。

顺序操作
1将 /etc/kopens/plantpulse-studio.env 更新为新值（保持权限 0600）
2docker compose up -d --wait — 重新创建容器以加载新值

两个密钥均以文件为正本。这并非需要同时更改外部服务账户的类型， 只需修改文件并重新加载即可。

在此期间 Studio 连接会中断。 请在维护窗口内执行。

中途失败时​

在何处状态待办事项
第 2 步（重启）文件已为新值通过 bin/status.sh 检查状态并处理启动失败原因
不要将值留空

PI_LLM_API_KEY 为空时，栈将拒绝启动。 更改时务必填入新值，并通过 --list 确认已加载。

确认​

bin/passwd.sh --list

如果当前值的前 3 个字符已更改，则表示已生效。保留前 3 个字符是为了让你一眼看出默认值是否仍然存在。

相关文档​