Golang Echo服务器反向代理：使用Director路由请求遇问题

场景需求 #

通过Echo服务器实现反向代理，将公网请求转发至VPN内设备群：

• https://forward.example.com/hub-001 → https://vpn.hub-001
• https://forward.example.com/hub-001/sub0/sub1 → https://vpn.hub-001/sub0/sub1

遇到的问题 #

• 不设置req.Host时，根路径可正常加载，但设备返回的链接/子目录会触发301循环重定向
• 将req.Host设为VPN地址或空值时，浏览器URL会直接跳转到https://fwdAddress，代理完全失效

问题原因 #

1. 301循环：后端服务收到的请求Host是公网域名forward.example.com，重定向时会生成带该Host的URL，代理再次转发后又触发相同逻辑，形成循环。
2. VPN地址暴露：设置req.Host为VPN地址后，后端重定向响应的Location头会直接指向VPN地址，浏览器直接跳转，跳过代理。

解决方案 #

核心思路：保持请求Host为前端公网域名，同时修正后端返回的重定向Location头，将VPN地址替换为前端转发域名。

修正后的代码：

reverseProxyServer.Any("/*", func(c echo.Context) error {
	reqOuter := c.Request()
	res := c.Response().Writer

	// 解析请求中的hub标识和剩余路径
	fwdId, pathRemainder := getFwdId(reqOuter.RequestURI)
	fwdAddress := getVpnAddress(fwdId) // 假设此函数根据fwdId获取对应VPN地址
	target, _ := url.Parse("https://" + fwdAddress)

	proxyEntry := &httputil.ReverseProxy{
		Director: func(req *http.Request) {
			// 设置转发后的URL
			req.URL.Scheme = target.Scheme
			req.URL.Host = target.Host
			req.URL.Path = "/" + pathRemainder
			// 保留原始Host，避免后端重定向出错
			// 传递X-Forwarded头，让后端知道真实请求信息
			req.Header.Set("X-Forwarded-Host", req.Host)
			req.Header.Set("X-Forwarded-Proto", req.URL.Scheme)
			req.Header.Set("X-Forwarded-For", req.RemoteAddr)
		},
		// 修改响应中的Location头，替换VPN地址为前端域名
		ModifyResponse: func(resp *http.Response) error {
			if loc := resp.Header.Get("Location"); loc != "" {
				// 将https://vpn.hub-001/xxx替换为https://forward.example.com/hub-001/xxx
				newLoc := strings.Replace(loc, target.String(), "https://forward.example.com/"+fwdId, 1)
				resp.Header.Set("Location", newLoc)
			}
			return nil
		},
	}

	proxyEntry.ServeHTTP(res, reqOuter)
	return nil
})

关键说明 #

1. 保留原始Host：不修改req.Host，让后端服务基于公网域名生成重定向路径，同时通过X-Forwarded-*头传递真实请求信息给后端。
2. 重写Location头：通过ModifyResponse拦截后端的重定向响应，将VPN地址替换为前端转发域名，避免浏览器直接跳转至VPN地址。
3. 路径解析：确保getFwdId能正确从请求URI中提取hub-001这类标识，以及剩余的子路径部分。

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