初始化向导
初始化向导是首次启动时的 Web 配置界面，引导你完成项目初始化。
步骤
- 项目信息 — 设置项目名称，可选自定义 JWT 密钥
- 管理员账号 — 创建第一个管理员（用户名、邮箱、密码）
- 数据库 — 选择 SQLite / MySQL / PostgreSQL 并配置连接
- Redis — 可选启用 Redis 并配置地址
- 确认 — 检查配置并执行初始化
工作原理
- 首次启动时不存在
.installed锁文件 - 前端路由将所有请求重定向到
/onboard - 设置完成后，后端创建
.installed文件并写入config.yaml - 之后的访问将跳过向导
API 接口
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/onboard/status | 检查系统是否已初始化 |
| POST | /api/onboard/setup | 提交配置 |
.installed 文件存在后，setup 接口会返回 403。