Next.js + Go 全栈部署清单

架构：浏览器 → 反向代理 → [ Next.js (前端) + Go API (后端) ] → 数据库

一、完整组件清单

• 前端应用 — Next.js（需先确认渲染模式，见下方选型）
• 后端应用 — Go + Gin + GORM，编译为二进制或 Docker 镜像
• 数据库 — PostgreSQL，与后端同内网
• 服务器 — 云服务器（ECS / 轻量应用服务器），Ubuntu 22.04 LTS
• 反向代理 — Nginx / Caddy：同域名下分发 / → Next.js、/api → Go
• 域名 + HTTPS — 解析到服务器 IP，Let's Encrypt 证书（Caddy 自动搞定）
• ICP 备案 — ⚠️ 国内大陆服务器绑定域名必须备案（约 1–22 工作日），海外/香港地域可免
• 进程守护 — 见选型表，二选一
• 环境变量 — Next.js 的 NEXT_PUBLIC_* 与 Go 的 .env 分开管理，均不入仓库
• CORS 跨域 — ⚠️ 推荐方案：反向代理把前后端挂同一域名，直接规避 CORS；分域名部署才需要 Go 侧配 gin-contrib/cors
• 安全组 — 开放 80/443（“部署完访问不了”头号原因）

二、Next.js 部署模式选型（关键决策）

⭐ 国内服务器自托管，推荐 Standalone 模式：next.config.js 加 output: 'standalone'，Docker 多阶段构建，镜像小、启动快。

三、技术选型

四、部署流程（8 步）

1. 环境准备 — 服务器装 Docker + Compose + Git；同步启动 ICP 备案（周期最长，先办）
2. 前端打包 — next.config.js 开 output: 'standalone' → 写 Next 的 Dockerfile
3. 后端打包 — Go 多阶段构建 Dockerfile
4. 配置分离 — 两个 .env（前端 NEXT_PUBLIC_API_URL、后端数据库连接串），均加入 .gitignore
5. 数据库部署 — Docker 起 PostgreSQL 容器（生产换 RDS）
6. 一键启动 — docker-compose.yml 编排 3 个服务：web(next) + api(go) + db(postgres)，docker-compose up -d
7. 代理与 HTTPS — Nginx/Caddy 同域名分发：/ → Next，/api → Go（同域名 = 无需 CORS）
8. 联调收尾 — 安全组放行 → 检查前端 API 地址（生产环境指向同域名 /api）→ 验证 HTTPS

五、docker-compose 结构速览

services:
  web:   # Next.js standalone
    build: ./frontend
    restart: unless-stopped
  api:   # Go + Gin
    build: ./backend
    restart: unless-stopped
    environment: ← .env 注入
  db:    # PostgreSQL
    image: postgres:16
    volumes: [pgdata:/var/lib/postgresql/data]
    restart: unless-stopped

六、新手路径建议

阶段一：Next 静态导出 + Go 二进制，Nginx 托管跑通    ← 最短路径
阶段二：双端 Docker 化 + docker-compose 编排         ← 标准化
阶段三：HTTPS / 备案 / 数据库迁移 RDS / 备份监控      ← 生产化

记忆口诀：前端 Next、后端 Go、同域代理、容器编排 → 备案 → 加固