IIS Express为何忽略CosmosDB网络路由与hosts文件配置？

IIS Express 的网络限制说明 #

是的，IIS Express 存在导致该问题的网络行为限制，核心原因包括：

• 权限与系统配置读取限制：IIS Express 默认以普通用户身份运行，无法完全读取或应用系统级的路由表、hosts 文件修改，尤其是涉及跨接口的路由规则。
• 出站流量接口选择逻辑：IIS Express 的出站请求处理逻辑会优先使用系统默认网络接口，而非自定义路由指定的 VPN 接口，即使路由表已明确指定 CosmosDB 流量走 VPN。
• 绑定模式限制：默认仅绑定 localhost 的配置，会让 IIS Express 倾向于使用本地回环接口的网络栈，绕过外部 VPN 路由规则。

可行的解决办法 #

1. 以管理员身份运行 Visual Studio 与 IIS Express #

右键点击 Visual Studio 图标，选择「以管理员身份运行」，启动后运行你的项目。管理员权限下，IIS Express 能正确读取系统路由表和 hosts 文件的修改，遵循指定的 VPN 路由规则。

2. 修改 IIS Express 站点绑定配置 #

找到 IIS Express 的配置文件 applicationhost.config（路径通常为 %userprofile%\Documents\IISExpress\config\applicationhost.config），定位到你的项目站点节点，修改绑定规则，将绑定 IP 改为 VPN 接口的 IP 或通配符 *：

<site name="YourRestApiSite" id="1">
  <application path="/" applicationPool="Clr4IntegratedAppPool">
    <virtualDirectory path="/" physicalPath="C:\Path\To\Your\Api" />
  </application>
  <bindings>
    <!-- 替换成你的 VPN 接口 IP 或 * -->
    <binding protocol="http" bindingInformation="*:50000:192.168.10.5" />
  </bindings>
</site>

保存配置后重启 IIS Express，站点会通过 VPN 接口处理所有流量，包括出站到 CosmosDB 的请求。

3. 手动添加高优先级路由规则 #

通过命令行添加针对 CosmosDB IP 的高优先级路由，强制流量走 VPN 接口：

1. 打开命令提示符（管理员权限），执行 route print 查看 VPN 接口的索引（Interface Index）和网关 IP。
2. 添加路由规则（替换占位符为实际值）：

route add <CosmosDB_Public_IP> mask 255.255.255.255 <VPN_Gateway_IP> if <VPN_Interface_Index> metric 1

metric 1 会让这条路由优先级高于默认路由（默认 metric 通常为 10-20），确保 CosmosDB 流量优先走 VPN。

4. 用代理工具转发 CosmosDB 流量 #

使用本地代理工具（如 Fiddler）配置转发规则，将所有到 CosmosDB 的请求导向 VPN 接口：

• 在 Fiddler 中设置「自动代理配置」，添加规则：if (url.Contains("your-cosmosdb-account.documents.azure.com")) { return "PROXY your-vpn-gateway-ip:8080"; }
• 在你的 API 项目配置中，设置 HttpClient 的代理地址为 http://localhost:8888（Fiddler 默认端口），让请求通过代理走 VPN。

5. 临时添加开发机公网 IP 到 CosmosDB 防火墙（不推荐长期使用） #

如果上述方法暂时无法生效，可将开发机当前公网 IP 添加到 CosmosDB 账户的防火墙允许列表，用于临时调试。注意公网 IP 可能变动，仅作为应急方案。

内容的提问来源于stack exchange，提问作者Aleksandr Khan