IIS URL Rewrite：不会循环的重定向

核验于 2026-10-292 分钟阅读

安装 URL Rewrite，写 HTTP→HTTPS 和规范主机名规则，理解规则顺序与 stopProcessing，并在反代后面正确测试 301。

测试环境Standard / Datacenter · 版本号 26100.33650 · x64

版本号: 26100.33650
版本: Standard / Datacenter
架构: x64
支持: 文档（E1）
证据: E1官方文档
核验日期: 2026-10-29
页面类型: 任务

一句话结论

URL Rewrite 是 IIS 扩展，不是内置角色服务。它按 web.config 里的规则重写或重定向请求。

适合：

HTTP → HTTPS；
www ↔ 裸域规范主机名；
去掉尾斜杠/旧路径；
短而确定的 URL 映射。

不要拿它当反向代理。反代是 ARR；重写只改变 IIS 服务的 URL，代理是把请求转给另一台服务器。

安装与验证

从微软下载 x64 URL Rewrite 模块，安装后：

Get-WebGlobalModule -Name RewriteModule

没有这个模块，下面的规则会被忽略，或站点 500.19 “找不到模块”。

HTTP → HTTPS

<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="HTTP to HTTPS" stopProcessing="true">
          <match url="(.*)" />
          <conditions>
            <add input="{HTTPS}" pattern="^OFF$" />
          </conditions>
          <action type="Redirect"
                  url="https://{HTTP_HOST}/{R:1}"
                  redirectType="Permanent" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

{R:1} 是 (.*) 捕获的路径。
redirectType="Permanent" 发 301；测试时用 Found（302）。
stopProcessing="true" 停止后续规则。

测试：

curl.exe -I http://lab.local/
curl.exe -I https://lab.local/

第一条应返回 301 和 Location: https://...；第二条应 200，不能再次跳转。

规范主机名

<rule name="Canonical host" stopProcessing="true">
  <match url="(.*)" />
  <conditions>
    <add input="{HTTP_HOST}" pattern="^www\.example\.com$" />
  </conditions>
  <action type="Redirect" url="https://example.com/{R:1}" redirectType="Permanent" />
</rule>

规范主机名规则放在通用路径规则之前。把所有请求都跳到 https://example.com 的规则，也可能抓到健康检查路径；反代改写 Host 时会循环。

反代后的循环

在 ARR/Nginx 后面，IIS 可能看到 HTTP，即使客户端用的是 HTTPS。天真的 {HTTPS} = OFF 规则会无限重定向。

先修信任边界：

代理终止 TLS，并转发 X-Forwarded-Proto；
ARR 保留 host/proto；
再给转发头加条件，或排除代理的健康检查路径。

不要用“全局关掉 HTTPS 跳转”来修循环。

规则顺序与作用域

规则从上到下执行；stopProcessing 停止链。
站点根 web.config 会继承到应用；子应用可以清除/覆盖。
条件是 AND；多个 <add> 都要匹配。
{HTTP_HOST} 在非默认端口时可能带端口；带端口场景要小心。

验证与回滚

Get-WebConfigurationProperty -PSPath 'MACHINE/WEBROOT/APPHOST' `
  -Filter 'system.webServer/rewrite/rules' -Name '.'

保存旧 web.config，用 curl -I 测；链不对就删规则。URL Rewrite 不能替代站点配置备份。

实验室边界

本页 E1：实验室只拍了 IIS 绑定/应用池，没有安装 URL Rewrite 或测 HTTPS 跳转。XML 是起点，要在目标 Server 2025 build 上验证。