Nginx 反向代理入门:一份能直接抄的配置

举报
yd_299625919 发表于 2026/11/13 08:58:59 2026/11/13
【摘要】 手上有一台云服务器,跑了两三个服务:一个 Node 后端、一个 Python 接口、还有一堆静态页面。它们的端口各不相同,想统一用一个域名访问、还想顺便上 HTTPS——这时候最省事的办法就是加一层 Nginx 反向代理。一、反向代理在做什么浏览器只访问 Nginx 的 80/443 端口,Nginx 再按域名或路径把请求转发给后端的真实服务,并把响应原样带回。对用户来说只有一个入口,对后端...

手上有一台云服务器,跑了两三个服务:一个 Node 后端、一个 Python 接口、还有一堆静态页面。它们的端口各不相同,想统一用一个域名访问、还想顺便上 HTTPS——这时候最省事的办法就是加一层 Nginx 反向代理。

一、反向代理在做什么

浏览器只访问 Nginx 的 80/443 端口,Nginx 再按域名或路径把请求转发给后端的真实服务,并把响应原样带回。对用户来说只有一个入口,对后端来说不用暴露端口,安全性和可维护性都更好。

二、最小可用的转发配置

假设后端服务跑在 127.0.0.1:3000,在 /etc/nginx/conf.d/app.conf 里写:

server {
    listen 80;
    server_name example.com;

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

改完执行 nginx -t 检查语法,再 systemctl reload nginx 生效。那几行 proxy_set_header 很关键:不传的话,后端日志里全是 127.0.0.1,拿不到用户真实 IP,生成绝对链接时也会用错协议。

三、一个入口挂多个服务

用 location 前缀就能把不同路径分给不同后端:

location /api/ {
    proxy_pass http://127.0.0.1:3000/;
}
location /py/ {
    proxy_pass http://127.0.0.1:8000/;
}
location / {
    root /var/www/html;
    try_files $uri $uri/ /index.html;
}

注意 proxy_pass 末尾带不带斜杠语义不同:带斜杠会替换掉匹配到的前缀,不带则原样透传。这一点踩过一次坑基本就记住了。

四、两个常见坑

1. WebSocket 连不上:需要显式加上 Upgrade 头,否则握手直接失败。

proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

2. 大文件上传报 413:默认请求体限制只有 1MB,调大即可——client_max_body_size 50m;

小结

反向代理的配置量其实很小:一个 server 块、几行 proxy 指令,就能把散落的服务收拢成一个干净入口。建议先在测试环境把上面这份配置跑通,再加 HTTPS 和限流,逐步演进比一次性堆满更稳妥。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。