如何合并web.config实现IIS启动Golang服务并反向代理

核心逻辑 #

用AspNetCoreModuleV2自动拉起你的Golang可执行文件，同时通过URL重写规则把IIS收到的请求转发到Go服务监听的端口——不用手动启动Go服务，IIS会帮你搞定启动+转发的全流程。

完整web.config配置 #

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <!-- 配置AspNetCoreModuleV2自动启动Go服务 -->
    <aspNetCore processPath=".\your-go-service.exe" 
                arguments="" 
                stdoutLogEnabled="true" 
                stdoutLogFile=".\logs\stdout"
                hostingModel="OutOfProcess">
      <environmentVariables>
        <!-- 给Go服务指定监听端口，也可以让Go程序读取这个变量 -->
        <environmentVariable name="GO_SERVICE_PORT" value="5000" />
      </environmentVariables>
    </aspNetCore>

    <!-- URL重写规则：把所有请求转发到Go服务 -->
    <rewrite>
      <rules>
        <rule name="ProxyToGo" stopProcessing="true">
          <match url="(.*)" />
          <action type="Rewrite" url="http://localhost:5000/{R:1}" />
          <!-- 若Go服务用HTTPS，改成https://localhost:5000/{R:1} -->
        </rule>
      </rules>
    </rewrite>

    <!-- 移除冲突模块，确保AspNetCoreModuleV2正常工作 -->
    <modules>
      <remove name="WebDAVModule" />
    </modules>
    <handlers>
      <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
    </handlers>
  </system.webServer>
</configuration>

关键细节说明 #

1. 执行顺序：IIS启动时会先加载aspNetCore节点配置，自动运行你的Go可执行文件（启动时Go程序可以读取环境变量GO_SERVICE_PORT获取监听端口）。当有请求进入IIS时，URL重写规则会立刻把请求转发到localhost:5000（也就是刚启动的Go服务），整个流程自动串联，无需手动干预。
2. Go程序适配：要让你的Go服务监听指定端口，示例代码片段：

package main

import (
	"net/http"
	"os"
)

func main() {
	// 读取环境变量，没有的话用默认端口5000
	port := os.Getenv("GO_SERVICE_PORT")
	if port == "" {
		port = "5000"
	}
	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		w.Write([]byte("Go service running behind IIS!"))
	})
	// 监听所有IP的指定端口，确保IIS能访问到
	http.ListenAndServe(":"+port, nil)
}

3. IIS必备组件：必须安装两个模块：
   • ASP.NET Core Hosting Bundle：包含AspNetCoreModuleV2，用来托管非.NET的可执行文件
   • URL Rewrite：实现反向代理功能
     这两个组件可以通过服务器管理器的「添加角色和功能」安装，或者直接下载官方安装包。
4. 日志与权限：
   • 开启stdoutLogEnabled后，Go服务的控制台输出会写到logs/stdout文件，方便排查启动失败问题
   • IIS应用池的运行身份需要有Go可执行文件目录和日志目录的读写权限

常见问题排查 #

• Go服务启动失败：查看logs/stdout日志，检查端口是否被占用、可执行文件路径是否正确（相对路径是相对于IIS站点根目录）
• 反向代理无响应：确认URL Rewrite模块已安装，规则中的端口和Go服务监听的端口完全一致
• 权限报错：给应用池身份分配站点目录的读写权限

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