Go 语言发起 HTTP 代理请求代码示例

发起 Go HTTP 代理请求不需要任何第三方依赖：标准库 net/http 的 Transport 结构体暴露了 Proxy 字段，传入代理函数即可让该客户端的全部请求经代理转发。默认的 DefaultTransport 本身会读取 HTTP_PROXY、HTTPS_PROXY 环境变量，而自定义 Transport 则需要显式配置。本文讲解 Proxy 字段的灵活用法、代理池轮换、SOCKS5 拨号与超时设置，并给出可直接运行的完整示例。

环境准备与标准库的优势

确保本机安装 Go 1.20 以上版本，执行 go mod init example.com/proxydemo 初始化模块即可开工。代理能力完全由标准库 net/http 与 net/url 提供，go.mod 保持干净；Go 的交叉编译特性也让同一份代理代码能轻松发布到 Linux 服务器上运行。

零依赖：仅需标准库 net/http 与 net/url，无需引入第三方包。
并发友好：同一个 http.Client 可被多个 goroutine 安全复用，连接池自动管理。
环境变量：http.ProxyFromEnvironment 支持 HTTP_PROXY、HTTPS_PROXY 与 NO_PROXY 三个变量。

http.Transport 的 Proxy 字段详解

Proxy 字段的类型是 func(*http.Request) (*url.URL, error)，每个请求发出前都会调用一次。http.ProxyURL(proxyURL) 把固定代理包装成这种函数；你也可以自己编写闭包，根据请求的 Host、路径或随机数在代理池里轮换，实现请求级别的代理切换，这是 Go 相比多数语言更灵活的地方。返回 nil 表示该请求不走代理，返回 error 则会直接中断请求并向上传播。

完整代码示例

下面的例子构造了带代理的 Transport，并配置了超时与连接池参数：

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "time"
)

func main() {
    proxyURL, err := url.Parse("http://user:[email protected]:8080")
    if err != nil {
        panic(err)
    }

    transport := &http.Transport{
        Proxy:               http.ProxyURL(proxyURL),
        MaxIdleConns:        100,
        IdleConnTimeout:     90 * time.Second,
        TLSHandshakeTimeout: 10 * time.Second,
    }

    client := &http.Client{
        Transport: transport,
        Timeout:   15 * time.Second,
    }

    resp, err := client.Get("https://httpbin.org/ip")
    if err != nil {
        fmt.Println("请求失败:", err)
        return
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        fmt.Println("读取响应失败:", err)
        return
    }
    fmt.Println("状态码:", resp.StatusCode)
    fmt.Println(string(body))
}

运行前把代理地址替换为你自己的节点。代码里同时演示了 MaxIdleConns、IdleConnTimeout 与 TLSHandshakeTimeout 三个常用传输层参数：代理场景下建立连接的成本更高，保活空闲连接能显著降低整体延迟，避免每次请求都重新与代理握手。

HTTPS 与 SOCKS5 代理的支持

对 https:// 目标，net/http 会自动通过 CONNECT 隧道与目标站点完成 TLS 握手，证书校验照常进行，安全性与直连一致。但标准库的 Proxy 字段不支持 socks5 协议，需要借助官方扩展库 golang.org/x/net/proxy 自定义拨号器：

import "golang.org/x/net/proxy"

dialer, err := proxy.SOCKS5("tcp", "127.0.0.1:1080", nil, proxy.Direct)
if err != nil {
    panic(err)
}

transport := &http.Transport{
    DialContext: dialer.(proxy.ContextDialer).DialContext,
}

这样配置后 Transport 不再需要设置 Proxy 字段，所有连接都会经 SOCKS5 代理拨出，HTTP 与 HTTPS 目标均可正常访问。

超时、连接池与常见报错

proxyconnect tcp: connection refused：代理端口未开放或地址写错，先验证代理进程存活。
context deadline exceeded：Client.Timeout 到期，确认代理链路质量后再决定是否调大。
EOF 或 tls: handshake failure：代理对 CONNECT 隧道有限制，或目标站点 TLS 版本不兼容。
连接数持续上涨：resp.Body 必须关闭，否则连接池会被迅速占满并阻塞后续请求。

Article ID: 33

（本文仅供技术交流，请遵守法律法规）