portal/docs/zh/deployment.md

部署

生产基线

• 运行拓扑: Caddy + Docker Compose
• 目标主机: 47.120.61.35
• 域名:
  • cn.svc.plus
  • cn.onwalk.net
• 前端独立发布流水线: .github/workflows/service_release_frontend-deploy.yml

运行方式

前端镜像在 GitHub Actions 中完成构建并推送到镜像仓库，目标主机只负责拉取镜像和启动容器，不在机器上本地构建。

当前方案尽量以静态模式运行：

• Caddy 直接服务 /_next/static/* 与 public/ 里的静态资源。
• Next.js standalone 容器只承接动态页面、认证接口和代理接口。
• knowledge/ 在 CI 阶段拉取，并在 Docker 打包时直接写入镜像。

这是针对当前单机弱 IO 环境的权衡。后续如果 docs.svc.plus 被拆成独立 API 服务，需要同步调整这里和 docs/usage/deployment.md 的镜像内容与路由职责。

相关文档

• usage/deployment.md
• governance/release-process.md
• development/dev-setup.md