0001 前后端分离,Go 启动器一键运行
- 状态:已接受(2026-10-23)
- 相关:设计文档 04 §2.1、§9
背景
站长群体大量使用 Windows、宝塔、小内存 VPS,部署必须"一键";同时前端选定 Next.js(需要 Node 运行时),且第三方、插件需要一套干净的 API。
决策
- Go 后端与 Next.js 前端是两个独立程序,可分别部署与扩容。
- Go 二进制内置启动器
skinloom up:拉起并监管 Next.js 子进程(崩溃退避重启、日志合并、优雅退出、进程树终止),对外只暴露一个端口。 - Go 做唯一入口(网关):后端保留路径直接处理;
/_next/static/*与public/由 Go 从磁盘直接提供;其余页面反代到 Next.js。保留路径清单在internal/gateway,前端不得占用。 web.mode:managed(发行包)、dev(源码开发,运行前端开发服务器,包管理器见 ADR 0011)、external(容器/k8s 分离部署)、off(只要后端)。
备选方案
- 前端静态导出后嵌入 Go 二进制:失去 SSR。
- Next.js 做入口反代 Go:游戏协议这条最热路径多经过一次 Node。
影响
- 发行包需附带便携 Node(体积约 +35 MB 压缩后)。
- k8s 下可按路径直接分流,页面请求不经过 Go。