核心配置模板(直接复制可用)

下面展示的是一个标准的server配置块, 该配置将某个域名的反向代理请求正确地转发到了位于本地的后端服务当中, 您是可以直接把这个配置代码复制下来并且立即投入使用的, 没有任何额外的设置步骤需要来完成。

server {
    listen 80;
    server_name 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;
    }
}

大城新闻网

将 example.com 替换为你的域名,127.0.0.1:8080 替换为后端实际监听地址。

在保存了配置之后, 要一步步把 nginx -t 这个命令拿去跑一下, 用它来检验语法是不是正确, 然后把 nginx -s reload 这个命令也去执行一下, 好让新的配置加载进去, 这样反向代理就会立即发挥作用。

分步操作

Nginx域名反代设置:server块怎么写、怎么配、怎么排错(图1)

1. 新建配置文件:在 /etc/nginx/conf.d/ 下创建 example.com.conf,文件名随意,.conf 结尾即可。

2. 把内容写入到server块里面去, 按照上面提到的那个模板, 去填写那个叫作server_name的东西, 还要填写proxy_pass这个指令, 同时也需要填写proxy_set_header这个指令。

3. 多域名场景, 意思就是同一台机器承载多个域名的情况, 在这种情况下每个域名各写一个独立的服务器代码块, 监听端口相同, 服务器名称不同, nginx 会自动根据主机请求头来进行路由操作。

4. 进行校验与重载的操作, 先执行nginx -t, 在确认没有报错之后, 再去执行systemctl reload nginx这样做的目的是为了让整个过程都不中断现有存在的连接。

HTTPS 证书配置(443 端口)

Nginx域名反代设置:server块怎么写、怎么配、怎么排错(图2)

请在该域名的 server 代码块内部, 插入以下内容。

listen 443 ssl;
ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

同时在 80 端口的 server 块的首行里添加 return 301 https://$host$request_uri;, 这样做, 就可以实现, 当使用 HTTP的时候, 自动跳转到 HTTPS。

证书是可以申请到免费的 Let's Encrypt 证书的, 这个过程可以通过 certbot 这个工具来实现。当证书的有效期结束以后, 需要去执行一个操作, 才能完成续期的手续。这个操作的命令是 certbot renew && systemctl reload nginx。

高频报错速查

报错 原因 解决
502 Bad Gateway 后端服务未启动或端口不通 确认后端进程存活,端口与 proxy_pass 一致
504 Gateway Timeout 后端响应超时 加 proxy_read_timeout 300;
497 / 400 HTTPS 请求误打到 HTTP 端口 检查 listen 指令与协议是否匹配
域名解析后 404 DNS 未指向本机 修改 A 记录指向服务器公网 IP

关键注意事项

Nginx域名反代设置:server块怎么写、怎么配、怎么排错(图3)

当 proxy_pass 的指令末尾带有路径的时候, Nginx 会把那个在 location 里面匹配到的部分, 去替换成指定的路径, 如果不带路径的话, 它就是原样透传, 所以在配置之前, 一定要确认好后端的这个路由规则。

后端为 WebSocket 或 gRPC 服务时Nginx域名反代设置Nginx域名反代设置,需额外加 proxy_http_version 1.1; 及 proxy_set_header Upgrade $http_upgrade;。

在生产环境当中, 建议开启 gzip on; 这个功能, 并且要把 proxy_connect_timeout 这个值设置得合理一点, 这样做的目的是为了去避免出现因为客户端速度比较慢, 而导致后端的服务器被拖垮。