Nginx 是什么：核心定位、使用场景与配置详解

四、和'网关'的关系

是的，你提到的'网关、负载均衡'就是 Nginx 在现代架构中非常典型的用途。

简单理解：

所以：Nginx 是一种应用层反向代理 + 负载均衡器，如果加上 Lua 或 Nginx Plus 模块，它也能做轻量级 API Gateway。

五、总结

Nginx 是一个高性能的 Web 服务器 + 反向代理 + 负载均衡器，常被用作系统对外访问的'入口网关'。

六、Nginx 工作原理示意图

下面是一张文字版的Nginx 工作原理示意图，用简单的 ASCII 图来展示它在系统中的位置和作用：

┌──────────────────────────┐
│ 用户浏览器               │
│ (User / Client Request)  │
└────────────┬─────────────┘
             │ HTTP/HTTPS
             ▼
┌─────────────────────────┐
│ NGINX 网关              │
│-------------------------│
│ ① 反向代理 (Reverse Proxy)│
│ ② 负载均衡 (Load Balancer)│
│ ③ SSL 终结 / 缓存 / 限流等│
└────────────┬─────────────┘
             │
┌────────────┼─────────────┐
▼            ▼             ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 后端服务 A  │ │ 后端服务 B  │ │ 后端服务 C  │
│ (API Server)│ │ (API Server)│ │ (API Server)│
└─────────────┘ └─────────────┘ └─────────────┘
         │            │            │
         └────────────┴────────────┘
                      ▲
                      │ 业务逻辑响应
                      │
┌─────────────────────────┐
│ 响应返回给客户端        │
└─────────────────────────┘

图解说明：

• 客户端（Browser/App） 发起 HTTP 请求；
• 请求首先到达 Nginx，它作为入口：
  • 如果是静态资源，直接在本地返回；
  • 如果是 API 请求，按配置反向代理到后端；
  • 如果有多个后端实例，则根据策略进行负载均衡；
  • 可以在这一层做 SSL 终结、缓存、限流、鉴权等处理；
• 后端服务处理完业务，响应通过 Nginx 返回客户端。

常见架构组合：

[Browser/App] → [CDN] → [Nginx Gateway] → [Backend Cluster]

或在微服务架构中：

[Client] → [Nginx / API Gateway] → [Service Mesh / Microservices]

七、典型配置详解

一份配置如下：

server {
    listen 80;
    server_name _;
    root /usr/share/nginx/html;
    index index.html;

    # Frontend SPA - all routes fallback to index.html
    location / {
        try_files $uri $uri/ /index.html;
    }

    # Allow large file uploads(images)
    client_max_body_size 50m;

    # Proxy API requests to backend
    location /api/ {
        proxy_pass http://backend:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_read_timeout 300s;
        # SSE support
        proxy_buffering off;
        proxy_cache off;
    }

    # Gzip
    gzip on;
    gzip_types text/plain text/css application/json application/javascript text/xml;
}

这份配置是一个非常典型的 Nginx 前后端分离部署模板——前端是一个单页应用（SPA），后端是 API 服务。

整体结构概览

server {
    listen 80;
    server_name _;
    root /usr/share/nginx/html;
    index index.html;
    location / { ... }
    client_max_body_size 50m;
    location /api/ { ... }
    gzip on;
    gzip_types ...;
}

这块配置定义了一个 HTTP 服务器块（server{}）。每个 server 块通常监听一个端口和一个域名，并定义这个虚拟主机的行为。

基础监听配置

listen 80;
server_name _;

• listen 80;：告诉 Nginx 监听本机 80 端口（HTTP 默认端口）。
• server_name _;：_ 是一个 通配符占位符，表示匹配所有的域名请求（即默认站点）。常用于 Docker 容器或测试环境中，没有指定域名时，Nginx 会把请求交给这个 server 块处理。

静态资源根目录与首页

root /usr/share/nginx/html;
index index.html;

• index index.html;：当访问目录时（如 /），默认返回 index.html 文件。对于 SPA（单页应用），这是前端的入口文件。
• root：告诉 Nginx 静态文件的根目录。当请求一个 URL 时，Nginx 会在此路径下寻找对应文件。

例如，请求 /css/app.css → 实际查找 /usr/share/nginx/html/css/app.css

前端 SPA 路由兜底规则

location / {
    try_files $uri $uri/ /index.html;
}

• location /：匹配所有路径（但更具体的 location 会优先）。
• try_files $uri $uri/ /index.html;：
  • $uri 表示请求路径；
  • $uri/ 表示以文件夹形式尝试；
  • /index.html 是兜底响应。

意思是：如果请求的路径有对应的文件就返回静态文件，否则都回退（fallback）到 index.html。这对于前端 单页应用（React / Vue / Angular） 非常重要。例如访问 /dashboard 时，实际文件不存在，但前端路由会接管它。

上传限制配置

client_max_body_size 50m;

限制客户端上传文件的最大大小（这里是 50MB）。默认只有 1MB，上传图片、音视频时容易报错。如果启用了文件上传接口，就必须调整这个参数。

API 反向代理（后台服务）

location /api/ {
    proxy_pass http://backend:8000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_read_timeout 300s;
    proxy_buffering off;
    proxy_cache off;
}

这一块是重点：

1. 反向代理

• location /api/：表示拦截所有以 /api/ 开头的请求。例如 /api/login、/api/upload。
• proxy_pass http://backend:8000;：将请求转发给名为 backend 的服务的 8000 端口。

在 Docker Compose 等环境中，这里 backend 是容器名（会自动解析为容器 IP）。

2. 请求头透传

• proxy_set_header Host $host;：保持原始请求头中的主机名；
• proxy_set_header X-Real-IP $remote_addr;：记录用户真实 IP；
• proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;：记录完整的客户端 IP 链（用于日志或防御）。

3. 请求和响应控制

• proxy_read_timeout 300s;：允许后端请求最长 300 秒，没有响应才算超时；适合长任务接口。
• proxy_buffering off;：关闭响应缓冲（特别是后端返回 Server Sent Events (SSE) 时，否则会卡住）。
• proxy_cache off;：关闭代理缓存，避免实时响应被缓存。

用途总结：这一段让 /api/ 前缀的请求转发到后端，实现前后端分离部署。

Gzip 压缩支持

gzip on;
gzip_types text/plain text/css application/json application/javascript text/xml;

• gzip on;：启用响应压缩；
• gzip_types ...;：定义需要压缩的 MIME 类型，例如 HTML、CSS、JS、JSON。

好处：减小网络传输体积，提升页面加载速度。

配置逻辑总结

补充建议

若希望跨域统一，可以在 /api/ 块添加：

add_header Access-Control-Allow-Origin *;
add_header Access-Control-Allow-Headers *;

若项目使用 HTTPS，只需添加：

listen 443 ssl;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;

这份配置非常适合：

• Docker 容器化部署；
• Vue/React 前端 + Python/Node 后端的组合；
• 单机或轻量生产使用。