DeepSeek API 代理

一款高性能、支持 HTTP/2 的代理服务器，专为使 Cursor IDE 的 Composer 能够使用 DeepSeek、OpenRouter 和 Ollama 的语言模型而设计。该代理会将与 OpenAI 兼容的 API 请求转换为 DeepSeek/OpenRouter/Ollama 的 API 格式，从而使 Cursor 的 Composer 以及其他兼容 OpenAI API 的工具能够无缝地使用这些模型。

主要使用场景

此代理旨在让 Cursor IDE 用户通过 Cursor 的 Composer 界面，利用 DeepSeek、OpenRouter 和 Ollama 强大的语言模型，作为 OpenAI 模型的替代方案。通过在本地运行此代理，您可以配置 Cursor 的 Composer 使用这些模型来进行 AI 辅助、代码生成和其他 AI 功能。它会处理所有必要的请求/响应转换和格式转换，以实现无缝集成。

特性

• 支持 HTTP/2，提升性能
• 完全支持 CORS
• 流式响应
• 支持函数调用/工具
• 自动消息格式转换
• 压缩支持（Brotli、Gzip、Deflate）
• 兼容 OpenAI API 客户端库
• API 密钥验证，确保安全访问
• 支持 Docker 容器，并提供多变体构建

前置条件

• Cursor Pro 订阅
• Go 1.19 或更高版本
• DeepSeek 或 OpenRouter API 密钥
• 本地运行的 Ollama 服务器（可选，用于 Ollama 支持）
• 公网端点

安装

1. 克隆仓库
2. 安装依赖：

go mod download

Docker 安装

该代理同时支持 DeepSeek 和 OpenRouter 变体。请根据需求选择合适的构建命令：

1. 构建 Docker 镜像：

   • 对于 DeepSeek（默认）：

   docker build -t cursor-deepseek .
   

   • 对于 OpenRouter：

   docker build -t cursor-openrouter --build-arg PROXY_VARIANT=openrouter .
   

   • 对于 Ollama：

   docker build -t cursor-ollama --build-arg PROXY_VARIANT=ollama .
   

2. 配置环境变量：

   • 复制示例配置文件：

   cp .env.example .env
   

   • 编辑 .env 文件，添加您的 API 密钥（DeepSeek 或 OpenRouter）。

3. 运行容器：

docker run -p 9000:9000 --env-file .env cursor-deepseek
# 或者对于 OpenRouter
docker run -p 9000:9000 --env-file .env cursor-openrouter
# 或者对于 Ollama
docker run -p 9000:9000 --env-file .env cursor-ollama

配置

仓库中包含一个 .env.example 文件，展示了所需的环境变量。配置步骤如下：

1. 复制示例配置文件：

cp .env.example .env

2. 编辑 .env 文件并添加您的 API 密钥：

# 对于 DeepSeek
DEEPSEEK_API_KEY=your_deepseek_api_key_here

# 或者对于 OpenRouter
OPENROUTER_API_KEY=your_openrouter_api_key_here

# 或者对于 Ollama
OLLAMA_API_KEY=your_ollama_api_key_here

注意：请根据您使用的变体，仅配置其中一个 API 密钥。

使用

1. 启动代理服务器：

go run proxy.go
# 或者指定模型：
go run proxy.go -model coder
# 或
go run proxy.go -model chat
# 或者对于 OpenRouter
go run proxy-openrouter.go
# 或者对于 Ollama
go run proxy-ollama.go

服务器默认会在端口 9000 上启动。

2. 在您的 OpenAI API 客户端中使用该代理，将基础 URL 设置为 http://your-public-endpoint:9000/v1

将端点公开

您可以使用 ngrok 或类似服务将本地代理服务器暴露到互联网上。这在需要从外部应用程序或不同网络访问代理时非常有用。

使用 ngrok

1. 从 https://ngrok.com/download 下载并安装 ngrok。

2. 在本地启动您的代理服务器（默认运行在端口 9000）。

3. 在一个新的终端中运行 ngrok：

ngrok http 9000

4. ngrok 会为您提供一个公网 URL（例如：https://your-unique-id.ngrok.io）。

5. 将此 URL 作为 Cursor 设置中的 OpenAI API 基础 URL：

https://your-unique-id.ngrok.io/v1

其他方法

您也可以使用其他服务来暴露您的端点：

1. Cloudflare Tunnel：

   • 安装 cloudflared
   • 运行：cloudflared tunnel --url http://localhost:9000

2. LocalTunnel：

   • 安装：npm install -g localtunnel
   • 运行：lt --port 9000

请务必在将端点暴露到互联网时，采取适当的安全措施。

支持的端点

• /v1/chat/completions - 聊天完成端点
• /v1/models - 模型列表端点

模型映射

• gpt-4o 映射到 DeepSeek 的 GPT-4o 等效模型
• deepseek-chat 对应 DeepSeek 的原生聊天模型
• deepseek/deepseek-chat 对应 OpenRouter 上的 DeepSeek 模型

依赖项

• github.com/andybalholm/brotli - Brotli 压缩支持
• github.com/joho/godotenv - 环境变量管理
• golang.org/x/net - HTTP/2 支持

安全性

• 代理包含用于跨域请求的 CORS 头部
• 需要 API 密钥，并根据环境变量进行验证
• 安全处理请求/响应数据
• 对所有请求进行严格的 API 密钥验证
• 通过 HTTP/2 支持 HTTPS
• 环境变量绝不会提交到代码仓库中

许可证

本项目采用 GNU 通用公共许可证 v2.0（GPLv2）授权。详细信息请参阅 LICENSE.md 文件。

cursor-deepseek 快速上手指南

cursor-deepseek 是一个高性能代理服务器，旨在让 Cursor IDE 的 Composer 功能能够无缝使用 DeepSeek、OpenRouter 或 Ollama 的大语言模型。它通过将 OpenAI 兼容的 API 请求转换为上述模型的专用格式，让你在使用 Cursor 时拥有更多模型选择。

环境准备

在开始之前，请确保满足以下前置条件：

• 操作系统：支持 Linux、macOS 或 Windows（需安装 Go 环境）。
• Go 语言环境：版本需为 Go 1.19 或更高。
• Cursor 账号：需要 Cursor Pro 订阅以使用自定义 API 端点功能。
• API 密钥：
  • DeepSeek API Key（推荐国内开发者直接使用）
  • 或 OpenRouter API Key
  • 或本地运行的 Ollama 服务（可选）
• 网络暴露工具（可选但推荐）：如 ngrok、cloudflared 或 localtunnel，用于将本地服务暴露给外网以便 Cursor 访问。

安装步骤

你可以选择直接运行 Go 代码或使用 Docker 容器部署。

方式一：直接运行（推荐开发调试）

1. 克隆仓库

   git clone <repository-url>
   cd cursor-deepseek
   

2. 安装依赖

   go mod download
   

3. 配置环境变量 复制示例配置文件并填入你的 API Key（只需配置其中一种）：

   cp .env.example .env
   

   编辑 .env 文件：

   # 使用 DeepSeek (推荐)
   DEEPSEEK_API_KEY=your_deepseek_api_key_here
   
   # 或者使用 OpenRouter
   # OPENROUTER_API_KEY=your_openrouter_api_key_here
   
   # 或者使用 Ollama
   # OLLAMA_API_KEY=your_ollama_api_key_here
   

方式二：Docker 部署（推荐生产/稳定运行）

1. 构建镜像 根据你要使用的模型服务选择对应的构建命令：

   • DeepSeek (默认):

     docker build -t cursor-deepseek .
     

   • OpenRouter:

     docker build -t cursor-openrouter --build-arg PROXY_VARIANT=openrouter .
     

   • Ollama:

     docker build -t cursor-ollama --build-arg PROXY_VARIANT=ollama .
     

2. 配置环境变量

   cp .env.example .env
   # 编辑 .env 填入对应的 API KEY
   

3. 启动容器

   # DeepSeek 版本
   docker run -p 9000:9000 --env-file .env cursor-deepseek
   
   # OpenRouter 版本
   # docker run -p 9000:9000 --env-file .env cursor-openrouter
   
   # Ollama 版本
   # docker run -p 9000:9000 --env-file .env cursor-ollama
   

基本使用

1. 启动代理服务

如果你选择了直接运行方式，使用以下命令启动服务（默认端口 9000）：

# 启动 DeepSeek 代理
go run proxy.go

# 或者指定模型类型
go run proxy.go -model coder
go run proxy.go -model chat

# 如果是 OpenRouter 或 Ollama 变体
# go run proxy-openrouter.go
# go run proxy-ollama.go

2. 暴露公网地址（关键步骤）

由于 Cursor 需要访问该代理，而代理通常运行在本地，你需要将其暴露到公网。推荐使用 ngrok：

1. 在新终端窗口运行：

   ngrok http 9000
   

2. 复制 ngrok 生成的 HTTPS 地址（例如：https://abc123.ngrok.io）。

(也可使用 Cloudflare Tunnel: cloudflared tunnel --url http://localhost:9000)

3. 配置 Cursor

1. 打开 Cursor 设置 (Settings) -> General -> AI。
2. 找到 Custom API Endpoint (自定义 API 端点) 选项。
3. 填入你的公网地址加上 /v1 后缀：

   https://abc123.ngrok.io/v1
   

4. 在 API Key 栏填入任意非空字符串（因为鉴权已在代理层的 .env 中处理，此处仅为满足 Cursor 格式要求，或者填入你配置的相同 Key）。
5. 在模型选择下拉框中，你可以尝试输入以下映射名称：
   • gpt-4o (自动映射到 DeepSeek 对应模型)
   • deepseek-chat
   • deepseek/deepseek-chat (OpenRouter 专用)

配置完成后，即可在 Composer 中使用 DeepSeek 等模型进行代码生成和对话。