server {
    listen 80 ; 
    server_name 服务器IP 域名 www.域名; 
    index index.php index.html index.htm default.php default.htm default.html; 
  
    proxy_set_header Host $host; 
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 
    proxy_set_header X-Forwarded-Host $server_name; 
    proxy_set_header X-Real-IP $remote_addr; 
    proxy_http_version 1.1; 
    proxy_set_header Upgrade $http_upgrade; 
    proxy_set_header Connection $http_connection; 
    proxy_set_header Authorization $http_authorization;
    access_log /www/sites/前端项目名/log/access.log main; 
    error_log /www/sites/前端项目名/log/error.log; 
    location ^~ /.well-known/acme-challenge {
        allow all; 
        root /usr/share/nginx/html; 
    }
    location / {
        try_files $uri $uri/ /index.html last; 
        index index.html; 
    }
    location /api/ {
        proxy_pass http://部署后端应用的服务器IP:端口/;  # 将请求转发到后端服务器的8081端口
        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_set_header X-Forwarded-Proto $scheme;
    }
    root /www/sites/前端项目名/index/dist; 
    error_page 404 /404.html; 
}

深入解析 Nginx 配置：构建强大的 Web 服务器基础

一、引言

在当今的 Web 开发领域，Nginx 作为一款高性能的 HTTP 和反向代理服务器，扮演着至关重要的角色。其灵活且强大的配置功能能够满足各种复杂的网络架构需求。本文将深入剖析一段典型的 Nginx 配置，帮助大家理解其中各个部分的含义与作用。

二、配置详解

（一）基础配置

server {
    listen 80 ; 
    server_name 服务器IP 域名 www.域名; 
    index index.php index.html index.htm default.php default.htm default.html;

listen 80：指定 Nginx 监听的端口为 80，这是 HTTP 协议的默认端口。意味着服务器将接收来自该端口的 HTTP 请求。
server_name：定义了此服务器块所对应的域名和 IP 地址。可以指定多个，如服务器 IP、域名以及带 www 前缀的域名。这样，当用户通过这些指定的名称或地址访问时，Nginx 就能正确识别并处理相应请求。
index：设置了默认的索引文件。当用户访问一个目录时，如果没有指定具体的文件名，Nginx 会按照这里定义的顺序依次查找这些文件作为响应内容，例如先查找 index.php，若不存在则查找 index.html 等。

（二）代理相关头信息设置

    proxy_set_header Host $host; 
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; 
    proxy_set_header X-Forwarded-Host $server_name; 
    proxy_set_header X-Real-IP $remote_addr; 
    proxy_http_version 1.1; 
    proxy_set_header Upgrade $http_upgrade; 
    proxy_set_header Connection $http_connection; 
    proxy_set_header Authorization $http_authorization;

这些 proxy_set_header 指令用于设置代理请求时传递给后端服务器的头信息。
Host 头被设置为 $host，即客户端请求的原始主机名，这有助于后端服务器正确识别请求的来源域名。
X-Forwarded-For 头记录了客户端的真实 IP 地址以及经过的代理服务器 IP 地址链，方便后端服务器获取真实的客户端信息，对于日志记录和访问控制等有重要意义。
X-Forwarded-Host 设置为 $server_name，提供了关于原始请求主机名的信息给后端。
X-Real-IP 直接设置为 $remote_addr，也是为了传递客户端的真实 IP 地址。
proxy_http_version 1.1 指定了使用 HTTP/1.1 协议进行代理通信，相比旧版本有更好的性能和功能支持。
Upgrade 和 Connection 头用于处理一些特殊的协议升级情况，如 WebSocket 连接的建立等，确保连接的正确处理。
Authorization 头则用于传递客户端的授权信息，以便后端服务器进行权限验证。

（三）日志设置

    access_log /www/sites/前端项目名/log/access.log main; 
    error_log /www/sites/前端项目名/log/error.log;

access_log：指定了访问日志的路径为 /www/sites/前端项目名/log/access.log，并使用 main 格式记录。访问日志记录了所有成功的客户端请求信息，包括请求的时间、IP 地址、请求的 URL 等，对于分析网站的访问情况、流量来源等非常有用。
error_log：定义了错误日志的路径为 /www/sites/前端项目名/log/error.log。错误日志会记录 Nginx 在处理请求过程中遇到的各种错误信息，如配置错误、文件找不到、后端服务器连接失败等，有助于排查服务器运行中的问题。

（四）特定路径配置

    location ^~ /.well-known/acme-challenge {
        allow all; 
        root /usr/share/nginx/html; 
    }

这个 location 块针对特定的路径 /.well-known/acme-challenge 进行了配置。这个路径通常用于处理 SSL 证书颁发机构（如 Let's Encrypt）的验证请求。
allow all 表示允许所有的访问请求到这个路径，确保验证过程能够顺利进行。
root /usr/share/nginx/html 指定了该路径对应的文件根目录，验证文件将从这个目录中查找。

（五）前端资源处理

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

这个 location 块处理根路径（/）的请求，也就是处理对网站首页和其他前端资源的访问。
try_files 指令是关键部分，它首先尝试查找与请求的 URI 完全匹配的文件，如果不存在，则尝试查找对应的目录（$uri/），如果还是找不到，最后将返回 index.html 文件作为响应。这对于单页应用（SPA）非常重要，因为 SPA 中的路由通常是在前端处理，所有的请求可能都指向同一个 index.html 文件，然后由前端 JavaScript 代码根据不同的路径进行页面内容的动态加载。

（六）后端代理配置

    location /api/ {
        proxy_pass http://部署后端应用的服务器IP:端口/;  # 将请求转发到后端服务器的8081端口
        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_set_header X-Forwarded-Proto $scheme;
    }

这个 location 块专门用于处理以 /api/ 开头的请求，将这些请求代理转发到后端服务器。
proxy_pass 明确指定了后端服务器的地址和端口，这里将请求转发到 http://部署后端应用的服务器IP:端口/。这样，前端对 /api/ 路径下的各种 API 调用请求都会被发送到后端服务器进行处理。
eg: 前端发出请求https://域名/api/getUser 实际请求会发往 http://部署后端应用的服务器IP:端口/getUser
后面的几个 proxy_set_header 指令同样是为了在代理请求时传递必要的头信息给后端服务器，确保后端能够正确识别请求的来源和相关信息，与前面提到的代理头信息设置类似，这里的 X-Forwarded-Proto 设置为 $scheme，用于传递请求的协议（如 HTTP 或 HTTPS）信息给后端。

（七）错误页面配置

    root /www/sites/前端项目名/index/dist; 
    error_page 404 /404.html;

root /www/sites/前端项目名/index/dist：指定了前端项目资源的根目录，Nginx 会从这个目录中查找相应的文件来响应请求。
error_page 404 /404.html：当发生 404（页面未找到）错误时，Nginx 会返回 404.html 文件作为响应内容，提供给用户一个友好的错误提示页面。

三、总结

通过对这段 Nginx 配置的详细解读，我们可以看到 Nginx 在构建 Web 服务器架构时的强大功能和灵活性。从基础的端口监听、域名匹配，到复杂的代理设置、日志记录以及前端和后端请求的处理与路由，每一个部分都紧密协作，共同为提供高效、稳定的 Web 服务奠定了坚实的基础。无论是开发人员还是运维人员，深入理解 Nginx 配置对于优化网站性能、保障安全性以及实现复杂的网络架构都具有不可替代的重要性。希望本文能够帮助读者更好地掌握 Nginx 配置的奥秘，在实际的 Web 项目中充分发挥其优势。