初始化设置
全新部署、数据库里还没有任何账户时,平台进入初始化设置流程,用于创建第一位管理员。
流程
- 启动服务后访问站点首页;
- 网站检查是否需要初始化;
- 若未进行初始化,进入设置向导页面;
- 填写并提交:
- 站点名称
- 用户名
- 邮箱
- 密码
- 提交后调用创建首位管理员账户并直接到达仪表盘。
行为与约束
- 该流程只能成功执行一次。初始化完成后无法再次返回;
- 站点名称会写入系统设置,之后可在 站点设置 修改;
- 创建的账户自动具备管理员权限。
与引导管理员的关系
除了初始化向导,你也可以通过环境变量在登录时自动提升管理员:
ini
BOOTSTRAP_ADMIN_EMAILS=admin@example.com,ops@example.com
BOOTSTRAP_ADMIN_OIDC_SUBS=oidc-subject-1,oidc-subject-2命中其中任一邮箱(不区分大小写)或 OIDC subject(区分大小写)的用户,登录后会被自动设为管理员。这在你想用 OIDC 直接登录而不走密码初始化时很有用。