主题
登录与初始化
没有默认账号
平台不内置任何默认账号。服务端第一次启动时处于「未初始化」状态, 必须先通过 /user/setup 创建首个管理员账号才能使用。 两个页面会互相自动跳转,不需要手动记地址:
- 打开
/user/login时前端先查询初始化状态,未初始化则自动跳转/user/setup; - 打开
/user/setup时若已初始化,则自动跳回/user/login,不允许重复 bootstrap。
完整的初始化流程与命令行方式见初始化与登录。
初始化向导(/user/setup)
向导分两步,使用分步表单:
- 创建管理员:填写用户名、密码、确认密码,提交后调用 bootstrap 接口。 成功后立即拿到登录 token,并自动触发一次环境自检。
- 环境自检:展示与
/doctor页相同的自检面板(工具探测、目录可写等), 确认服务器工具链是否齐备。点击「进入平台」跳转到仪表盘。
字段校验规则:
| 字段 | 规则 |
|---|---|
| 用户名 | 必填;2-32 位,仅字母、数字、_、.、- |
| 密码 | 必填;至少 8 位 |
| 确认密码 | 必填;须与密码一致 |
若第一步尚未完成就切到第二步,会提示「必须先创建管理员账号」并给出返回登录的按钮。 自检结果只是提示,不阻塞进入平台——缺的工具可以之后在环境自检页补装。
登录(/user/login)
- 输入用户名与密码,提交登录。
- 登录成功后 token 存入浏览器本地,随后跳转到登录前想访问的页面(无则进仪表盘)。
- 失败时错误信息以页面内 Alert 展示(如密码错误、账号被禁用、连续失败锁定等)。
登录页没有注册表单。系统设置里的「开放注册」开关作用于服务端注册接口, 开启后用户可通过 API / CLI 注册,Web 端登录页本身不提供注册入口。 角色与登录锁定的服务端行为见用户、角色与可见性。
首次改密(mustChangePassword)
管理员在用户管理里创建账号或重置密码后,该账号会被标记为「必须修改密码」:
- 使用该初始密码登录时,页面提示「首次登录请先修改密码」,并自动跳转到
/settings/profile。 - 个人设置页顶部出现黄色警告条,说明修改完成前部分功能会被限制。
- 在「修改密码」卡片填写当前密码与新密码(至少 8 位)并提交, 服务端清除强制改密标记,页面随即刷新当前用户状态。
修改密码的详细操作见系统设置的个人设置一节。
语言切换
界面内置 zh-CN 与 en-US 两套文案,切换入口有两处:
- 顶栏头像下拉菜单:菜单中显示「另一种语言」的名字,点击即切换;
- 个人设置页(
/settings/profile)的「界面语言」卡片:中文 / English 分段选择器。
切换后整页刷新,保证菜单名、antd 组件与页面文案一起切换,不会出现半中半英; 选择结果保存在浏览器 localStorage(umi_locale),下次打开仍沿用。 登录页与初始化向导没有语言切换入口,默认跟随浏览器 / 上次选择。
异常页(403 / 404 / 500)
| 路径 | 含义 | 常见触发场景 |
|---|---|---|
/exception/403 | 无权限访问 | 普通用户访问仅 admin 的功能(如用户管理) |
/exception/404 | 页面不存在 | 访问了未定义的路由;项目 / 任务 Key 拼错时详情页也会报「不存在」 |
/exception/500 | 服务端错误 | 后端异常时的兜底展示 |
三个页面均为无侧边栏的独立结果页,提供「返回首页」按钮。 未匹配任何路由的地址统一渲染 404 页。日常接口错误(如删除被引用的凭据) 不会跳到异常页,而是以全局消息提示的形式出现。