Skip to content

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/credentialsGit 凭据与服务器 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 逐项说明

阅读路径建议 ​

  • 第一次接触平台:先按初始化与登录完成 setup,再读 01。
  • 要部署一个应用:读 02 建项目(字段含义见项目定义), 执行后到 03 看日志。
  • 服务器缺工具或缺数据库:读 04,组件清单见组件与模式。
  • 多人共用一台服务器:读 05 配好可见性与注册开关,加固建议见安全加固。