IIS ARR反向代理配置后无法转发,如何检查代理开关与后端端口
访问域名时,如果浏览器返回 502.3 Bad Gateway、长时间等待后超时,或者前端返回 404 而后端服务直接访问正常,问题通常不在“ARR是否安装”这一层,而在三个环节是否同时成立:IIS站点是否命中、ARR服务器级代理开关是否启用、URL Rewrite规则是否把请求送到了正确的后端端口。
IIS ARR反向代理排错时,不能只盯着网站绑定或后端服务状态。ARR的“Enable proxy”位于服务器级别,URL Rewrite规则通常位于具体站点的 web.config,而后端端口还需要从IIS服务器本机验证。下面按请求从外到内的路径排查,避免在没有确认故障层级前直接修改超时、开放防火墙或重启服务。

对于承载网站、业务后台和接口服务的IIS反向代理链路,A5数据提供中国香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器资源,可作为前端IIS与后端应用的部署基础。不同产品覆盖Xeon、AMD EPYC、NVMe存储、多内存及多带宽线路配置,香港和美国还提供多IP方案,便于结合访问地区、应用负载和网络需求搭建相应的业务架构。
先把现象固定下来
明确请求实际命中了哪个站点
先记录以下信息,后续每一步都使用同一组参数验证:
| 项目 | 示例 | 需要确认的内容 |
|---|---|---|
| 对外域名 | portal.example.test | DNS是否指向当前IIS服务器 |
| 前端协议和端口 | https:443 | IIS绑定是否存在 |
| IIS站点 | Portal | 请求是否命中预期站点 |
| ARR目标 | http://127.0.0.1:8080 | 目标主机、协议和端口是否正确 |
| 健康检查路径 | /health | 后端是否提供这个路径 |
| 异常时间 | 2025-01-01 10:20 | 便于关联IIS日志和后端日志 |
上表中的域名、端口和时间仅用于说明排查方式,不代表读者环境中的实际配置。
在Windows Server上打开管理员PowerShell,先查看站点和绑定:
Import-Module WebAdministration
Get-Website | Select-Object Name, Id, State, PhysicalPath
Get-WebBinding -Name "Portal" |
Select-Object protocol, bindingInformation, sslFlags
如果 Portal 不存在,或者绑定信息中没有请求使用的主机名和端口,先修正站点绑定。若多个站点共用同一个IP和端口,还要检查主机名绑定是否冲突。绑定错误时,后续检查ARR开关没有意义,因为请求可能根本没有进入目标站点。
可以在IIS服务器本机使用 curl.exe 验证指定绑定。HTTPS测试通常需要临时忽略测试证书错误,-k只适合诊断,不应作为生产配置的解决方案:
curl.exe --noproxy "*" -vk --resolve portal.example.test:443:127.0.0.1 https://portal.example.test/health
如果前端使用HTTP绑定,可改为:
curl.exe --noproxy "*" -i -H "Host: portal.example.test" http://127.0.0.1/health
这一步的判断重点不是后端是否返回成功,而是请求是否进入了正确的IIS站点。若返回的是站点自定义页面、IIS默认页面或其他站点内容,应先处理绑定、主机名或DNS问题。
根据状态码判断优先级
常见现象可以先按以下方向分类:
| 现象 | 优先检查方向 | 结果含义 |
|---|---|---|
| 404,且后端没有访问记录 | URL Rewrite规则、规则顺序、请求路径 | 请求可能没有被转发 |
| 404,后端也有访问记录 | 后端路由或重写后的路径 | ARR已经连接到后端 |
| 502.3或网关超时 | 后端端口、监听地址、防火墙、协议 | ARR无法建立或完成后端请求 |
| 401/403 | 后端认证、Host头、访问控制 | 网络通常已经连通 |
| 500 | 后端应用异常或IIS配置错误 | 需要查看对应层的错误日志 |
| 访问出现循环重定向 | HTTP/HTTPS识别、Host头、应用代理配置 | 前后端对原始协议的理解不一致 |
502.3经常与后端连接失败、响应超时或上游返回无效响应有关,但不能仅凭状态码断定具体原因。必须继续检查后端端口和日志。
由外到内检查ARR链路
1. 确认服务器级代理开关
IIS ARR的代理开关不在具体网站的“URL Rewrite”页面中,而是在服务器节点下:
- 打开IIS Manager。
- 在左侧选择服务器节点,而不是某个网站。
- 打开 Application Request Routing Cache。
- 在右侧选择 Server Proxy Settings。
- 确认 Enable proxy 已勾选。
- 点击应用保存。
这个开关是ARR执行转发的前提。只配置URL Rewrite规则而没有启用它,规则可能看起来正确,但请求不会按预期转发。

也可以使用命令检查当前值:
Import-Module WebAdministration
Get-WebConfigurationProperty `
-PSPath "MACHINE/WEBROOT/APPHOST" `
-Filter "system.webServer/proxy" `
-Name "enabled"
预期结果应为 True。也可以通过 appcmd查看完整的代理配置:
& "$env:windir\system32\inetsrv\appcmd.exe" list config /section:system.webServer/proxy
输出中应能看到类似以下内容:
<proxy enabled="true" />
如果提示找不到 system.webServer/proxy 配置节,可能是ARR组件未正确安装、组件版本不匹配,或者当前命令运行在不包含该配置架构的服务器环境中。此时不要直接把未知配置节手工写入 applicationHost.config,应先确认ARR和URL Rewrite的安装状态。
启用开关属于服务器级变更,可能影响同一台服务器上依赖ARR的其他站点。修改前可以备份IIS全局配置:
& "$env:windir\system32\inetsrv\appcmd.exe" add backup "Before-ARR-Proxy-Change"
确认需要启用后,再执行:
& "$env:windir\system32\inetsrv\appcmd.exe" set config /section:system.webServer/proxy /enabled:true
如果原配置是关闭状态且启用后发现其他站点受到影响,回滚为:
& "$env:windir\system32\inetsrv\appcmd.exe" set config /section:system.webServer/proxy /enabled:false
回滚前要确认该开关的原始值,避免误关闭其他正在使用ARR的站点。
2. 检查站点是否存在有效的URL Rewrite规则
ARR代理开关只允许IIS执行代理转发,不会自动知道请求应该发往哪个后端。具体目标通常由URL Rewrite规则定义。
使用以下命令查看 Portal站点的规则:
& "$env:windir\system32\inetsrv\appcmd.exe" list config "Portal" /section:system.webServer/rewrite/rules
如果站点使用独立的 web.config,也可以进入网站根目录检查 system.webServer/rewrite/rules。一个简单的HTTP反向代理规则示例如下:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.webServer>
<rewrite>
<rules>
<rule name="ReverseProxyToBackend" stopProcessing="true">
<match url="(.*)" />
<action type="Rewrite"
url="http://127.0.0.1:8080/{R:1}"
appendQueryString="true" />
</rule>
</rules>
</rewrite>
</system.webServer>
</configuration>
示例中的目标含义是:把访问前端站点的路径转发到本机 127.0.0.1:8080,并保留原查询字符串。它不是通用的生产配置,实际使用时需要根据后端应用的路径规则调整。
检查规则时重点看以下内容:
match是否能够匹配当前请求路径。action中的协议是否与后端实际协议一致。- 目标主机是否写成了正确的服务器地址。
- 目标端口是否为后端监听端口,而不是前端端口。
- 是否存在更早执行且
stopProcessing="true"的规则。 - 是否有其他重定向、静态文件或访问控制规则先处理了请求。
- 后端是否需要去掉前缀,例如前端使用
/app/,后端实际只接受/。 - URL Rewrite模块是否已经安装并被IIS识别。
修改现有 web.config前,先在网站目录中备份当前文件。以下命令应在站点根目录执行:
Copy-Item .\web.config ".\web.config.bak-$(Get-Date -Format yyyyMMddHHmmss)"
不要直接用示例内容覆盖完整的 web.config,因为原文件可能还包含认证、压缩、缓存、MIME类型和其他站点规则。建议只合并必要的 rewrite节点,修改后通过IIS配置检查确认XML格式没有错误。
如果增加规则后出现 500.19 或配置节错误,通常说明XML结构、模块安装或配置继承存在问题。此时应先移除本次新增的规则,恢复备份文件,再继续确认URL Rewrite模块状态,而不是反复修改代理端口。
3. 从IIS服务器本机检查后端端口
后端端口必须从运行IIS ARR的服务器上测试。不能只在个人电脑上打开后端地址,因为浏览器所在设备与ARR服务器看到的 localhost 不是同一台机器。
先检查本机是否有程序监听目标端口。以下以 8080为例:
$port = 8080
Get-NetTCPConnection -State Listen -LocalPort $port -ErrorAction SilentlyContinue |
Select-Object LocalAddress, LocalPort, OwningProcess
如果返回进程ID,可以继续查看进程:
Get-Process -Id <PID>
也可以使用传统命令查看:
netstat -ano | findstr ":8080"
判断时要区分以下情况:
- 没有监听记录:后端服务没有启动、实际使用了其他端口,或者服务启动失败。
- 监听在
127.0.0.1:8080:只能由本机访问,适用于后端和ARR位于同一台服务器的场景。 - 监听在服务器内网IP:本机和其他允许的主机可以按该地址连接。
- 监听在IPv6地址而规则使用IPv4地址:可能出现连接失败,需要使用实际可达的地址。
- 监听端口与Rewrite目标不同:IIS即使代理开关正常,也会把请求发到错误位置。
再测试TCP连通性:
Test-NetConnection 127.0.0.1 -Port 8080 -InformationLevel Detailed
如果结果为 TcpTestSucceeded : True,只说明TCP连接可以建立,不代表HTTP应用一定正常。继续访问后端健康检查路径:
curl.exe --noproxy "*" -i --max-time 10 http://127.0.0.1:8080/health
返回结果的解释如下:

200或204:后端基本可访问,可以继续检查Rewrite规则、请求头和响应处理。301或302:后端在重定向,需确认重定向地址是否仍然指向前端域名,以及是否形成循环。401或403:端口可达,但需要检查认证方式、Host头或应用访问策略。404:端口可达,健康检查路径可能不存在;换成后端确定存在的业务路径验证。500:后端应用已经收到请求,应优先查看后端应用日志。- 连接拒绝:目标端口没有可用监听,或服务拒绝连接。
- 连接超时:重点检查路由、防火墙、监听地址和服务是否卡住。
如果Rewrite规则的目标是远程后端,例如 http://10.10.20.15:8080,则必须从IIS服务器测试远程地址:
Test-NetConnection 10.10.20.15 -Port 8080 -InformationLevel Detailed
curl.exe --noproxy "*" -i --max-time 10 http://10.10.20.15:8080/health
测试结果为超时,不要马上扩大防火墙放行范围。先核对目标IP、路由和后端监听地址,再按照网络变更流程只允许IIS服务器到目标端口的必要访问。
4. 排除目标端口写错或形成代理回环
前端端口和后端端口是两个不同概念。例如:
客户端 -> https://portal.example.test:443 -> IIS ARR -> http://127.0.0.1:8080
这里的 443是IIS对外监听端口,8080是后端应用监听端口。不能因为前端使用443,就把Rewrite目标也写成443。
尤其要检查以下错误:
IIS前端监听 80
Rewrite目标也写成 http://127.0.0.1:80
这可能把请求再次送回IIS自身,形成代理回环,表现为重复请求、超时或502错误。
同样,规则中的 localhost指的是IIS服务器本机。如果后端实际运行在另一台服务器,下面的配置就是错误的:
<action type="Rewrite" url="http://localhost:8080/{R:1}" />
远程后端应使用实际可达的主机名或内网IP,并确保DNS解析结果符合预期。
5. 检查Host头、协议和路径
后端服务有时按照Host头选择站点。如果后端只接受 app.internal.test,而ARR转发时使用了 portal.example.test或 127.0.0.1:8080,可能出现404、400或认证失败。
ARR的代理配置中常见相关属性包括:
<proxy enabled="true"
preserveHostHeader="false"
reverseRewriteHostInResponseHeaders="true" />
preserveHostHeader会影响后端收到的Host头。是否设置为 true,取决于后端应用的虚拟主机和路由设计:
- 后端需要根据公网域名路由时,可能需要保留原始Host。
- 后端只配置了内部主机名时,直接传递公网Host可能导致找不到站点。
- 后端使用固定绑定但没有正确配置Host时,需要先修正后端绑定,不宜仅靠ARR掩盖问题。
如果前端为HTTPS、后端为HTTP,还要确认应用是否正确识别原始请求协议。常见现象是前端访问后端后,后端又把请求重定向到HTTPS,ARR再次转发后形成循环。此时需要同时检查应用对代理请求头的处理、重定向策略和前端TLS终止方式,不要仅通过不断增加重定向或超时配置解决。
如果Rewrite目标使用HTTPS,例如:
<action type="Rewrite" url="https://backend.example.test:8443/{R:1}" />
还要从IIS服务器验证后端证书的名称、信任链、SNI和协议版本。使用 curl.exe -k得到的成功结果只能证明服务端口可响应,不能证明ARR在正常证书校验下也能连接。
使用日志确认请求停在哪一层
查看IIS访问日志
先查找站点ID:
& "$env:windir\system32\inetsrv\appcmd.exe" list sites
IIS默认日志通常位于:
%SystemDrive%\inetpub\logs\LogFiles\W3SVC<站点ID>\
重点关注与测试时间对应的日志行和字段:
cs-host:请求使用的主机名。cs-uri-stem:请求路径。sc-status:返回状态码。sc-substatus:IIS细分状态。sc-win32-status:底层Windows错误码。time-taken:IIS处理请求耗时。
如果前端访问日志中没有这次请求,说明DNS、负载均衡、端口监听或站点绑定仍有问题。如果IIS日志有请求,但后端日志没有对应记录,重点回到代理开关、Rewrite规则、端口和网络连通性。如果后端日志有记录,则ARR已经完成了基本转发,应检查后端响应、Host头、路径和应用日志。

必要时启用失败请求跟踪
对于普通502、404信息不足的情况,可以在目标站点临时启用Failed Request Tracing,针对 500-599或特定状态码创建规则。它适合用来观察请求是否进入Rewrite模块,以及在哪个模块返回错误。
启用前要确认日志目录空间足够,并限定在测试时间段使用。问题确认后应关闭不再需要的跟踪规则,避免持续产生大量诊断文件。FREB日志仍需要结合IIS访问日志和后端日志判断,不能把单一模块的记录当成完整链路证据。
根据检查结果分支处理
ARR代理开关为关闭
如果URL Rewrite规则存在、后端端口也能从本机访问,但服务器级 enabled 为 False,应先记录原值,再在维护窗口启用代理开关。启用后只用一个已知健康路径复测,不要同时修改端口、Host头和超时,避免无法判断是哪项变更生效。
代理开关已开启,但没有有效Rewrite规则
这种情况下ARR具备代理能力,但没有明确的后端目标。检查站点级 web.config、规则继承和规则顺序。若新增规则,保留原有规则并设置清晰的规则名称;不要用整份示例文件覆盖生产配置。
Rewrite规则存在,但后端端口测试失败
优先修复后端服务、监听地址或端口配置。端口没有监听时,修改ARR超时不会让服务恢复;远程连接超时时,也不应直接把目标端口暴露给所有来源。
如果后端应用原本应监听8080,却实际监听8090,应在Rewrite目标和后端服务配置之间选择正确的一方,并重启后端服务前确认其启动方式、配置文件和回滚方案。对于由服务管理器、IIS应用池或其他进程托管的应用,先确认服务状态和启动日志。
后端直连正常,但外部访问仍返回404或502
这时优先检查:
- 外部请求是否命中正确的IIS站点。
- Rewrite规则是否匹配外部路径。
- 目标URL是否多了或少了路径前缀。
- 后端是否依赖特定Host头。
- 前后端协议是否产生重定向循环。
- 是否有其他Rewrite规则提前终止处理。
- 后端响应头中的主机名或Location是否需要重写。
如果后端访问日志已经记录了请求,说明不应继续反复切换ARR代理开关,应把排查重点放到应用路由、请求头和响应内容。
访问偶尔成功、偶尔502
间歇性故障需要同时比较IIS和后端同一时间段的日志,重点看后端进程重启、连接数、响应耗时和错误峰值。不要一开始就把ARR超时无限调大,因为这可能只是延后错误,并增加前端连接占用。
如果后端只有在高并发或长请求场景下失败,应分别确认应用处理能力、连接池、进程回收策略和ARR超时是否匹配。每次只调整一个参数,并记录调整前后的错误率和响应时间。
修复后的验证顺序
完成修改后,按以下顺序复测:
- 在IIS服务器本机直接访问后端健康检查地址,确认协议、主机和端口与Rewrite目标一致。
- 使用指定Host访问前端站点,确认请求命中了目标绑定。
- 访问一个不依赖复杂业务逻辑的静态或健康检查路径。
- 再测试真实业务路径,包括查询字符串和必要的请求方法。
- 对照IIS访问日志,确认状态码、处理时间和请求路径。
- 对照后端日志,确认请求确实到达目标服务,并且路径和Host符合预期。
- 如果前端使用HTTPS,再检查证书、重定向和浏览器最终地址是否正常。
例如,后端和前端都应能对健康检查路径返回成功响应:
curl.exe --noproxy "*" -i --max-time 10 http://127.0.0.1:8080/health
curl.exe --noproxy "*" -vk --resolve portal.example.test:443:127.0.0.1 https://portal.example.test/health
两次请求不一定返回完全相同的响应头,但应能确认两件事:第一条证明后端端口和应用路径可用,第二条证明IIS绑定、ARR开关和Rewrite链路能够完成转发。
如果本次修改涉及全局代理开关,应在同一台服务器上的其他ARR站点执行至少一次基础访问验证。确认业务恢复后,继续观察一段实际业务周期内的502、超时和后端进程日志,例如持续观察10到15分钟或覆盖一次常规流量高峰。只有当IIS日志、后端日志和外部访问结果都一致,才可以认为问题已经从配置层闭环,而不是暂时绕过了错误。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5012.html
