Skip to content

运维面板:设计架构 ​

更新时间:2026/11/17 11:11:35

运维面板是「一台机器上的部署与运维控制台」:你在浏览器里操作,它落到宿主机上执行 Docker 与文件操作。这一页说明它的组件边界、状态存在哪、以及几条与可靠性有关的设计选择。

管理面与被管面 ​

层是什么关键点
面板进程Go 单二进制,前端 go:embed 内嵌面板自己不跑容器,只编排宿主机的 Docker
基础环境栈PostgreSQL、Redis、Artemis随机强密码生成,一键改密并同步到消费方
业务系统栈主应用、通道子应用、运营端 / 商户端 / H5镜像构建与单服务部署都在这一栈
网关栈独立 nginx源站恒 80,HTTPS 由外层 CDN / 网关终结后回源
状态文件installer-state.json(0644,原子写).env 与 compose 都由它渲染,不再各存一份真相

三套编排栈的边界 ​

三栈分开而不是一个大 compose,原因是生命周期不同:基础环境随机器长期存在,业务系统每次发版都会重建,网关只在域名或证书变化时调整。拆开之后,重建业务容器不会动到数据库卷,改网关也不会重启业务。

栈之间的连接靠 Docker 网络与容器名(业务栈访问 postgresql / redis / artemis,网关 upstream 指向 backend:9999),因此服务名不要随意改。

状态与漂移 ​

面板只认一个状态真相源:工作目录下的 installer-state.json。

  • 保存配置只改状态文件,不会立即生效;
  • 部署时由状态渲染 .env 与 docker-compose.yml,再执行 pull / up;
  • 配置改了但没重新部署时,页面按「漂移」标记提示,并给出「重新部署」或「应用配置」两个动作;
  • 容器在跑但快照缺失时,启动会按当前状态自动补齐快照,避免面板显示与实际脱节。

这个设计换来的是「面板重启不丢配置」,代价是配置与运行态可能短暂不一致——看到漂移提示不要忽略。

任务与日志 ​

安装 Docker、拉源码、构建镜像、部署服务都是长任务,统一走异步任务模型:

  • 任务在服务端单并发执行,状态持久化,刷新页面可恢复;
  • 进度通过 SSE 实时回显,同时写入面板自身日志(按大小滚动);
  • 任务可取消,历史有数量上限,避免无限增长。

容器日志另走 docker logs 尾部读取,前端轮询展示,与任务日志分开。

为什么是单二进制 ​

  • 部署对象本身就是一台裸机,面板不能依赖宿主机的 Node、Java 或数据库;
  • 前端产物内嵌后,升级只需要替换一个文件(面板自升级也是这个路径);
  • 面板不参与业务流量,挂了不影响支付;此时用 TUI 与命令行仍可恢复访问与账号。

设计约束 ​

约束原因
需要 root / sudo,可选 systemd 常驻要操作 Docker、写 /opt/daxpay、改系统服务
源站只监听 80,不直接做 HTTPS证书与 CDN 在客户侧形态各异,交给外层终结更稳
密码留空 = 随机生成并回写,API 只回「是否已设置」避免密码在页面与日志里回显
写操作全部进审计(SQLite)部署与改密的操作要可追溯
不代改业务配置业务运行参数由主应用的配置管理,面板只做注入与重启