Nginx 反向代理入门:5 分钟把本地服务安全暴露出去

举报
yd_299631796 发表于 2026/11/03 10:26:45 2026/11/03
【摘要】 本地服务想给外部访问、上 HTTPS 或多服务共用 80 端口?一段 proxy_pass 配置就能搞定。这篇讲清三个核心指令(proxy_pass、proxy_set_header、upstream)、结尾斜杠的路径替换坑、WebSocket 升级头和上传 413 的解法。

为什么需要反向代理

本地起的开发服务监听在 127.0.0.1:3000,想给同事演示、或者要接入 HTTPS、又或者想让两个服务共用 80 端口——这些场景都指向同一个答案:加一层 Nginx 反向代理。它坐在真实服务前面,统一接收外部请求再转发进去,服务本身不需要任何改动。

最小可用配置

假设本地 3000 端口跑着一个 Web 应用,只需在 Nginx 配置里加一段:

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

reload 一下(nginx -s reload),访问 demo.example.com 的请求就会被转发到本地 3000 端口。

三个最常用的指令

proxy_pass:转发目的地,写上游服务地址。注意结尾有没有斜杠的区别:proxy_pass http://backend/ 会替换掉 location 匹配的部分,不带斜杠则保留完整路径,新手最容易在这里踩坑。

proxy_set_header:默认转发会丢 Host 头,后端拿到的 Host 变成 upstream 名字。加 proxy_set_header Host $host; 后端才能正确识别域名、生成绝对链接。

upstream:多个后端实例做负载均衡:

upstream backend {
    server 127.0.0.1:3000;
    server 127.0.0.1:3001;
}
server {
    location / { proxy_pass http://backend; }
}

两个高频坑

1. WebSocket 转发需要额外两行配置,否则握手立刻失败:

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

2. 大文件上传报 413,是 client_max_body_size 默认只有 1M,按需调大即可。

小结

反向代理是部署的标配:入口统一、HTTPS 卸载、负载均衡、静态资源分流都靠它。记住 proxy_pass 的斜坑、Host 头和 WebSocket 三件事,日常使用基本就稳了。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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