一文掌握 Nginx 反向代理:从入门到生产级配置

简介: 本文全面解析Nginx反向代理,涵盖基础概念、负载均衡策略、SSL终止、缓存、安全防护及生产级配置,助你从入门到精通,构建高性能、高可用的Web架构。

一文掌握 Nginx 反向代理:从入门到生产级配置

Nginx作为高性能的HTTP服务器和反向代理服务器,在现代Web架构中扮演着至关重要的角色。反向代理是Nginx的核心功能之一,它能够将客户端请求转发到后端服务器,并将响应返回给客户端,为负载均衡、安全防护、SSL终止等提供了强大的支持。

反向代理基本概念

反向代理(Reverse Proxy)是指代理服务器端的请求,客户端并不知道实际提供服务的服务器。与正向代理不同,反向代理隐藏了后端服务器的真实IP地址,客户端直接与代理服务器通信。

反向代理的优势

优势 说明
负载均衡 分发请求到多个后端服务器
安全防护 隐藏后端服务器真实地址
SSL终止 在代理层处理SSL加密解密
缓存加速 缓存静态资源提高响应速度
高可用性 提供故障转移和健康检查

基础反向代理配置

简单反向代理

server {
   
    listen 80;
    server_name example.com;

    location / {
   
        proxy_pass http://backend_server;
        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;
    }
}

后端服务器组配置

pstream backend_servers {
   
    server 192.168.1.10:8080 weight=3;
    server 192.168.1.11:8080 weight=2;
    server 192.168.1.12:8080 backup;
}

server {
   
    listen 80;
    server_name example.com;

    location / {
   
        proxy_pass http://backend_servers;
    }
}

负载均衡策略

轮询(Round Robin)

upstream backend {
   
    server backend1.example.com;
    server backend2.example.com;
    server backend3.example.com;
}

加权轮询

upstream backend {
   
    server backend1.example.com weight=3;
    server backend2.example.com weight=2;
    server backend3.example.com weight=1;
}

IP哈希

upstream backend {
   
    ip_hash;
    server backend1.example.com;
    server backend2.example.com;
}

最少连接

upstream backend {
   
    least_conn;
    server backend1.example.com;
    server backend2.example.com;
}

高级反向代理配置

健康检查配置

upstream backend {
   
    server backend1.example.com max_fails=3 fail_timeout=30s;
    server backend2.example.com max_fails=3 fail_timeout=30s;
    server backend3.example.com max_fails=3 fail_timeout=30s;
}

连接和超时配置

server {
   
    listen 80;
    server_name example.com;

    location / {
   
        proxy_pass http://backend;

        # 连接超时
        proxy_connect_timeout 30s;

        # 发送超时
        proxy_send_timeout 60s;

        # 接收超时
        proxy_read_timeout 60s;

        # 缓冲区配置
        proxy_buffer_size 4k;
        proxy_buffers 8 4k;
        proxy_busy_buffers_size 8k;
    }
}

请求和响应头处理

server {
   
    listen 80;
    server_name example.com;

    location /api/ {
   
        proxy_pass http://api_backend/;

        # 设置请求头
        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;
        proxy_set_header X-Original-URI $request_uri;

        # 修改响应头
        proxy_hide_header X-Powered-By;
        add_header X-Proxy-Cache $upstream_cache_status;
        add_header X-Upstream-Status $upstream_status;
    }
}

SSL/TLS配置

SSL终止

server {
   
    listen 443 ssl http2;
    server_name example.com;

    ssl_certificate /path/to/certificate.crt;
    ssl_certificate_key /path/to/private.key;

    # SSL安全配置
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;

    location / {
   
        proxy_pass http://backend;
        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 https;
    }
}

重定向HTTP到HTTPS

server {
   
    listen 80;
    server_name example.com;
    return 301 https://$server_name$request_uri;
}

缓存配置

简单缓存

proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=10g 
                 inactive=60m use_temp_path=off;

server {
   
    listen 80;
    server_name example.com;

    location / {
   
        proxy_pass http://backend;

        # 启用缓存
        proxy_cache my_cache;
        proxy_cache_valid 200 302 10m;
        proxy_cache_valid 404 1m;

        # 缓存键
        proxy_cache_key $scheme$request_method$host$request_uri;

        # 缓存头
        add_header X-Cache-Status $upstream_cache_status;
    }
}

高级缓存配置

proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=static_cache:10m 
                 max_size=50g inactive=1h use_temp_path=off;

server {
   
    listen 80;
    server_name example.com;

    # 静态资源缓存
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
   
        proxy_pass http://static_backend;
        proxy_cache static_cache;
        proxy_cache_valid 200 1h;
        proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
        proxy_cache_background_update on;
        proxy_cache_lock on;
    }

    # API缓存
    location /api/ {
   
        proxy_pass http://api_backend;
        proxy_cache my_cache;
        proxy_cache_valid 200 5m;
        proxy_cache_bypass $http_cache_control;
        add_header X-Cache-Status $upstream_cache_status;
    }
}

安全配置

防止DDoS攻击

限制请求频率

limit_req_zone $binary_remote_addr zone=api:10m rate=10r/s;
limit_req_zone $binary_remote_addr zone=login:10m rate=1r/s;

server {
   
    listen 80;
    server_name example.com;

    location /api/ {
   
        limit_req zone=api burst=20 nodelay;
        proxy_pass http://api_backend;
    }

    location /login {
   
        limit_req zone=login burst=3 nodelay;
        proxy_pass http://auth_backend;
    }
}

隐藏版本信息

server {
   
    listen 80;
    server_name example.com;

    # 隐藏Nginx版本
    server_tokens off;

    location / {
   
        proxy_pass http://backend;
        proxy_hide_header X-Powered-By;
        proxy_hide_header Server;
    }
}

生产级完整配置示例

主配置文件

user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log warn;
pid /var/run/nginx.pid;

events {
   
    worker_connections 1024;
    use epoll;
    multi_accept on;
}

http {
   
    include /etc/nginx/mime.types;
    default_type application/octet-stream;

    # 日志格式
    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent" "$http_x_forwarded_for" '
                    'rt=$request_time uct="$upstream_connect_time" '
                    'uht="$upstream_header_time" urt="$upstream_response_time"';

    access_log /var/log/nginx/access.log main;

    # 基本设置
    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;
    keepalive_timeout 65;
    types_hash_max_size 2048;
    client_max_body_size 16M;

    # Gzip压缩
    gzip on;
    gzip_vary on;
    gzip_min_length 1024;
    gzip_proxied any;
    gzip_comp_level 6;
    gzip_types
        text/plain
        text/css
        text/xml
        text/javascript
        application/json
        application/javascript
        application/xml+rss
        application/atom+xml
        image/svg+xml;

    # 缓存路径
    proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=main_cache:100m 
                     max_size=10g inactive=60m use_temp_path=off;

    # 限制区域
    limit_req_zone $binary_remote_addr zone=general:10m rate=10r/s;
    limit_conn_zone $binary_remote_addr zone=conn_limit_per_ip:10m;

    # 后端服务器组
    upstream app_backend {
   
        least_conn;
        server app1.example.com:8080 weight=3 max_fails=2 fail_timeout=30s;
        server app2.example.com:8080 weight=3 max_fails=2 fail_timeout=30s;
        server app3.example.com:8080 weight=2 max_fails=2 fail_timeout=30s;
        keepalive 32;
    }

    upstream api_backend {
   
        ip_hash;
        server api1.example.com:8080 max_fails=2 fail_timeout=30s;
        server api2.example.com:8080 max_fails=2 fail_timeout=30s;
    }

    # HTTP服务器 - 重定向到HTTPS
    server {
   
        listen 80;
        server_name example.com www.example.com;
        return 301 https://$server_name$request_uri;
    }

    # HTTPS服务器
    server {
   
        listen 443 ssl http2;
        server_name example.com www.example.com;

        # SSL配置
        ssl_certificate /path/to/certificate.crt;
        ssl_certificate_key /path/to/private.key;
        ssl_protocols TLSv1.2 TLSv1.3;
        ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384;
        ssl_prefer_server_ciphers off;
        ssl_session_cache shared:SSL:10m;
        ssl_session_timeout 10m;

        # 安全头
        add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
        add_header X-Frame-Options DENY always;
        add_header X-Content-Type-Options nosniff always;
        add_header Referrer-Policy "strict-origin-when-cross-origin" always;

        # 限制
        limit_req zone=general burst=20 nodelay;
        limit_conn conn_limit_per_ip 10;

        # 静态资源
        location ~* \.(jpg|jpeg|png|gif|ico|css|js|woff|woff2|ttf|eot)$ {
   
            proxy_pass http://static_backend;
            proxy_cache main_cache;
            proxy_cache_valid 200 1h;
            proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
            expires 1y;
            add_header Cache-Control "public, immutable";
            add_header X-Cache-Status $upstream_cache_status;
        }

        # API接口
        location /api/ {
   
            proxy_pass http://api_backend;
            proxy_http_version 1.1;
            proxy_set_header Connection "";

            # 请求头
            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;

            # 缓存配置
            proxy_cache main_cache;
            proxy_cache_valid 200 5m;
            proxy_cache_bypass $http_cache_control;
            add_header X-Cache-Status $upstream_cache_status;

            # 超时配置
            proxy_connect_timeout 5s;
            proxy_send_timeout 30s;
            proxy_read_timeout 30s;
        }

        # 应用程序
        location / {
   
            proxy_pass http://app_backend;
            proxy_http_version 1.1;

            # 请求头
            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;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";

            # 超时配置
            proxy_connect_timeout 5s;
            proxy_send_timeout 30s;
            proxy_read_timeout 30s;

            # 缓冲区
            proxy_buffer_size 4k;
            proxy_buffers 8 4k;
            proxy_busy_buffers_size 8k;
        }
    }
}

监控和日志

自定义日志格式

og_format detailed '$remote_addr - $remote_user [$time_local] '
                   '"$request" $status $body_bytes_sent '
                   '"$http_referer" "$http_user_agent" '
                   'rt=$request_time uct="$upstream_connect_time" '
                   'uht="$upstream_header_time" urt="$upstream_response_time" '
                   'upstream_addr=$upstream_addr';

错误页面配置

error_page 500 502 503 504 /50x.html;
location = /50x.html {
   
    root /usr/share/nginx/html;
}

性能优化建议

  1. 启用Gzip压缩:减少传输数据量
  2. 合理配置缓冲区:提高响应速度
  3. 使用HTTP/2:提升传输效率
  4. 配置缓存策略:减少后端压力
  5. 启用连接复用:减少连接建立开销
  6. 限制请求频率:防止恶意攻击

故障排查

常见问题及解决方案

  1. 502 Bad Gateway:检查后端服务器状态和网络连通性
  2. 504 Gateway Timeout:调整proxy_read_timeout参数
  3. 413 Request Entity Too Large:调整client_max_body_size参数
  4. SSL握手失败:检查证书配置和协议版本

通过以上配置,可以构建一个高可用、高性能的Nginx反向代理系统,为现代Web应用提供稳定可靠的服务。



关于作者



🌟 我是suxiaoxiang,一位热爱技术的开发者

💡 专注于Java生态和前沿技术分享

🚀 持续输出高质量技术内容



如果这篇文章对你有帮助,请支持一下:




👍 点赞


⭐ 收藏


👀 关注



您的支持是我持续创作的动力!感谢每一位读者的关注与认可!


目录
相关文章
|
8月前
|
安全 编译器 C语言
C语言「宏的暗门」:预处理阶段的隐形篡改与避坑守则
宏是C语言预处理阶段的纯文本替换工具,无类型、无作用域、不检语法,易引发括号缺失、副作用、分号错误、类型混乱和命名污染等六大陷阱。安全使用须严守括号规范、避免参数复用、善用`do{...}while(0)`、优先选用内联函数,并及时`#undef`。(239字)
655 10
|
9月前
|
缓存 负载均衡 安全
Nginx 反向代理:原理、优势与配置指南
Nginx反向代理是核心服务器架构技术,可实现请求转发、负载均衡、高可用与安全防护。它隐藏后端服务器,自动剔除故障节点,并支持SSL终止、缓存等高级功能,配置简洁灵活,广泛应用于高性能Web系统。
959 13
|
Kubernetes 负载均衡 应用服务中间件
【K8S系列】第十三讲:Ingress详解
【K8S系列】第十三讲:Ingress详解
9736 0
|
8月前
|
Python
用Python给PPT“加点戏”:让汇报秒变高光时刻
本文揭秘Python批量添加PPT动画的实战技巧,用`python-pptx`实现淡入、顺序出现等基础效果,借`Spire.Presentation`打造旋转淡出、逐行高亮等高级动画,直击手动调动画耗时、单一、难维护三大痛点,并附避坑指南与可复用模板,助你10分钟搞定专业动态汇报。(239字)
1189 2
|
8月前
|
人工智能 API 数据安全/隐私保护
OpenClaw(Clawdbot)阿里云极简部署指南 零基础避坑+DeepSeek V3.2大模型对接实操流程
2026年,开源AI智能体工具OpenClaw(曾用名Clawdbot、Moltbot)凭借**轻量化运行、私有化部署、大模型灵活对接、自动化任务执行**的核心特性,成为零基础用户打造私人AI助手的首选工具。它无需复杂的本地硬件配置,依托阿里云轻量服务器即可实现7×24小时稳定运行,既能完成日常问答、代码生成,也能实现文件管理、信息检索、自动化脚本执行等实操功能,完美平衡易用性与实用性。
1096 1
|
10月前
|
数据采集 前端开发 测试技术
Python网页自动化操作全攻略:从入门到实战
网页自动化可高效替代重复性浏览器操作,广泛应用于数据采集、测试、社交媒体管理等场景。本文详解Selenium、Requests+BeautifulSoup、Playwright三大工具的选型与实战技巧,涵盖元素定位、等待机制、反爬应对、多窗口处理及CI/CD集成,助你构建稳定高效的自动化流程。(238字)
941 0
|
8月前
|
人工智能 自然语言处理 安全
零技术门槛保姆级攻略!OpenClaw(Clawdbot)阿里云/本地秒级部署接入大模型Kimi K2.5教程
OpenClaw(曾用名Clawdbot、Moltbot)作为开源AI智能体工具,核心价值在于可将自然语言指令转化为实际系统操作,涵盖文件管理、终端命令执行、浏览器自动化、多工具集成等全场景功能,打破了普通聊天机器人“只说不做”的局限,成为2026年个人办公自动化与轻量团队协作的热门工具。2026年1月27日,月之暗面正式官宣开源Kimi系列重磅迭代模型——K2.5,这款被创始人杨植麟称为“Kimi史上综合能力最强的开源全能模型”,凭借15万亿级“视觉+文本”混合训练数据底座、200k超长上下文、多模态交互及推理提速40%的核心优势,与OpenClaw协同后,可大幅强化自然语言理解、复杂任务规
2763 3
|
9月前
|
Perl
银河麒麟V10安装 openssl-1.1.1f-4.p12.ky10.x86_64.rpm 教程(含依赖解决)
本指南详解在银河麒麟V10(x86_64)系统上安装OpenSSL 1.1.1f RPM包的完整流程:含系统确认、下载路径校验、推荐使用dnf/yum自动解决依赖安装,以及rpm命令手动安装备选方案,最后提供验证方法。步骤清晰,实操性强。(239字)
|
Kubernetes 应用服务中间件 nginx
Kubernetes 使用Rook-Ceph作为持久化存储PV
本文介绍如何在 Kubernetes 中使用 Rook-Ceph 作为 PV,重点演示 CephFS 的配置与部署流程。内容涵盖前提条件、Rook-Ceph 安装、StorageClass 设置、PVC 使用示例、Ceph Dashboard 配置、测试应用(如 Nginx 和 Alpine)、ConfigMap 挂载、服务暴露、跨可用区高可用方案等关键步骤,并附有命令行操作示例和验证方法。
Kubernetes 使用Rook-Ceph作为持久化存储PV