【Nginx】(三) Nginx配置文件精解：从入门到精通的完整指南

夹娃小能手

已于 2024-04-25 21:07:09 修改

阅读量406

点赞数 10

分类专栏： Nginx系列文章标签：服务器 nginx

于 2024-04-24 20:38:26 首次发布

本文链接：https://blog.csdn.net/weixin_37519752/article/details/138168882

版权

Nginx系列专栏收录该内容

8 篇文章 0 订阅

订阅专栏

Nginx，作为一款功能强大的 Web 服务器和反向代理软件，已经成为实现这些目标的行业标准。然而，Nginx的强大功能往往伴随着复杂的配置需求。对于想快速掌握 Nginx 配置的人来说，理解其配置文件的结构至关重要。

在本文中，我们将深入探讨 Nginx 配置文件的层次结构，从全局的 main 块到具体的 http、events，乃至 server 块和它们内部的 location 块。逐步解析每个模块的作用，以及如何通过精细的配置来优化 Nginx 的性能，增强其安全性，并实现高级的流量管理功能。

无论是一个新手，还是希望提升现有 Nginx 配置的高级用户，本文都将为您提供宝贵的指导和最佳实践。

配置结构

Nginx 配置文件
|
├── main 块：定义全局配置和工作进程的基本信息
│   ├── user nginx;                    // 设置运行 Nginx 的用户
│   ├── worker_processes auto;         // 工作进程的数量，通常与CPU核心数相等
│   ├── pid /var/run/nginx.pid;        // 定义进程 PID 文件存放位置
│   └── worker_rlimit_nofile 65535;    // 限制工作进程可打开的最大文件数
|
├── events 块：定义事件处理相关的配置
│   └── use epoll;                     // 使用 epoll 事件模型，适用于Linux系统
│       └── worker_connections 1024;   // 每个工作进程的最大连接数
|
└── http 块：定义 HTTP 服务器相关的配置，如请求处理、虚拟主机等
    ├── include /etc/nginx/mime.types;  // 引入 MIME 类型数据库
    ├── default_type text/plain;        // 设置默认的 MIME 类型
    ├── log_format main '...';          // 定义日志格式
    ├── access_log /var/log/nginx/access.log main; // 定义访问日志
    ├── error_log /var/log/nginx/error.log; // 定义错误日志
    ├── sendfile on;                    // 开启高效文件传输模式
    ├── tcp_nopush on;                  // 防止网络拥塞
    ├── tcp_nodelay on;                 // 立即发送数据，减少延迟
    ├── keepalive_timeout 65;           // 长连接超时时间
    ├── include /etc/nginx/conf.d/*.conf; // 包含额外的配置文件
    ├── include /etc/nginx/sites-enabled/*; // 包含启用的站点配置
    └── upstream myapp {                 // 定义上游服务器组，用于负载均衡模块
        ├── server backend1:8000;       // 定义后端服务器
        ├── server backend2:8000;       // 定义后端服务器
        └── ...
    }
    └── server {                        // 定义虚拟服务器，处理具体的客户端请求
        ├── listen 80;                  // 监听的端口号
        ├── server_name myapp.com;      // 绑定的域名
        ├── ssl on;                      // 是否启用 SSL/TLS 模块
        ├── ssl_certificate /path/to/cert.pem; // SSL 证书文件路径
        ├── ssl_certificate_key /path/to/key.pem; // SSL 私钥文件路径
        ├── client_max_body_size 10M;   // 设置客户端请求的最大 body 大小
        └── location / {                 // 根 location 块，处理根 URL 请求
            ├── root /var/www/html;     // 指定网站根目录
            ├── index index.html index.htm; // 定义首页文件
            └── try_files $uri $uri/ /index.html; // 请求重试规则
        }
        └── location /api/ {            // API 接口 location 块
            ├── proxy_pass http://myapp; // 代理请求到上游服务器组
            └── ...
        }
        └── ...                        // 可以有更多 location 块和其他配置
    }
    └── ...                            // 其他可能的配置，如第三方模块配置

在这个结构中：

核心模块：在 main 块中定义 Nginx 的基本运行参数。
事件模块：在 events 块中定义，使用 epoll 模型来处理连接。
HTTP 模块：在 http 块中定义 HTTP 相关的配置，如 MIME 类型、日志、请求处理等。
Mail 模块：虽然在这个示例中没有显示，但它通常也在 http 块中定义，用于配置邮件服务。
第三方模块：可以在整个 http 块中通过 include 指令包含，或者直接在 http 块中定义。
负载均衡模块：通过 upstream 指令在 http 块中定义。
静态内容模块：在 server 块中的 location 块里通过 root 或 alias 指令定义。
动态内容模块：在 server 块中的 location 块里通过 proxy_pass 指令定义。
缓存模块：在 http 块或 server 块中通过 proxy_cache 指令定义。
SSL/TLS 模块：在 server 块中通过 ssl 指令定义。
日志模块：在 http 块中定义访问日志和错误日志的路径。
健康检查模块：在 upstream 块中通过相关的健康检查指令定义。
限流模块：在 http 块或 server 块中通过 limit_req 指令定义。
Web 套接字模块：在相应的 location 块中通过 proxy_http_version 指令支持 WebSocket。
安全模块：在 http 块或 server 块中通过 ssl 指令和其他安全相关的指令定义。

配置项总览


# Nginx配置文件

# 1. 用户和组
user nginx;

# 2. 工作进程数，通常与CPU核心数相等
worker_processes auto;

# 3. 错误日志的路径
error_log /var/log/nginx/error.log warn;

# 4. 进程文件，通常用于debug
# pid /var/run/nginx.pid;

# 5. 事件模块配置
events {
    # 6. 每个工作进程的最大连接数
    worker_connections 1024;
}

# 7. HTTP服务器配置
http {
    # 8. 文件服务器配置
    server {
        listen 80;
        server_name file_server;

        # 9. 静态资源服务
        location / {
            root /usr/share/nginx/html;
            index index.html index.htm;
        }

        # 10. 静态资源的缓存配置
        location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
            expires 30d;
            access_log off;
        }
    }

    # 11. 反向代理服务器配置
    server {
        listen 8080;
        server_name reverse_proxy;

        # 12. 反向代理到一个具体的服务器
        location / {
            proxy_pass http://127.0.0.1:8081;
            proxy_set_header Host $host;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
    }

    # 13. 负载均衡配置
    upstream myapp1 {
        server backend1:3031;
        server backend2:3031;
    }

    server {
        listen 80;
        server_name lb_server;

        # 14. 将请求转发到负载均衡池
        location / {
            proxy_pass http://myapp1;
        }
    }

    # 15. 启用SSL并指定证书和密钥
    server {
        listen 443 ssl;
        server_name secure_server;

        ssl_certificate /etc/nginx/ssl/nginx.crt;
        ssl_certificate_key /etc/nginx/ssl/nginx.key;

        # 16. SSL会话缓存和票据加密
        ssl_session_cache shared:SSL:1m;
        ssl_session_tickets off;

        # 17. 配置HTTPS严格传输策略
        location / {
            add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains';
        }
    }

    # 18. 邮件代理配置（示例略）

    # 19. 高级路由与重写
    server {
        listen 80;
        server_name rewrite_server;

        # 20. URL重写
        location /oldpath {
            rewrite ^ http://rewrite_server/newpath permanent;
        }
    }

    # 21. 使用第三方模块ngx_http_gzip_module启用Gzip压缩
    gzip on;
    gzip_types text/plain text/css;
    gzip_proxied any;

    # 22. 性能监控与日志分析
    server {
        listen 80;
        server_name monitor_server;

        # 23. 访问日志配置
        access_log /var/log/nginx/monitor_server_access.log main buffer=16k;

        # 24. 健康检查
        location /health {
            return 200 'Healthy';
        }
    }

    # 25. 高可用与故障转移配置
    upstream myapp2 {
        server backend3:3031;
        server backend4:3031 backup;  # 26. 备用服务器
    }

    server {
        listen 80;
        server_name failover_server;

        # 27. 检查后端服务器状态
        location /status {
            check_status;
            allow 192.168.1.0/24;  # 28. 允许特定IP访问健康检查
            deny all;
        }

        # 29. 将请求转发到负载均衡池，并启用故障转移
        location / {
            proxy_pass http://myapp2;
            proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
        }
    }

    # 30. 限流与防刷
    limit_req_zone $binary_remote_addr zone=mylimit:10m rate=5r/s;

    server {
        listen 80;
        server_name rate_limit_server;

        # 31. 应用限流策略
        location / {
            limit_req zone=mylimit burst=5 nodelay;
            proxy_pass http://myapp1;
        }
    }

    # 32. API网关配置
    server {
        listen 80;
        server_name api_gateway;

        # 33. API路由
        location /api/ {
            # 34. 这里可以添加认证、授权、限流等API管理功能
            proxy_pass http://myapp1;
        }
    }

    # 35. 容器化与云部署配置（示例略）

    # 36. 自定义模块开发（示例略）

    # 37. 故障排查与调试
    server {
        listen 80;
        server_name debug_server;

        # 38. 错误页面配置
        error_page 404 /404.html;
        location /404.html {
            root /usr/share/nginx/html;
        }
    }

    # 39. 版本控制与升级配置（示例略）

    # 40. 最佳实践与案例分析（示例略）
}

这个配置文件覆盖了Nginx的多个关键特性，包括基础设置、性能优化、安全性、邮件代理、高级路由与重写、模块扩展、性能监控、高可用性、限流、API网关、故障排查与调试等。在实际部署时，需要根据具体的应用场景和需求进行调整和优化。此外，某些高级特性，如自定义模块开发，需要通过编写C语言模块并在Nginx源码编译时加入来实现，这在配置文件中无法体现。

夹娃小能手

关注

10
点赞
踩
1

收藏

觉得还不错? 一键收藏
3
评论
【Nginx】(三) Nginx配置文件精解：从入门到精通的完整指南

在本文中，我们将深入探讨 Nginx 配置文件的层次结构，从全局的 main 块到具体的 http、events，乃至 server 块和它们内部的 location 块。逐步解析每个模块的作用，以及如何通过精细的配置来优化 Nginx 的性能，增强其安全性，并实现高级的流量管理功能。
复制链接

扫一扫