主题
Web 界面
本章导读
deploy-server-ui 是 deploy 平台自带的 Web 管理界面:初始化向导、项目与任务管理、 运行日志实时终端、环境自检与中间件安装、系统设置都在这里完成。 技术栈为 React 18 + UmiJS Max 4 + Ant Design 5(日志终端基于 xterm.js), pnpm build(max build)产出的 dist 由 deploy-server 通过 go:embed 内嵌进单二进制, 浏览器访问服务端地址即可使用,无需单独部署前端。
界面支持简体中文与英文(zh-CN / en-US),切换入口见登录与初始化。 权限模型只有 admin / user 两种角色,详见用户、角色与可见性。
路由总览
| 路径 | 页面 | 权限 |
|---|---|---|
/user/login | 登录 | 未登录可访问;未初始化时自动跳转 setup |
/user/setup | 初始化向导(创建首个管理员) | 仅未初始化时可用 |
/ | 仪表盘(运行统计、最近运行、快捷执行) | 登录用户 |
/server-info | 服务器资源(CPU / 内存 / 磁盘) | 登录用户 |
/projects | 项目列表 | 登录用户,可见范围受 visibility 影响 |
/projects/new | 新建项目 | 登录用户 |
/projects/:key/edit | 编辑项目 | 归属者或 admin |
/projects/:key | 项目详情(运行、Hook Token、历史) | 读按可见性;操作需归属者或 admin |
/tasks、/tasks/new、/tasks/:key/edit、/tasks/:key | 任务四路由,与项目同构 | 同项目 |
/runs | 运行列表 | 登录用户 |
/runs/:id | 运行详情与日志终端 | 登录用户 |
/doctor | 环境自检 + 工具链安装 + 中间件面板 | 查看:登录用户;安装与启停:仅 admin |
/settings | 重定向到 /settings/profile | 登录用户 |
/settings/profile | 个人设置(改密、语言、API Token) | 登录用户 |
/settings/users | 用户管理 | 仅 admin |
/settings/credentials | Git 凭据与服务器 SSH 公钥 | 登录用户;生成 SSH 密钥仅 admin |
/settings/system | 系统设置 | 查看:登录用户;修改:仅 admin |
/exception/403、/exception/404、/exception/500 | 异常页 | 无布局独立页 |
注意:new 是项目 / 任务 Key 的保留字(静态路由优先于 :key); 没有独立的 middleware / hooks 路由——中间件面板内嵌在 /doctor, Hook Token 管理内嵌在项目 / 任务详情页。
页面目录
| 页面 | 内容 |
|---|---|
| 01 登录与初始化 | 首管理员向导、登录、首次改密、语言切换、异常页 |
| 02 项目与任务管理 | 列表操作、编辑页卡片字段、详情页、Hook Token、归档与删除 |
| 03 运行详情与日志终端 | xterm 终端、实时跟随与断线续传、取消、下载、运行列表过滤 |
| 04 环境自检与中间件面板 | 自检项、工具链一键安装、中间件安装 / 预演 / 启停 / 卸载 |
| 05 系统设置 | system / users / credentials / profile 四个 tab 逐项说明 |