修改与重置 root 密码

FastGPT 的系统管理员默认用户名为 root。从 v4.17.3 版本开始，FastGPT 引入了账号激活机制与内置的密码重置命令行工具，移除了以往每次重启容器通过 DEFAULT_ROOT_PSW 环境变量重写密码的旧逻辑，从而提升管理员账号的安全性。

本文将介绍不同场景下如何修改或重置 root 管理员密码。

场景一：首次部署登录与激活

在 v4.17.3 及更高版本中，新创建的 FastGPT 实例默认初始密码固定为 123456，账号初始处于待激活状态（inactive）。

1. 打开 FastGPT Web 访问地址。
2. 使用系统管理员账号登录：
   • 用户名：root
   • 初始密码：123456
3. 登录成功后，页面会自动弹出不可关闭的「激活账号」窗口，强制要求设置新密码。
4. 输入并确认您的新密码后提交完成激活。设置成功后系统进入正常使用状态，请妥善保管好您的新密码。

场景二：在 Web 界面日常修改密码

如果您已知当前密码并处于正常登录状态，可直接在平台界面中修改密码：

1. 以 root 身份登录 FastGPT 平台。
2. 点击页面右上角的用户头像，进入「个人信息」/「账号信息」页面。
3. 在安全设置区域找到「修改密码」，点击进入修改弹窗。
4. 输入当前密码（旧密码）和新密码，确认无误后点击保存。
5. 密码修改成功后立即生效。

场景三：忘记密码时通过 CLI 重置密码

如果您遗忘了 root 密码无法登录 Web 界面，可以直接在 FastGPT 容器内运行内置的密码重置脚本。

该操作会连接 MongoDB 并直接更新管理员密码，无需重启服务容器，且不会影响系统中已运行的其他任务。

1. Docker Compose 部署环境

进入服务器上存放 docker-compose.yml 的部署目录，执行以下命令：

docker compose exec fastgpt-app node /app/scripts/reset-root-password.cjs '你的新密码'

若使用的是旧版本 Docker Compose（独立二进制），请将 docker compose 替换为 docker-compose：

docker-compose exec fastgpt-app node /app/scripts/reset-root-password.cjs '你的新密码'

2. Docker 单容器独立运行环境

如果使用 docker run 单独启动容器，可通过容器名或容器 ID 执行重置：

docker exec -it <容器名称或ID> node /app/scripts/reset-root-password.cjs '你的新密码'

3. Kubernetes / Helm 部署环境

在 Kubernetes 集群中，可以通过 kubectl exec 在 FastGPT Pod 中执行重置：

kubectl exec -it <fastgpt-pod-name> -n <namespace> -- node /app/scripts/reset-root-password.cjs '你的新密码'

执行结果验证

执行成功后，终端将输出：

root 密码已重置

重置完成后，旧的登录会话将无法继续使用，您可以立即在 Web 界面中使用新密码重新登录。

场景四：历史版本（v4.17.2 及更早）修改方式

对于 v4.17.2 及更早的历史版本，系统尚未内置密码重置 CLI 脚本，root 密码由环境变量控制：

1. 打开部署目录下的 docker-compose.yml 文件。
2. 找到 DEFAULT_ROOT_PSW 环境变量（或 x-default-root-psw YAML 锚点），修改其对应的值为新密码。
3. 重启 FastGPT 服务使配置生效：

   docker compose down
   docker compose up -d

4. 容器启动时会自动将数据库中的 root 密码更新为环境变量中设置的新密码。