Skip to content

登录与初始化 ​

没有默认账号 ​

平台不内置任何默认账号。服务端第一次启动时处于「未初始化」状态, 必须先通过 /user/setup 创建首个管理员账号才能使用。 两个页面会互相自动跳转,不需要手动记地址:

  • 打开 /user/login 时前端先查询初始化状态,未初始化则自动跳转 /user/setup;
  • 打开 /user/setup 时若已初始化,则自动跳回 /user/login,不允许重复 bootstrap。

完整的初始化流程与命令行方式见初始化与登录。

初始化向导(/user/setup) ​

向导分两步,使用分步表单:

  1. 创建管理员:填写用户名、密码、确认密码,提交后调用 bootstrap 接口。 成功后立即拿到登录 token,并自动触发一次环境自检。
  2. 环境自检:展示与 /doctor 页相同的自检面板(工具探测、目录可写等), 确认服务器工具链是否齐备。点击「进入平台」跳转到仪表盘。

字段校验规则:

字段规则
用户名必填;2-32 位,仅字母、数字、_、.、-
密码必填;至少 8 位
确认密码必填;须与密码一致

若第一步尚未完成就切到第二步,会提示「必须先创建管理员账号」并给出返回登录的按钮。 自检结果只是提示,不阻塞进入平台——缺的工具可以之后在环境自检页补装。

登录(/user/login) ​

  1. 输入用户名与密码,提交登录。
  2. 登录成功后 token 存入浏览器本地,随后跳转到登录前想访问的页面(无则进仪表盘)。
  3. 失败时错误信息以页面内 Alert 展示(如密码错误、账号被禁用、连续失败锁定等)。

登录页没有注册表单。系统设置里的「开放注册」开关作用于服务端注册接口, 开启后用户可通过 API / CLI 注册,Web 端登录页本身不提供注册入口。 角色与登录锁定的服务端行为见用户、角色与可见性。

首次改密(mustChangePassword) ​

管理员在用户管理里创建账号或重置密码后,该账号会被标记为「必须修改密码」:

  1. 使用该初始密码登录时,页面提示「首次登录请先修改密码」,并自动跳转到 /settings/profile。
  2. 个人设置页顶部出现黄色警告条,说明修改完成前部分功能会被限制。
  3. 在「修改密码」卡片填写当前密码与新密码(至少 8 位)并提交, 服务端清除强制改密标记,页面随即刷新当前用户状态。

修改密码的详细操作见系统设置的个人设置一节。

语言切换 ​

界面内置 zh-CN 与 en-US 两套文案,切换入口有两处:

  • 顶栏头像下拉菜单:菜单中显示「另一种语言」的名字,点击即切换;
  • 个人设置页(/settings/profile)的「界面语言」卡片:中文 / English 分段选择器。

切换后整页刷新,保证菜单名、antd 组件与页面文案一起切换,不会出现半中半英; 选择结果保存在浏览器 localStorage(umi_locale),下次打开仍沿用。 登录页与初始化向导没有语言切换入口,默认跟随浏览器 / 上次选择。

异常页(403 / 404 / 500) ​

路径含义常见触发场景
/exception/403无权限访问普通用户访问仅 admin 的功能(如用户管理)
/exception/404页面不存在访问了未定义的路由;项目 / 任务 Key 拼错时详情页也会报「不存在」
/exception/500服务端错误后端异常时的兜底展示

三个页面均为无侧边栏的独立结果页,提供「返回首页」按钮。 未匹配任何路由的地址统一渲染 404 页。日常接口错误(如删除被引用的凭据) 不会跳到异常页,而是以全局消息提示的形式出现。

相关页面 ​