Nginx 是什么

这一课你将能做到

1. 用自己的话区分 Web 服务器、反向代理、正向代理，并指出 CodeRoadMap 公网入口属于哪一种
2. 画出「浏览器 → Nginx → Spring Boot / Next.js」的请求路径，标出本机端口 :443、:8080、:3000
3. 打开仓库 deploy/nginx/prod.conf.example，指出两条 upstream 与两条 location 各自服务谁

为什么要学

把 Spring Boot 与 Next.js 直接暴露在公网 8080/3000，会立刻撞上 TLS、端口混乱、CORS、多进程入口等问题。生产常见做法是：只让 Nginx 听 80/443，应用绑定本机回环地址，由 Nginx 按路径拆流量。
CodeRoadMap 正是这样：/api/* 进 Java，其余进 platform。本课不急着敲配置，先把「Nginx 在架构里干什么」钉死，后面安装、反代、SSL 才有坐标。
不懂边界时，人容易把 Nginx 当成「又一个应用框架」——其实它不管 JWT、不管 RSC，只管连接与转发。

先建立图像

浏览器
  │  HTTPS :443（公网只暴露这一层）
  ▼
Nginx（TLS 终止、按路径分流、安全头）
  ├─ location /api/  → upstream coderoadmap_backend  → 127.0.0.1:8080  Spring Boot
  └─ location /      → upstream coderoadmap_platform → 127.0.0.1:3000  Next.js
         │
         └─（业务）→ MySQL / Redis …

人话：Nginx 像小区门岗。访客只认大门地址；门岗看「去哪一栋」，再带你到内院的 Spring 或 Next。访客不必、也不该直接敲内院门牌。

角色	一句话	CodeRoadMap 里
Web 服务器	自己读磁盘或生成响应	admin 静态 root；主站较少直接当文件服务器
反向代理	代表服务端收请求，再转给内网	主站 / 与 /api/
正向代理	代表客户端访问外网	本 track 不展开（公司出口代理等）

正向代理：你 → 代理 → 外网网站（网站看见的是代理）
反向代理：你 → Nginx → 内网应用（你看见的是 Nginx 域名）

跟着做

步骤 1：对照官方定位

打开 nginx.org 英文欢迎页 / About，用中文写一句：「Nginx 是高性能 HTTP 与反向代理服务器，也可作邮件代理等。」
再补本课立场：本站主路径把它当公网入口与 TLS 边界，业务仍在 Spring / Next。
应看到：官方强调 HTTP、反向代理、负载均衡，而不是「替代应用框架」。

步骤 2：打开生产配置骨架

在仓库打开 deploy/nginx/prod.conf.example。从上到下找到：

1. upstream coderoadmap_platform → 127.0.0.1:3000
2. upstream coderoadmap_backend → 127.0.0.1:8080
3. listen 80 的 301 跳转块