nginx实现域名跳转但地址栏不变的核心方案，是使用反向代理（proxy_pass）将请求转发给目标服务器，同时通过proxy_set_header保留原始Host信息，让浏览器始终停留在当前域名上。这个操作在nginx里不算复杂，但很多朋友容易把“跳转”和“反代”混为一谈前者是服务器告诉你“去别处”，后者是服务器替你“跑一趟”,今天聊聊真正能让用户无感知的配置方式。
nginx反向代理与301跳转的核心区别在哪里
想实现域名不变，首先得明白你面对的是什么，301/302跳转是服务器返回一个Location头，让浏览器主动发起新请求，地址栏一定会变，而反向代理是nginx代替客户端去访问上游服务器,拿到响应后再原样返回给浏览器。
业界对这两个场景的用法很清晰：需要GEO权重转移、永久迁移的时候用301；需要隐藏后端、做负载均衡、规避跨域限制时，用反向代理，行业共识认为，反向代理是解决“域名跳转但地址栏不变”的唯一可行方案。
举一个最常见的场景我帮朋友做过一个外贸站群，几十个域名都指向同一个后台系统，后台部署在一台内网服务器上，如果直接301，访客看到的一律是主站地址，站群就失去了意义，最终用的就是nginx反代，每个域名对应一个server块，proxy_pass指向内网IP,浏览器地址栏永远停留在用户输入的那个域名上。
nginx反代配置的核心模块与关键指令
proxy_pass的两种写法及其区别
这是最容易踩坑的地方，proxy_pass后面加不加“/”,语义完全不同。
- 不带斜杠：
proxy_pass http://192.168.1.10;表示把原始URI原样转发过去，用户访问www.example.com/api/user，后端收到的是/api/user。 - 带斜杠：
proxy_pass http://192.168.1.10/;表示把location匹配部分替换掉，用户访问www.example.com/api/user，后端收到的是/user。
多数的“跳转后404”都是这里写错了，建议先明确后端接口是否有统一前缀,再决定用哪种写法。
核心配置段参考
这是一个最小可用的反代配置：
server {
listen 80;
server_name www.example.com;
location / {
proxy_pass http://后端IP或域名;
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;
}
}这里的关键就在proxy_set_header Host $host;这一行，如果不设置，nginx默认会把Host传给后端，后端拿到的域名是内网地址或上游域名，在生成重定向链接或处理跨域逻辑时就会出问题，设置成
$host后，后端会认为用户访问的就是你的对外域名,一切按正常逻辑处理。
WebSocket场景的额外配置
如果你的站点用到WebSocket（比如在线客服、实时推送）,需要额外加两个header：
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";这两个头保证长连接不被nginx拦腰截断，许多朋友配置完反代后聊天功能一直掉线,多半是少了这两行。
域名跳转但地址栏不变得适配哪些使用场景
反代不是万金油，它的适用场景非常明确,选错了后续维护很头疼。
- 内网穿透：服务器本机没有任何公网IP，只能通过一台有公网的nginx中转，这是最典型的“地址栏不变”需求。
- 前后端分离部署：前端静态文件放在nginx上，API请求通过反代转发到另一台服务器的Tomcat或Node服务，浏览器地址是
www.example.com，数据实际从api.internal.com获取,用户完全无感知。 - 域名备案受限：如果你的目标服务器在境外，但域名备案要求接入国内IP，可以购买一台国内轻量服务器专门跑nginx反代到境外节点，地址栏不变，实际访问的却是境外资源，近年来不少个人开发者用这个方案解决备案问题,流量小的情况下成本很低。
我接手过一个PHP老项目，数据库连接信息写死在配置文件里，无法直接用新域名访问，在不改代码的前提下，用nginx反代把旧域名映射到新服务器，业务零停机切过去了，这就是反代的价值它能在不动后端代码的情况下，解决域名匹配、跨域、证书等问题。
反代配置中的常见隐患与排查路径
重定向循环问题
配置没问题，但打开页面提示“重定向次数过多”，原因通常是后端也配置了一层跳转逻辑，比如后端判断请求域名不在白名单内就302到主域名，而nginx又把请求转发回来了,两个服务互相踢皮球。
排查步骤：
- 用
curl -I观察响应头,看返回的是301还是302。 - 检查后端代码的域名白名单,把对外域名加进去。
- 如果后端是Nginx，检查其是否有
return 301之类的显式跳转配置。
端口转发丢失问题
有些服务跑在非80端口上，比如8080，反代时如果不显式处理端口,会出现地址栏不变但页面资源加载失败的情况。
解决方案是在proxy_set_header中添加：
proxy_set_header Host $host:$server_port;这样可以确保后端拿到正确的端口信息,避免生成的资源链接端口混乱。
相对路径与绝对路径的矛盾
后端代码中如果使用了绝对路径写死域名，反代只能解决“首屏”问题，后续加载的图片、CSS、JS还是会指向原来的域名，这种情况需要在后端代码层面把绝对路径改为相对路径,或者通过sub_filter模块做内容替换。
nginx中可以使用sub_filter对响应内容做字符串替换，这个功能默认没装，需要编译时加上--with-http_sub_module。
HSTS强制跳转导致的地址栏变化
如果你的主域名开启了HSTS（HTTP严格传输安全），浏览器会强制将http请求升级为https，这不算反代问题，但会导致一种奇怪的现象用户明明访问的是A域名，却被浏览器强制跳转到B域名的https，这是因为HSTS策略是域名级别的，一旦浏览器记住了B域名的HSTS头，后续访问B域名下的任何路径都会自动走https,与nginx反代配置无关。
遇到这种情况，需要检查后端或CDN上是否配置了HSTS，如果不需要建议关闭，或者在前端nginx上用add_header Strict-Transport-Security指令统一管理。
不同服务器环境下nginx反代的操作路径
宝塔面板操作路径
宝塔是国内用户常用的面板,操作相对直观：
- 在网站列表中添加站点,域名填你的对外域名。
- 点击该站点的“反向代理”菜单。
- 添加反代，目标URL填后端地址（可以是IP或域名）,发送域名保持默认。
- 保存后自动生成反代配置文件,也可以手动编辑nginx配置文件微调参数。
通过宝塔配置反代的优势是生成的配置已经自动带上了常见的header,适合刚入门的朋友快速搭建。
裸nginx服务器的编辑方法
不使用面板的情况下,直接配置：
vim /etc/nginx/conf.d/example.conf写入上面提供的server块配置，然后执行nginx -t 校验语法，通过后nginx -s reload平滑重载，nginx的reload是逐个worker进程平滑过渡的，不会中断已有连接,这点设计得很好。
内网穿透与证书绑定的组合处理
如果你要做“域名不变但实际访问内网服务”的穿透，且对外域名已配置SSL证书，还需要额外处理证书的问题，方案是前端nginx用443端口监听并配置证书，后端反代走http，这样浏览器端是加密的，内网转发走明文,速度和延迟都更可控。
前端nginx加分流策略与后端负载均衡的实现方式
反代不仅可以指向单台服务器，还可以配合upstream做负载均衡，当一个域名背后有多台后端服务器时,nginx会根据权重或策略分发请求。
upstream backend_servers {
server 192.168.1.11 weight=3;
server 192.168.1.12 weight=2;
}简单解释一下weight的作用：权重越高，被分配到的请求比例越大，如果想在一台服务器性能更强的情况下多分流量，给它更高的权重即可，这样不仅地址栏不变,连后端拓扑结构都完全隐藏了。
配合health_check模块，nginx还能自动踢掉宕机的后端节点，所以在部署架构中，nginx反代+加权轮询是低成本实现高可用的好办法。
借助nginx反代替换已失效JS/CSS资源链接
前面提到sub_filter模块，它不只是替换文本，还能在反代出口处对静态资源链接做统一改写，比如后端页面中引用了/old-assets/style.css，你可以在反代配置中把它统一指向新CDN链接,不需要改后端代码。
配置语法如下：
sub_filter_once off;
sub_filter_types text/html text/css application/javascript;
sub_filter '/old-assets/' 'https://cdn.example.com/';这个功能配合“域名变但地址栏不变”的使用场景非常实用，特别是在旧项目迁移期，新旧资源交替阶段,不需要动业务代码就能完成资源切换。
Q&A：nginx域名跳转地址栏不变的常见疑问
问：nginx反代和反向代理有什么区别？为什么有人说这是同一个东西？
“反向代理”是正式名称，nginx是一种实现反向代理的工具，所以你在搜索时用“nginx反代配置”和“nginx反向代理配置”，结果基本一致，唯一需要注意的是反向代理和正向代理（代理用户上网）是两个完全不同的事物,配置方式也大相径庭。
问：配置完反代后，网站后台登录一直提示“无法登录”是怎么回事？
通常指向Session或Cookie的作用域问题，Cookie是按域名隔离的，如果你后端服务种了一个domain为.backend.com的Cookie，而用户当前在www.example.com上访问，浏览器不会携带这个Cookie，解决办法是让后端读取X-Forwarded-头来判断真实客户端,或者在后端代码中将Cookie的domain改为当前域名。
问：nginx反代会降低网站访问速度吗？
多一层代理理论上多一次网络转发，但实际影响很小，nginx处理反代的性能极高，性能瓶颈更多在后端业务逻辑上，本地网络环境下反代延迟在毫秒级别，用户基本无感知，国内跨运营商访问时，反代甚至因为增加了缓存节点或压缩功能,反而能提升访问体验。
写在最后
nginx实现域名跳转但地址栏不变，说穿了就是一个proxy_pass加上几个header的问题，真正考验配置功底的是对场景的理解什么情况下该用反代、什么时候该用301、遇到重定向循环怎么去排查，记住一个核心原则：反向代理是请求的搬运工，不是地址的通知员，掌握了这个理念，不管后端结构怎么变化,前端nginx都能稳稳地守护住用户地址栏里那个域名。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/611133.html
