跳到主要内容

重置管理员密码

1 适用场景​

管理员密码遗忘、泄露，或因长时间未登录被锁定且无法通过其他管理员重置时，可以在部署网关的服务器上通过命令行重置管理员密码。

版本要求：reset-admin-password 命令自 v1.0.1 版本起提供，请将网关升级至 v1.0.1 或更高版本后再执行本文操作。

2 重置步骤​

  1. 登录部署 1Panel AI 网关的服务器。

  2. 在服务器上执行重置命令（容器名以默认的 1panel-ai-gateway 为例）：

docker exec -it 1panel-ai-gateway /usr/bin/ai-gateway reset-admin-password

  1. 按终端提示依次输入新密码并确认。密码长度为 6 至 128 个字符，输入时不会显示字符，属正常现象。

  2. 终端输出 administrator password reset 即表示重置成功，使用管理员用户名 admin 与新密码登录管理端。

安全提示

重置后的密码请立即妥善保管；若网关部署在公网可访问环境中，建议同时检查登录失败锁定与访问控制策略，避免管理员账号被暴力尝试。

3 补充说明​

  • 该命令仅重置管理员账号的密码，不会影响用户、API Key、账号池等其他配置数据。
  • 若初次部署时未指定管理员密码，也可以不改密，直接在启动日志中查找一次性临时密码：
docker logs 1panel-ai-gateway 2>&1 | grep "initial administrator created"
  • 通过环境变量 AI_GATEWAY_INITIAL_ADMIN_PASSWORD 显式传入的初始密码不会写入日志。
  • 数据库中的密码始终以 Argon2id 强哈希保存，重置密码会覆盖原有密码哈希，原密码立即失效。