简体中文
运维面板:设计架构
运维面板是「一台机器上的部署与运维控制台」:你在浏览器里操作,它落到宿主机上执行 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) | 部署与改密的操作要可追溯 |
| 不代改业务配置 | 业务运行参数由主应用的配置管理,面板只做注入与重启 |