Nginx 反向代理入门:把本地服务安全地交给互联网

举报
yd_240716394 发表于 2026/11/12 12:13:07 2026/11/12
【摘要】 自己写的小服务跑在本地端口上,只能本机访问;想让同事在局域网里试用,又不想把服务本身直接暴露出去。反向代理就是为这种场景准备的:让 Nginx 站在门口统一接请求,再按规则转发给后面的真实服务。本文用两台本地小服务做实验,从零配出一份能用的反向代理。 一、反向代理到底在代理谁正向代理是替客户端出门办事,客户端知道代理的存在;反向代理是替服务端接客,访问者只看到 Nginx,并不知道后面是哪台...

自己写的小服务跑在本地端口上,只能本机访问;想让同事在局域网里试用,又不想把服务本身直接暴露出去。反向代理就是为这种场景准备的:让 Nginx 站在门口统一接请求,再按规则转发给后面的真实服务。本文用两台本地小服务做实验,从零配出一份能用的反向代理。

一、反向代理到底在代理谁

正向代理是替客户端出门办事,客户端知道代理的存在;反向代理是替服务端接客,访问者只看到 Nginx,并不知道后面是哪台真实服务器在干活。理解这一层,后面的配置就都顺了:Nginx 对外只暴露一个入口,对内可以接很多后端;入口可以做路径分流、负载均衡、缓存和限流,而后端服务只需要专心处理业务。

二、准备两个后端服务

不用写代码,用 Python 自带的 http.server 快速起两个静态服务,分别代表 A 服务和 B 服务:

mkdir -p /tmp/site-a /tmp/site-b
echo "这是 A 服务" > /tmp/site-a/index.html
echo "这是 B 服务" > /tmp/site-b/index.html
python3 -m http.server 8001 --directory /tmp/site-a &
python3 -m http.server 8002 --directory /tmp/site-b &

启动后先自测一下,确认两个端口都能返回内容:

curl 127.0.0.1:8001
curl 127.0.0.1:8002

如果 curl 能拿到“这是 A 服务”和“这是 B 服务”,后端就绪。实验结束记得用 jobs 或 kill 把这两个后台进程停掉。

三、安装并确认 Nginx

以常见的 Linux 发行版为例:

sudo apt update && sudo apt install -y nginx
nginx -v
sudo systemctl start nginx
sudo systemctl enable nginx

装好后访问本机 80 端口,看到 Nginx 默认欢迎页就说明服务正常:

curl 127.0.0.1

四、写第一份反向代理配置

新建一份配置文件,监听 8080 端口,把所有请求交给 8001 上的 A 服务,同时把真实的 Host 和客户端地址透传给后端:

server {
    listen 8080;
    server_name _;

    location / {
        proxy_pass http://127.0.0.1:8001;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

把文件保存为 /etc/nginx/conf.d/demo.conf,然后检查语法并重载:

sudo nginx -t
sudo systemctl reload nginx
curl 127.0.0.1:8080

这时访问 8080 拿到的就是 A 服务的内容。浏览器和 curl 看到的都是 Nginx,但真正出内容的是 8001 端口的服务。转发请求头这三行值得单独记一下:Host 影响后端按域名路由,X-Real-IP 和 X-Forwarded-For 让后端能拿到真实客户端地址,否则后端日志里全是 127.0.0.1,出了问题很难定位。

五、一个入口带两个后端:按路径分流

一个入口也可以同时服务多个后端,按访问路径区分:

server {
    listen 8080;
    server_name _;

    location /a/ {
        proxy_pass http://127.0.0.1:8001/;
    }

    location /b/ {
        proxy_pass http://127.0.0.1:8002/;
    }
}

这里有个容易踩的细节:proxy_pass 后面带不带斜杠,含义不一样。带斜杠时,location 匹配到的 /a/ 部分会被替换掉再转发;不带斜杠时,原始 URI 会原样拼到后端地址后面。写配置时先用 curl 逐个路径验证一次,比上线后排查要省事得多。

六、负载均衡:一个 upstream 轮流接客

如果 A 和 B 其实是同一个服务的两个副本,可以把它们放进 upstream,让 Nginx 轮询分发:

upstream backend {
    server 127.0.0.1:8001;
    server 127.0.0.1:8002;
}

server {
    listen 8080;
    server_name _;

    location / {
        proxy_pass http://backend;
        proxy_set_header Host $host;
    }
}

重载后多次执行 curl 127.0.0.1:8080,会交替看到 A 服务和 B 服务的返回。这就是最简单的负载均衡。后续某个副本下线时,Nginx 会自动把它摘掉,请求只发给健康的副本。

七、常见问题排查

遇到问题先看错误日志,再猜原因:

sudo tail -f /var/log/nginx/error.log

502 Bad Gateway 是最常见的报错,多数情况是后端没启动、端口写错,或者后端只监听了 127.0.0.1 以外的地址。404 则多半是 location 和 proxy_pass 的斜杠没配对。改了配置却没生效时,先确认两件事:一是用 nginx -t 检查语法并 reload,二是确认自己改的确实是正在生效的配置文件,可以用 nginx -T 打印出全部生效配置来核对。

八、两条安全习惯

第一,只放行 80 和 443 端口,后端服务的端口不要直接对外暴露,所有流量都走 Nginx 这个入口。第二,在 http 段加上 server_tokens off,隐藏 Nginx 版本号,让扫描者少拿到一点信息。生产环境还应在 443 上启用 HTTPS,证书到期前记得续期。

小结

反向代理就像门口的接待员:对外一个入口,对内按规则分流,还能顺手做负载均衡和请求头透传。从一个 proxy_pass 开始,先把“一个入口、一个后端”跑通,再按路径分流、再上 upstream,遇到 502 就先查错误日志。这套流程跑通后,日常部署小服务基本够用了。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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