Nginx 反向代理配置指南,看完这篇就够了

刚工作的时候,"Nginx"对我来说就是一个黑盒------运维配好我就用,出了问题只会重启。直到有一次线上 HTTPS 证书过期,整个排查过程我插不上手,才下决心自己学了一遍。

Nginx 是干什么的

简单说就三件事:

  • 静态文件服务:直接返回 HTML/CSS/JS/图片
  • 反向代理:把请求转发给后端服务(Tomcat、Node、Go 等)
  • 负载均衡:多个后端实例,Nginx 帮你分发请求

大部分项目里,Nginx 同时干这三件事。

核心配置文件结构

nginx 复制代码
# nginx.conf 主配置
worker_processes  auto;        # 工作进程数,auto = CPU 核数

events {
    worker_connections  1024;  # 每个进程最大连接数
}

http {
    include       mime.types;
    sendfile      on;          # 零拷贝传输,静态文件必开
    keepalive_timeout  65;

    # 虚拟主机 1
    server {
        listen       80;
        server_name  example.com;

        location / {
            root   /var/www/html;
            index  index.html;
        }
    }

    # 虚拟主机 2(反向代理)
    server {
        listen       80;
        server_name  api.example.com;

        location / {
            proxy_pass http://127.0.0.1:8080;
        }
    }
}

http → server → location 三层嵌套,每一层都可以有独立的配置。

反向代理配置

最基本的一条:

nginx 复制代码
server {
    listen 80;
    server_name api.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;

        # 传递真实客户端信息给后端
        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 这四行基本是固定写法,不加的话后端拿到的 IP 全是 Nginx 的 127.0.0.1。

按路径转发到不同后端

nginx 复制代码
server {
    listen 80;
    server_name example.com;

    # API 请求 → Java 后端
    location /api/ {
        proxy_pass http://127.0.0.1:8080;
    }

    # WebSocket → Node 服务
    location /ws/ {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    # 静态文件 → 直接返回
    location / {
        root /var/www/frontend/dist;
        try_files $uri $uri/ /index.html;  # SPA 路由兜底
    }
}

try_files 那行是 SPA 标配------前端用 Vue Router / React Router 的 history 模式时,所有路径都要返回 index.html,否则刷新就 404。

HTTPS 配置

nginx 复制代码
server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate     /etc/nginx/ssl/example.com.pem;
    ssl_certificate_key /etc/nginx/ssl/example.com.key;
    ssl_protocols       TLSv1.2 TLSv1.3;
    ssl_ciphers         HIGH:!aNULL:!MD5;

    location / {
        proxy_pass http://127.0.0.1:8080;
    }
}

# HTTP 自动跳转 HTTPS
server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;
}

证书用 Let's Encrypt 免费申请,certbot 一行命令搞定续期。

负载均衡

nginx 复制代码
upstream backend {
    # 默认轮询
    server 192.168.1.10:8080 weight=3;  # 权重高的分更多请求
    server 192.168.1.11:8080 weight=1;
    server 192.168.1.12:8080 backup;    # 备用,前两台挂了才用

    # 也可以用 ip_hash(同一 IP 始终打到同一台,解决 session 问题)
    # ip_hash;

    # 或者 least_conn(请求最少的优先)
    # least_conn;
}

server {
    listen 80;
    server_name api.example.com;

    location / {
        proxy_pass http://backend;
    }
}
策略 说明 适用场景
轮询 (默认) 按顺序依次分发 后端实例性能一致
weight 按权重比例分发 后端性能不一致
ip_hash 同一 IP 固定到同一台 有 session 依赖
least_conn 优先分给连接数最少的 请求处理时间差异大

常用运维命令

bash 复制代码
# 测试配置文件语法
nginx -t

# 重新加载配置(不中断服务)
nginx -s reload

# 查看 Nginx 进程
ps aux | grep nginx

# 查看当前连接数
netstat -nlp | grep nginx

改完配置一定要先 nginx -t 测一下语法,再 nginx -s reload。直接 restart 会短暂中断连接。

踩坑:proxy_pass 末尾的斜杠

nginx 复制代码
# 有斜杠:/api/users → http://backend/users(去掉了 /api)
location /api/ {
    proxy_pass http://backend/;
}

# 没斜杠:/api/users → http://backend/api/users(保留 /api)
location /api/ {
    proxy_pass http://backend;
}

这个坑我见过不下三次,前后端联调的时候路径对不上,排查半天发现是斜杠的问题。记住:proxy_pass 后面有路径(哪怕只是一个 /),就会替换掉 location 的匹配部分。

总结

Nginx 日常用到的就是:反向代理(proxy_pass)、静态文件(root + try_files)、HTTPS(ssl_certificate)、负载均衡(upstream)。配完记得 nginx -t 测语法,proxy_pass 注意斜杠。

相关推荐
Csvn13 小时前
Nginx 静态站点与 location 匹配:优先级、alias、缓存头与 gzip
后端·nginx
考虑考虑16 小时前
nginx拦截url
运维·后端·nginx
李纲明1 天前
WordPress 打开站点却直接下载文件或源码而不显示页面:先核 PHP 处理规则,再查 443 是否被其他站接管
nginx·wordpress·443·php解析·站点配置·devdiy·直接下载
Java码农也是农2 天前
一篇文章讲清 NGINX 反向代理:location、proxy_pass、负载均衡与排错
nginx·负载均衡·后端开发·反向代理·proxy_pass
李纲明3 天前
WordPress 打开页面直接报 500 而不是白屏:先核伪静态与文件权限,再查服务器错误日志
nginx·wordpress·文件权限·伪静态·错误日志·devdiy·500错误
Csvn4 天前
Nginx 配置语法与上下文:一次搞懂继承、变量与用 map 替掉 if
后端·nginx
Csvn7 天前
安装、升级与目录结构
后端·nginx
Csvn8 天前
认识 Nginx
后端·nginx
陈希1239 天前
Nginx 从入门到能扛事:反向代理、负载均衡与 HTTPS 实战
nginx·https·负载均衡
木头左10 天前
【Nginx】内网服务源 IP 白名单实战:动态域名解析放行网段 + 端口接管零改造
运维·nginx·白名单·反向代理