Golang实现HTTP代理方法详解

从现在开始，努力学习吧！本文《Golang实现HTTP代理教程》主要讲解了等等相关知识点，我会在golang学习网中持续更新相关的系列文章，欢迎大家关注并积极留言建议。下面就先一起来看一下本篇正文内容吧，希望能帮到你！

Go实现HTTP代理的核心是监听请求、转发并回传响应，需支持CONNECT隧道、正确处理Host/URL头、保持连接复用与流式转发；推荐使用httputil.NewSingleHostReverseProxy配合Director函数动态设置目标地址。

用 Go 实现一个基础 HTTP 代理并不复杂，核心在于监听请求、转发并回传响应。Go 标准库的 net/http 提供了足够支持，无需第三方框架。

理解代理的基本工作流程

HTTP 代理本质是中间人：客户端把请求发给代理，代理解析目标地址（如 GET http://example.com/ HTTP/1.1 中的完整 URL），发起新请求，再把响应原样返回。关键点在于：

• 支持 CONNECT 方法（用于 HTTPS 隧道）
• 正确处理 请求头中的 Host 和 URL 字段
• 保持连接复用和响应体流式转发（避免内存堆积）

实现一个简单正向代理

以下是最简可行代码，监听本地 8080 端口，支持普通 HTTP 请求：

package main

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

func main() {
    proxy := &http.Transport{}
    
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        // 解析客户端请求中的目标 URL（如 GET http://a.com/...）
        u, err := url.Parse(r.URL.String())
        if err != nil || u.Scheme == "" || u.Host == "" {
            http.Error(w, "invalid request URI", http.StatusBadRequest)
            return
        }

        // 构造新请求（注意：r.URL 是相对路径，需用原始 URL 重建）
        // 更稳妥的做法是用 httputil.NewSingleHostReverseProxy，但这里演示手动逻辑
        // 实际中推荐直接用 ReverseProxy，见下文
        dump, _ := httputil.DumpRequest(r, false)
        log.Printf("Proxying: %s %s", r.Method, u.String())

        // 简单转发：用 Transport 发起请求
        req, _ := http.NewRequest(r.Method, u.String(), r.Body)
        for k, vs := range r.Header {
            for _, v := range vs {
                req.Header.Add(k, v)
            }
        }
        req.Header.Set("X-Forwarded-For", r.RemoteAddr)

        resp, err := proxy.RoundTrip(req)
        if err != nil {
            http.Error(w, err.Error(), http.StatusBadGateway)
            return
        }
        defer resp.Body.Close()

        // 复制响应状态码与头信息
        for k, vs := range resp.Header {
            for _, v := range vs {
                w.Header().Add(k, v)
            }
        }
        w.WriteHeader(resp.StatusCode)
        io.Copy(w, resp.Body)
    })

    log.Println("Starting proxy on :8080")
    log.Fatal(http.ListenAndServe(":8080", nil))
}

更推荐：用 httputil.NewSingleHostReverseProxy

标准库提供了更健壮的反向代理工具，稍加改造即可做正向代理：

package main

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

func main() {
    proxy := httputil.NewSingleHostReverseProxy(&url.URL{
        Scheme: "http",
        Host:   "dummy", // 占位，实际由 Director 动态设置
    })

    proxy.Director = func(r *http.Request) {
        // 从原始请求中提取目标地址（如 GET http://x.y/z）
        if r.URL.IsAbs() {
            // 已是绝对 URL，直接使用（常见于浏览器发送的正向代理请求）
            // 注意：r.URL.Scheme 和 r.URL.Host 可能为空，需检查
            if r.URL.Scheme != "" && r.URL.Host != "" {
                r.URL.Scheme = r.URL.Scheme
                r.URL.Host = r.URL.Host
                r.Host = r.URL.Host
            }
        } else {
            // 否则按需构造，或拒绝（非代理模式请求）
            http.Error(r.Context().Value(http.ResponseWriter).(http.ResponseWriter),
                "only absolute URIs are allowed", http.StatusBadRequest)
            return
        }
    }

    // 处理 CONNECT 方法（HTTPS 隧道）
    proxy.ModifyResponse = func(resp *http.Response) error {
        // 可选：修改响应头
        return nil
    }

    log.Println("Proxy server starting on :8080")
    log.Fatal(http.ListenAndServe(":8080", proxy))
}

⚠️ 注意：NewSingleHostReverseProxy 默认不支持动态目标，所以必须配合 Director 函数重写 r.URL 和 r.Host。对 HTTPS，还需单独处理 CONNECT 请求（通常用 http.Server 的 Handler + 自定义逻辑）。

支持 HTTPS（CONNECT 隧道）的要点

浏览器访问 HTTPS 站点前，会先发 CONNECT example.com:443 HTTP/1.1 请求。代理需建立 TCP 隧道，不做 HTTP 解析：

• 收到 CONNECT 时，解析目标 host:port
• 用 net.Dial 连接目标服务器
• 用 io.Copy 在客户端连接和目标连接之间双向拷贝数据
• 返回 200 Connection Established

这部分逻辑需在 http.Server 的 Handler 中单独判断方法，不能走常规 HTTP 路由。

基本上就这些。Golang 写代理轻量、可控、性能好，适合定制化场景（如日志审计、权限控制、缓存）。生产环境建议基于 httputil.ReverseProxy 扩展，并补全超时、重试、TLS 配置等细节。

到这里，我们也就讲完了《Golang实现HTTP代理方法详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！