当前位置：首页 > 文章列表 > Golang > Go教程 > 用Golang做简易反向代理教程

用Golang做简易反向代理教程

2025-08-26 17:20:44 0浏览收藏

想要快速搭建反向代理服务？本文以Golang为核心，教你如何利用标准库`net/http/httputil`轻松实现。通过创建`ReverseProxy`实例，定义目标服务器地址，并编写处理函数注册路由，即可快速启动HTTP服务。更进一步，我们还将探讨如何扩展代理功能，例如添加自定义请求头、实现路径重写以及支持多个后端服务。此外，文章还重点强调了生产环境中不可忽视的性能与安全注意事项，包括缓冲限制、超时控制、安全头处理以及日志记录等关键点。无论你是想构建负载均衡、API网关还是缓存转发服务，本教程都将为你提供扎实的基础，助你轻松掌握Golang反向代理的开发技巧。

用Golang开发反向代理服务可通过标准库实现。首先导入net/http和net/http/httputil包；其次定义目标服务器地址并创建ReverseProxy实例；接着编写处理函数注册路由；最后启动HTTP服务监听端口。此外可扩展功能包括添加请求头、路径重写、支持多个后端服务，同时需注意缓冲限制、超时控制、安全头处理及日志记录等性能与安全事项。

如何用Golang开发简单的代理服务器解析net/http/httputil反向代理

代理服务器在现代网络架构中很常见，比如做负载均衡、API网关、缓存转发等。用 Golang 开发一个简单的反向代理其实并不难，尤其是利用标准库 net/http/httputil 提供的 ReverseProxy 类型，可以快速搭建一个基础代理服务。

反向代理的基本原理

反向代理的作用是接收客户端请求，然后将请求转发给后端服务器，并将结果返回给客户端。与正向代理不同的是，反向代理对客户端来说是“透明”的，它代表的是服务器一方。

在 Go 中，httputil.ReverseProxy 已经封装好了大部分逻辑，你只需要提供一个 Director 函数来决定如何修改原始请求的目标地址和路径即可。

例如：

director := func(req *http.Request) {
    req.URL.Scheme = "http"
    req.URL.Host = "example.com"
}
proxy := httputil.NewSingleHostReverseProxy(&url.URL{
    Scheme: "http",
    Host:   "example.com",
})

这个 director 函数负责告诉代理如何重写请求。你可以根据需要修改请求头、路径、查询参数等。

如何构建一个最简反向代理服务

实现一个基本的反向代理服务只需要几个步骤：

导入必要的包：net/http 和 net/http/httputil
定义目标服务器地址
创建 ReverseProxy 实例
编写处理函数并注册路由
启动 HTTP 服务监听端口

完整代码如下：

package main

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

func main() {
    remote, _ := url.Parse("http://example.com")
    proxy := httputil.NewSingleHostReverseProxy(remote)

    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        proxy.ServeHTTP(w, r)
    })

    http.ListenAndServe(":8080", nil)
}

运行之后，访问 http://localhost:8080 就会把请求转发到 example.com 上。

常见需求扩展：添加请求头、路径重写、多个后端支持

实际使用中，代理通常还需要做一些额外处理，比如设置请求头、修改路径、支持多个后端等。

添加自定义请求头

可以在处理函数里直接操作 req.Header：

director := func(req *http.Request) {
    req.URL.Scheme = "http"
    req.URL.Host = "example.com"
    req.Header.Set("X-Forwarded-For", req.RemoteAddr)
}

修改请求路径或查询参数

比如去掉 /api 前缀再转发：

director := func(req *http.Request) {
    req.URL.Scheme = "http"
    req.URL.Host = "backend.local"
    req.URL.Path = strings.TrimPrefix(req.URL.Path, "/api")
}

支持多个后端服务

可以通过判断路径选择不同的代理实例：

http.HandleFunc("/service1/", func(w http.ResponseWriter, r *http.Request) {
    // 转发到 service1
})

http.HandleFunc("/service2/", func(w http.ResponseWriter, r *http.Request) {
    // 转发到 service2
})

或者更灵活地使用中间件来动态选择后端。