Web 安装向导

用途与访问路径

首次启动且 app.installed=false 时访问 /install/，依次完成数据库与 Redis、管理员账号、安装完成三个步骤。正式安装仅支持 MySQL 和 PostgreSQL。

前置条件

• 已创建空数据库并准备具备建表、建索引权限的账号。
• Redis 可访问且选定 DB 不与其他环境混用。
• 管理员用户名、邮箱与强密码已经确认。

第一步：数据库与 Redis

选择数据库类型，填写主机、端口、数据库名和账号后测试连接；再填写 Redis 主机、端口、密码和 DB。测试通过才继续。SQLite 不出现在正式选项中。

第二步：管理员

填写用户名、姓名、唯一邮箱与密码。密码会使用 bcrypt 哈希保存，邮箱会规范化为小写。

第三步：完成

安装器执行当前数据库方言的全部 goose 迁移、创建初始管理员并写入已安装状态，然后提供后台入口。

注意事项

• 安装页面只应在可信网络中开放；完成后确认 /install/ 不再允许重复初始化。
• 不要把数据库、Redis、JWT 或 OIDC 密钥提交到仓库。
• 迁移由服务启动阶段自动执行，不需要额外运行独立迁移命令。

相关页面：登录管理后台 · Docker 与 Compose