Nginx 既能做正向代理,也能做反向代理,但两者的配置写法完全不同。中文搜「nginx 正向代理」能找到的内容里,有不少其实贴的是反向代理配置,读者照抄跑不通,还不知道错在哪。这篇先把两种写法并排摆出来,再给正向代理的完整配置、常见报错,最后说清一个关键限制:原生 Nginx 不支持 HTTPS 网站的正向代理。
本文面向的场景是:公司内部想搭一个统一的对外出口,让内网的程序通过它访问外部服务。
一、一句话区别和配置对照
正向代理替你出面去访问别人,反向代理替网站出面接待访客。概念上的详细区别见正向代理和反向代理到底差在哪,这里只看配置上的差别:
| 配置项 | 反向代理 | 正向代理 |
|---|---|---|
| 转发给谁 | 写死的后端地址 | 客户端请求里的目标地址,用变量拼出来 |
| server_name | 写网站域名 | 一般不需要 |
| resolver(DNS) | 通常不需要 | 必须配,否则无法解析目标 |
| 访问控制 | 对所有访客开放 | 必须限制,只允许内网地址使用 |
| 客户端怎么用 | 直接访问网站域名 | 在客户端里把它设为代理 |
反向代理的典型写法是这样的——如果你照抄的配置长这样,那它不是正向代理:
server {
listen 80;
server_name www.example.com;
location / {
proxy_pass http://127.0.0.1:8080; # 写死的后端
}
}
二、正向代理的完整配置
server {
listen 3128;
# 必须:用于解析目标域名,填公司内部或可用的 DNS
resolver 你的DNS地址 valid=300s;
resolver_timeout 5s;
# 必须:只允许内网使用,其余拒绝
allow 10.0.0.0/8;
allow 192.168.0.0/16;
deny all;
location / {
proxy_pass http://$http_host$request_uri;
proxy_set_header Host $http_host;
}
access_log /var/log/nginx/forward_proxy.log;
}
三个要点:
- proxy_pass 用变量:目标地址每次都不一样,所以从请求里取。也正因为用了变量,Nginx 必须在运行时解析域名,这就是 resolver 必不可少的原因。
- 访问控制不能省:不加 allow / deny,这台机器就成了谁都能用的公开代理,出口地址会被他人滥用。
- 单独记日志:统一出口的价值之一就是能看清谁在访问什么,日志要和网站日志分开。
客户端侧,把代理地址设成 http://这台机器的地址:3128 即可,环境变量写法见HTTP 代理环境变量相关文章。
三、常见报错
| 现象 | 原因 | 处理 |
|---|---|---|
| 日志里出现 no resolver defined | 没配 resolver | 加上 resolver 一行 |
| 502,日志提示无法解析 | resolver 填的 DNS 不可用或解析不了目标 | 换一个可用的 DNS,确认这台机器能访问它 |
| 访问 https 网站返回 400 | 原生 Nginx 不支持 CONNECT 方法 | 见第四节 |
| 403 | 客户端地址不在 allow 范围内 | 检查访问控制规则 |
四、HTTPS 为什么不通
这是中文教程基本不写的一句:原生 Nginx 不支持 CONNECT 方法,所以上面的配置只能代理 http 网站,访问 https 网站会直接失败。
原因是:客户端通过代理访问 https 网站时,会先发一个 CONNECT 请求,让代理建一条通道,加密内容在通道里直接传。原生 Nginx 不认这个请求。常见的处理方式有两种:
- 使用第三方模块:社区有提供 CONNECT 支持的模块,但需要重新编译 Nginx,升级和维护成本都要算进去。
- 换用专门的正向代理软件:如果你的主要需求就是统一出口,专门的代理软件对 HTTPS、认证、缓存的支持更完整,往往比改造 Nginx 省事。
现在绝大多数外部服务都是 https,所以只配 http 的正向代理,实际用处很有限——这一点要在选方案时就想清楚。
五、边界:自建还是买服务
必须说清楚:自建的正向代理,出口就是你这台服务器的地址,只有一个、只在一个地方。它适合做公司内部的统一出口、访问审计和白名单对接;但如果你需要多个国家和城市的出口,或者需要出口是住宅网络,自建解决不了。
| 需求 | 自建 Nginx 正向代理 | 代理 IP 服务 |
|---|---|---|
| 内部统一出口、审计日志 | 合适 | 可作为上游,但不是必须 |
| 多国家、多城市出口 | 做不到 | 合适 |
| 出口为住宅或移动网络 | 做不到 | 合适 |
两者也常组合使用:内网程序统一走自建代理,需要访问特定地区时再由它转到外部服务。外部这一段,动态住宅 IP(按流量计费)适合多地区访问,静态住宅 IP(按条数计费)适合需要固定出口、对接对方白名单的情况,资源覆盖全球大部分国家和地区。需要先测一下,我们提供免费试用。
六、常见问题
Q1. 照抄的 Nginx 正向代理配置为什么不通?
A. 先看 proxy_pass 是不是写死的地址——那是反向代理。正向代理要用变量拼目标地址,并配 resolver。
Q2. Nginx 正向代理能代理 https 吗?
A. 原生不能,它不支持 CONNECT 方法。需要第三方模块,或者换用专门的正向代理软件。
Q3. 为什么一定要配 allow / deny?
A. 不限制的话,任何人都能用它作为代理,出口地址会被滥用。
Q4. resolver 填什么?
A. 填这台服务器能访问到、并且能解析目标域名的 DNS,公司内部有 DNS 的优先用内部的。
先测,再谈采购
内部统一出口自己搭就够了;需要多地区或住宅网络出口时,再把外部服务接到它后面。
(本文基于 2026 年 9 月 Nginx 开源版的通用行为整理,配置中的地址均为占位写法;第三方模块的兼容性随版本变化,请以对应项目的说明为准。)