主题
环境自检与中间件面板
页面定位与权限
/doctor 是独立菜单页,回答「这台服务器现在什么样、缺什么」。 页面自上而下由三个面板组成:环境自检、工具链一键安装、中间件。 没有独立的 middleware 路由,中间件操作全部内嵌在本页。
- 查看自检结果与组件清单:任何登录用户。
- 工具链安装、参数修改,中间件安装 / 启停 / 卸载:仅 admin。
- 安装脚本面向 bash / Linux;非 Linux 平台显示「仅支持 Linux 安装」警告, 但仍可查看清单与预演(dry-run)。
环境自检面板
数据来自 GET /api/v1/system/doctor,点「重新检测」即时刷新。
服务器概要:操作系统 / 架构、主机名、服务端版本、Go 版本、 默认 Shell(及可用 Shell 列表)、工作区根目录与数据目录(各带可写 / 只读标签)。
工具探测表:逐项探测 14 个常用工具,给出版本、路径与安装提示:
| 分类 | 工具 |
|---|---|
| 基础 | git、bash、sh、rsync、curl |
| 容器与站点 | docker、nginx、certbot |
| 前端 | node、npm、pnpm |
| 后端 | go、java、mvn |
探测使用与脚本执行一致的登录 Shell 环境(读取 /etc/profile), 避免「自检说没有、构建却跑得通」的矛盾。缺失项汇总为警告条并附安装建议; 全部就绪则显示绿色提示。
接口还返回 web.built 字段,标记二进制是否内嵌了真正构建过的前端; 未构建时服务端只提供一个占位提示页(此时也看不到本界面), 需要在 deploy-server-ui 执行 pnpm build 后重新构建服务端。自检面板不单独展示该项。
工具链一键安装面板
组件包括 cc(编译工具)、java、maven、nvm、node、pnpm、go、rust、certbot, 每行显示安装状态、版本 / 位置、自定义参数与说明。
安装流程:
- 勾选组件(默认自动勾选所有缺失项),或直接用「安装缺失」按钮。
- 点「安装选中」,确认弹窗中选择安装源:官方源或国内镜像, 并逐组件显示预计耗时与相关提示。
- 确认后服务端把内嵌脚本落盘,作为普通运行执行(内置项目
system-toolchain), 页面自动跳转到运行详情看实时日志。 - 回到本页可在「安装历史」中查看最近 8 次安装运行(时间、组件、参数、状态、日志入口)。
其他能力:
- 预演(dry-run):只打印将执行的动作,不改动系统;普通用户也可执行。
- 参数编辑(仅 admin):每个组件的版本、下载地址、安装目录等字段由后端下发, 留空用默认值;保存后可单独「重装」该组件使参数生效。
- 下载脚本:把安装脚本保存为
install-toolchains.sh,可脱离平台手动执行。
中间件面板
PostgreSQL、MySQL、Redis 等长期驻留服务的管理入口。 顶部显示当前平台与 Docker 可用性(版本或「不可用」);没有 Docker 时提示可改用 native 方式。 组件清单见组件与模式。
每行显示:名称 / 分类、说明、安装方式(docker 容器 / native 原生,及当前实际生效方式)、 安装与运行状态、版本、位置。
安装 / 预演流程:
- 勾选组件(默认勾选缺失项),点「安装缺失」「安装选中」或「预演」。
- 弹窗中选择安装方式:docker 或 native。可选方式取所选组件支持方式的并集, 组件不支持所选方式时由后端报错(预演可提前发现)。
- 确认后同样作为普通运行执行并跳转日志页;预演只打印计划动作。
- 安装不传 force:已安装则跳过 / 按需重建,避免误覆盖数据目录。
启停与卸载流程(均仅 admin,逐项二次确认,确认框列出全部选中组件名):
- 勾选目标组件。
- 点「启动」「停止」「重启」或红色的「移除」。
- 确认弹窗说明动作后果——移除会删除容器或卸载本机安装,属危险操作。
- 确认后作为普通运行执行,跳转日志页查看结果。
参数编辑(仅 admin):端口、密码、数据目录等字段由后端下发,留空用默认; 改完通过「重装」或「重启」生效。也可「下载脚本」保存 install-middlewares.sh。
所有中间件操作都记录为内置项目(默认 system-toolchain)的运行, 可在运行列表按该 Key 过滤查看完整历史。