Skip to content

初始化设置

全新部署、数据库里还没有任何账户时,平台进入初始化设置流程,用于创建第一位管理员。

流程

  1. 启动服务后访问站点首页;
  2. 网站检查是否需要初始化;
  3. 若未进行初始化,进入设置向导页面;
  4. 填写并提交:
    • 站点名称
    • 用户名
    • 邮箱
    • 密码
  5. 提交后调用创建首位管理员账户并直接到达仪表盘。

行为与约束

  • 该流程只能成功执行一次。初始化完成后无法再次返回;
  • 站点名称会写入系统设置,之后可在 站点设置 修改;
  • 创建的账户自动具备管理员权限。

与引导管理员的关系

除了初始化向导,你也可以通过环境变量在登录时自动提升管理员:

ini
BOOTSTRAP_ADMIN_EMAILS=admin@example.com,ops@example.com
BOOTSTRAP_ADMIN_OIDC_SUBS=oidc-subject-1,oidc-subject-2

命中其中任一邮箱(不区分大小写)或 OIDC subject(区分大小写)的用户,登录后会被自动设为管理员。这在你想用 OIDC 直接登录而不走密码初始化时很有用。

基于 MIT 协议发布(社区版)