document/content/self-host/upgrading/4-15/4151.mdx
社区版跳过。
v4.15.1 起,FastGPT 主应用访问 Pro/Admin 内部接口不再使用 rootkey,改为使用独立的服务间凭证 PRO_TOKEN。同时要求 FE_DOMAIN 变量必填,如果你部署了 Pro 版本,需要同时在 FastGPT 主应用和 Pro/Admin 服务中配置相同的 PRO_TOKEN:
PRO_TOKEN=your_pro_token_at_least_32_chars
FE_DOMAIN=fastgpt_domain
注意事项:
PRO_TOKEN 长度必须不少于 32 位,并且主应用与 Pro/Admin 必须保持一致。PRO_URL,则必须同时配置 PRO_TOKEN,否则服务会启动失败。PRO_TOKEN,否则内部接口鉴权会失败。rootkey 不再作为 FastGPT 主应用访问 Pro/Admin 内部接口的凭证,仅作为当前系统的管理员密钥,用于调用 /api/admin/** 接口,例如下方初始化脚本。PRO_TOKEN。Pro 部署请在私有部署环境变量中手动增加该配置。旧版本在企微终端会固定自动跳转登录,行为等同于 WECOM_LOGIN_AUTO_REDIRECT=true。v4.15.1 起,该行为默认关闭。如果需要保持旧版本的自动跳转行为,请在 FastGPT 主应用的环境变量中增加:
WECOM_LOGIN_AUTO_REDIRECT=true
如果不需要自动跳转,可以不配置该变量,或将其设置为 false。修改环境变量后请重启 FastGPT 主应用使配置生效。
为了兼容旧版 API 密钥,便于找到以前应用关联的密钥,v4.15.1 增加了全局 API Key 标签管理,并为历史应用级 API Key 增加 appName 展示快照。升级后建议执行一次初始化脚本,为已有 appId 的历史 API Key 自动回填应用名。
从任意终端,发起 1 个 HTTP 请求。其中 {{rootkey}} 替换成环境变量里的 rootkey;{{host}} 替换成 FastGPT 域名。
curl -X POST "{{host}}/api/admin/initv4151" \
-H "rootkey: {{rootkey}}"
脚本只会回填缺失的 appName,不会覆盖已有值,不会修改 appId,也不会创建或绑定标签。脚本可重复执行。
appName 展示快照,便于兼容旧版 API 密钥并查找以前应用关联的密钥。WECOM_LOGIN_AUTO_REDIRECT 环境变量,可控制企微终端是否自动跳转登录,默认关闭。