GO-OPENAI-PROXY

基于 Go 实现的 OpenAI API HTTP 代理

想要快速体验，将 OpenAI API 调用域名从默认的 api.openai.com 调整为 proxy.geekai.co 即可。你可以在这里预览演示效果：演示应用。

切换到 Azure OpenAI

默认在 9000 端口代理 OpenAI API，要想切换到 Azure OpenAI API，可以在 scf_bootstrap 的启动命令中添加域名参数来指定你的 Azure OpenAI API Endpoint:

./main -domain=your-azure-openai-endpoint

如果 9000 端口被占用，可以通过 -post=9001 指定其他端口。

代理任意全球域名

这个工具最早是为 OpenAI 代理而生，但实际上现在已经可以支持通过一个入口代理任意域名，只需要在发起发起代理请求的时候通过 X-Target-Host 设置你想要代理的域名（不带 http(s):// 前缀）即可，优先级是请求头>命令行参数>默认值：

req.Header.Set("x-target-host", "api.open.ai")

编译打包

你可以修改源代码调整代理逻辑，然后编译打包进行部署：

./build.sh

此命令需要本地安装go开发环境，如果不想本地安装 go 环境进行编译打包，可以直接下载根据最新源代码编译打包好的 main.zip：Releases

部署测试

支持部署到腾讯/阿里云函数、AWS lambda 函数以及任意云服务器，以下以腾讯云函数为例进行演示。

然后在腾讯云云函数代码管理界面上传打包好 zip 包即可完成部署：

你可以通过腾讯云云函数提供的测试工具进行测试，也可以本地通过 curl/postman 进行测试，使用的时候只需要将 api.openai.com 替换成代理域名 proxy.geekai.co 即可：

你可以选择自己搭建，也可以直接使用我提供的代理域名 proxy.geekai.co，反正是免费的。关于代理背后的原理，可以看我在极客书房发布的这篇教程：国内无法调用 OpenAI 接口的解决办法。

本地调试走VPN的话可以设置环境变量 ENV=local，然后直连 api.openai.com：

// 本地测试通过代理请求 OpenAI 接口
if os.Getenv("ENV") == "local" {
    proxyURL, _ := url.Parse("http://127.0.0.1:10809")
    client.Transport = &http.Transport{
        Proxy:           http.ProxyURL(proxyURL),
        TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
    }
}

流式响应支持

这个源代码本身是支持 stream 流式响应代理的，但目前很多云函数并不支持分块流式传输。所以，如果你需要实现流式响应，可以把编译后的二进制文件 main 丢到任意海外云服务器运行，这样就变成支持流式响应的 OpenAI HTTP 代理了，如果你不想折腾，可以使用我这边提供的 proxy.geekai.co 作为代理进行测试：

如果你是通过 Nginx 这种反向代理对外提供服务，记得通过如下配置项将默认缓冲和缓存关掉才会生效：

proxy_buffering off;
proxy_cache off;

openai-proxy 快速上手指南

环境准备

• 操作系统：支持 Linux、macOS、Windows（推荐在 Linux 服务器或云函数环境部署）
• 前置依赖：
  • 若需自行编译：需安装 Go 开发环境 (建议版本 1.18+)
  • 若直接部署：无需本地环境，直接下载预编译包即可
• 网络要求：部署服务器需能访问目标 API 域名（如 api.openai.com 或 Azure Endpoint）

安装步骤

你可以选择直接下载预编译包（推荐）或源码编译。

方式一：下载预编译包（推荐）

直接从 GitHub Releases 下载最新构建好的 main.zip 文件： 下载地址

解压后即可得到可执行文件 main。

方式二：源码编译

如果你需要修改代理逻辑，可以克隆源码并编译：

git clone https://github.com/geekr-dev/openai-proxy.git
cd openai-proxy
./build.sh

注：执行 ./build.sh 前请确保本地已正确安装 Go 环境。

基本使用

1. 启动代理服务

默认情况下，服务将在 9000 端口启动，代理 api.openai.com。

./main

自定义配置示例：

• 切换至 Azure OpenAI：指定 Azure 终结点

  ./main -domain=your-azure-openai-endpoint
  

• 修改端口：如果 9000 端口被占用

  ./main -port=9001
  

2. 调用测试

启动后，将你的代码或请求中的 OpenAI 域名替换为代理地址（例如 http://127.0.0.1:9000 或部署后的公网域名）。

curl 测试示例：

curl http://127.0.0.1:9000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

3. 高级用法：代理任意域名

该工具支持通过请求头动态指定目标域名。在发起请求时设置 X-Target-Host（无需带 http(s):// 前缀）：

req.Header.Set("x-target-host", "api.example.com")

优先级规则：请求头 > 命令行参数 > 默认值

4. 部署建议

• 云函数部署：支持腾讯云、阿里云及 AWS Lambda。将编译好的 main 打包为 zip 上传至云函数即可。
• 流式响应 (Stream)：部分云函数不支持流式传输。如需完整支持 Stream，建议将二进制文件部署在海外云服务器上运行。
• Nginx 反向代理：若前方有 Nginx，务必关闭缓冲以支持流式输出：

  proxy_buffering off;
  proxy_cache off;
  

提示：本地调试若需走 VPN 代理，可设置环境变量 ENV=local 启用内置的本地代理逻辑。