配置文件结构

这一课你将能做到

1. 说出 main → events / http → server → location 的层级，并指出指令大致写在哪一层
2. 对照 deploy/nginx/prod.conf.example，标出 upstream、80 跳转、443 主站、admin 静态各自属于什么块
3. 用「最长前缀 / 修饰符」解释为何 /api/ 会压过 /，并写一条 location = /nginx-health

为什么要学

Nginx 不是「一堆平铺 key=value」。块的嵌套决定继承与作用域；location 匹配顺序决定流量进 Spring 还是 Next。
读不懂结构时，人会把指令贴错层（例如在 location 里写只能放 http 的东西），或改错 server 导致只影响了一个域名。
本课把树状结构与匹配规则讲透，后面静态、反代、SSL 都是在这棵树上挂叶子。

先建立图像

main（全局：user、worker_processes 等）
├── events { worker_connections … }
└── http {
        # 共享：mime、gzip、upstream、log 格式…
        upstream coderoadmap_backend  { server 127.0.0.1:8080; … }
        upstream coderoadmap_platform { server 127.0.0.1:3000; … }

        server { listen 80;  … }           # 跳转到 HTTPS
        server { listen 443; server_name www…; location … }
        server { listen 443; server_name admin…; root … }
    }

人话：http 是整栋商业楼的物业规章；每个 server 是一间按域名区分的铺面；location 是铺面里「哪条走廊通向哪扇门」。

层级	典型内容
main	进程用户、worker 数
events	连接数等事件模型参数
http	上游、压缩、日志、多个 server
server	listen、server_name、SSL、该站 location
location	root / proxy_pass / 精确健康检查

跟着做

步骤 1：读官方「配置文件」概念

打开 Directory structure / Configuring nginx 中配置相关段落，记下：配置由指令组成，许多指令放在上下文（块）里。
用中文写：「指令必须出现在允许的上下文，否则 -t 报错。」

步骤 2：在笔记复述 prod 骨架

打开 deploy/nginx/prod.conf.example，按出现顺序编号：

1. 两个 upstream（在 http 级，与 server 平级）
2. listen 80 → 301 到 www HTTPS
3. listen 443 + → 301 到 www