综合练习

这一课你将能做到

1. 在测试机按 deploy/nginx/test.conf.example 落地配置，完成 nginx -t → reload，并把域名指到本机
2. 联调 Spring Boot :8080 与 Next :3000，用验收表验证 301、页面、/api、安全头、上传体积
3. 根据 502/404/重定向循环/WebSocket 症状定位问题，并写清「为何不把 8080/3000 直接暴露公网」

为什么要学

前面每一课拆开讲：结构、静态、反代、双 upstream、TLS、安全头、缓存、均衡、Ingress。
本课把它们 串成一次可演示的预发拓扑，对照 CodeRoadMap 生产思路做 smoke test。
能独立完成联调与排错，才算本 track 闭环；否则配置知识停留在「看过示例」。

先建立图像

验收目标拓扑（test）

浏览器 → http://test…  ─301→ https://test…
              │
         Nginx:443
          ├─ /api/* → 127.0.0.1:8080  Spring Boot
          └─ /      → 127.0.0.1:3000  Next.js

清单：跳转 ✓ 页面 ✓ JSON API ✓ 安全头 ✓ 上传不 413 ✓

阶段	你要完成的事
前置	后端、前端进程健康
部署	test conf 进 conf.d，证书/域名就绪
验收	表格五类检查
排错	对照速查表与日志
反思	公网暴露面与扩展项

跟着做

步骤 1：启动后端与前端

# 终端 1 — backend
cd backend && ./mvnw spring-boot:run    # 监听 :8080

# 终端 2 — platform
cd platform && npm run dev              # 监听 :3000

直连验收：

curl -sS -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8080/tracks
curl -sS -o /dev/null -w "%{http_code}\n" http://127.0.0.1:3000/

两者都应是健康状态码（按你环境可能是 200）。上游挂着再开 Nginx，否则必 502。

步骤 2：部署 test 配置

sudo cp deploy/nginx/test.conf.example /etc/nginx/conf.d/coderoadmap-test.conf

编辑：

• server_name 与 DNS/hosts 一致（如 test.coderoadmap.cn）
• 取消注释并填写 ssl_certificate / ssl_certificate_key
• 确认 upstream 仍指向本机 3000/8080（Docker 则改服务名）

sudo nginx -t
sudo systemctl reload nginx

hosts 示例：127.0.0.1 test.coderoadmap.cn。Compose 路线见 docker-compose。