IIS 10.0共享主机环境下如何实现web.config引入通用重写规则并支持站点自定义规则扩展

在共享主机环境下，你可以通过IIS URL Rewrite模块提供的<include>指令来实现通用规则共享+站点专属规则的需求，这也是目前最适合你场景的方案。下面是具体的实现步骤和细节：

为什么你之前的方案失败？ #

先帮你排查下之前file属性方案的问题：当你给<rules>设置file属性时，外部文件的内容是直接插入到<rules>节点下，不需要再用<rules>标签包裹。你之前的rules.config里包含了<rules>根节点，这就导致IIS无法正确解析规则，所以外部规则没生效。不过即使修正这个问题，file属性也会完全替换当前<rules>节点的内容，没法添加站点专属规则，所以更推荐用<include>。

正确实现步骤 #

1. 确认URL Rewrite版本 #

确保你的IIS 10.0上安装了URL Rewrite 2.0及以上版本（IIS 10默认自带的版本通常满足要求，若不确定可以在IIS管理器的模块列表里查看）。

2. 创建通用规则文件 #

在你的站点根目录（或者所有站点都能访问的共享目录，比如账户根下的config文件夹）创建一个通用规则文件，比如common-rewrite-rules.config。注意这个文件不需要包裹在<rules>标签里，直接写规则即可：

<clear />
<!-- 示例通用规则：强制HTTPS -->
<rule name="Common - Force HTTPS" stopProcessing="true">
  <match url="(.*)" />
  <conditions>
    <add input="{HTTPS}" pattern="off" ignoreCase="true" />
  </conditions>
  <action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="Permanent" />
</rule>
<!-- 添加其他通用重写/重定向规则 -->
<rule name="Common - Remove Trailing Slash" stopProcessing="true">
  <match url="(.*)/$" />
  <conditions>
    <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
    <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
  </conditions>
  <action type="Redirect" url="{R:1}" redirectType="Permanent" />
</rule>

3. 在站点web.config中引入通用规则+添加专属规则 #

在每个站点的web.config里，找到<system.webServer><rewrite><rules>节点，用<include>指令引入通用规则文件，然后在后面添加站点专属规则即可：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <!-- 其他配置 -->
    <rewrite>
      <rules>
        <!-- 引入通用规则文件，路径为相对站点根目录的路径 -->
        <include file="../config/common-rewrite-rules.config" />
        <!-- 如果通用文件就在当前站点根目录，直接写file="common-rewrite-rules.config" -->
        
        <!-- 站点专属规则示例 -->
        <rule name="Site-Specific - Rewrite Blog URLs" stopProcessing="false">
          <match url="^legacy-blog/(.*)$" />
          <action type="Rewrite" url="new-blog/{R:1}" />
        </rule>
      </rules>
    </rewrite>
    <!-- 其他配置 -->
  </system.webServer>
</configuration>

关键注意事项 #

• 路径问题：<include>的file属性使用相对路径，相对于当前web.config所在的目录。如果通用文件放在账户根目录下的共享文件夹（比如所有站点的父目录），可以用../来向上导航（比如../shared/common-rules.config）。
• 权限问题：确保共享主机允许读取外部配置文件，大部分共享主机默认允许，但如果遇到加载失败的情况，可以联系主机服务商确认目录权限。
• 规则执行顺序：规则会按照文件中的顺序执行，通用规则在前，站点专属规则在后，你可以根据需求调整顺序。

内容的提问来源于stack exchange，提问作者Marcel V.