当前位置:首页 > 文章列表 > Golang > Go问答 > 反向代理请求

反向代理请求

来源:17golang原创 2026-11-11 15:44:04 0浏览 收藏

用 Go 写反向代理时,最容易混淆的是“客户端发给代理的请求”和“代理准备发给后端的请求”。如果你要修改后端看到的 Host、路径或协议,应当操作 httputil.ProxyRequest.Out,而不是 ProxyRequest.In。在现代 Go 写法中,用 ReverseProxy.Rewrite 接收这个结构体,再按路由规则决定是否覆盖 Out.Host。

一句话结论:r.SetURL(target) 负责改出站 URL,并会把出站 Host 交给目标主机;需要保留客户端原始 Host 时,在它后面写 r.Out.Host = r.In.Host。不要把 Host 当成普通的 Header 项来改。

先分清 In、Out、URL 和 Host

ProxyRequest.In 是代理收到的请求,官方文档明确要求 Rewrite 不要修改它;ProxyRequest.Out 才是即将交给 Transport 的出站请求。URL 中的 Scheme、Host 和 Path 描述请求目标,而 http.Request.Host 是发送时使用的 Host 语义。它们不是同一个字段。

反向代理中 In、Out、URL 和 Host 的静态关系说明图
图1:结构说明图,展示入站请求与出站请求的字段边界,不是运行结果或终端截图。

因此,下面这种思路是不对的:先把 r.In.Host 改成后端域名,再期待代理自动使用它。这样既破坏了入站语义,也没有明确修改将要发送的请求。

用 Rewrite 和 SetURL 建立最小代理

SetURL 适合把出站请求路由到固定目标。它会改写出站请求的协议、主机和基础路径,同时将 Out.Host 置空,让发送逻辑使用目标 URL 的主机。示例中的每个关键判断都放在 Rewrite 内,便于把“路由目标”和“Host 语义”分开。

package main

import (
    "log"
    "net/http"
    "net/http/httputil"
    "net/url"
)

func main() {
    target, err := url.Parse("http://backend.internal:8080/base")
    if err != nil {
        log.Fatal(err) // 目标地址解析失败时不要启动半配置的代理。
    }

    proxy := &httputil.ReverseProxy{
        Rewrite: func(r *httputil.ProxyRequest) {
            r.SetURL(target) // 修改 Out.URL,并默认让 Host 跟随目标主机。
            r.SetXForwarded() // 由标准库写入来源相关的转发头。
        },
    }

    log.Fatal(http.ListenAndServe(":8080", proxy)) // 代理作为 Handler 接收客户端请求。
}

这里不要把图示当成已经运行过的结果:它只是帮助区分字段的静态结构。真实项目还要按自身的域名信任、路径拼接和后端路由约定补充配置。

什么时候覆盖 Out.Host

如果后端虚拟主机依赖目标域名,保留 SetURL 的默认行为即可;如果后端必须看到客户端原始 Host,例如多租户路由由入口域名决定,则在 SetURL 后显式复制入站 Host:

proxy := &httputil.ReverseProxy{
    Rewrite: func(r *httputil.ProxyRequest) {
        r.SetURL(target)       // 先确定实际连接的后端目标。
        r.Out.Host = r.In.Host // 再保留客户端请求的 Host 语义。
        r.SetXForwarded()      // X-Forwarded-Host 记录入站 Host,供后端审计或路由。
    },
}

这两个选择不是“哪个字段更正确”,而是后端如何识别站点:连接地址由 Out.URL 决定,Host 语义由 Out.Host 决定,来源记录则由 X-Forwarded-Host 等头表达。三者用途不同,不能用改 Header 的方式代替 Out.Host。

反向代理目标 Host 与入站 Host 选择关系说明图
图2:结构说明图,对比目标 Host、入站 Host 与 X-Forwarded-Host 的选择边界,不是软件界面截图。

Rewrite、Director 和转发头的取舍

新代码优先使用 Rewrite,因为它直接提供 ProxyRequest.In 与 ProxyRequest.Out 两个角色。旧代码中的 Director 仍可工作,但它返回后还会进行 hop-by-hop 头处理,某些在 Director 中加入的头可能被移除;文档建议需要确保改动保留时使用 Rewrite。

SetXForwarded 会设置 X-Forwarded-For、X-Forwarded-Host 和 X-Forwarded-Proto。如果代理前面还有不可信代理,不要无条件信任客户端传入的转发头;应先按自己的信任边界清理或重建它们。最后,Rewrite 只负责改写请求,响应体关闭、超时和后端错误仍应由完整服务配置负责。

常见问题

Q:为什么改了 Header.Set("Host", ...) 后后端仍然看到旧值?
因为 Host 有独立的 Request.Host 语义,反向代理场景应修改 r.Out.Host;普通 Header 映射不是可靠替代。

Q:SetURL 后应该写目标 Host 还是 In.Host?
后端按目标域名做虚拟主机路由时保留默认值;后端按入口域名识别租户时写 r.Out.Host = r.In.Host,并用转发头记录来源。

Q:能不能直接修改 In?
不建议。In 是代理收到的原始请求,Rewrite 的职责是构造 Out,保留两者的边界更容易排查路由和审计问题。

官方资料:https://pkg.go.dev/net/http/httputil#ProxyRequest、https://pkg.go.dev/net/http/httputil#ReverseProxy、https://go.dev/src/net/http/httputil/reverseproxy.go

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Cookie 隔离
下一篇
Cookie 隔离
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    982次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    986次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1105次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1075次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    916次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码