English | 简体中文
一个将 Cursor Web 转换为 OpenAI 兼容 API 的服务。
- 🔄 API 兼容: 完全兼容 OpenAI API 格式
- ⚡ 高性能: 低延迟响应
- 🔐 安全认证: 支持 API Key 认证
- 🌐 多模型支持: 支持多种 AI 模型
- 🛡️ 错误处理: 完善的错误处理机制
- 📊 健康检查: 内置健康检查接口
- ✅ 完全兼容 OpenAI API 格式
- ✅ 支持流式和非流式响应
- ✅ 高性能 Go 语言实现
- ✅ 自动处理 Cursor Web 认证
- ✅ 简洁的 Web 界面
- Anthropic Claude: claude-sonnet-4.6
- Go 1.24+
- Node.js 18+ (用于 JavaScript 执行)
Linux/macOS:
git clone https://github.com/libaxuan/cursor2api-go.git
cd cursor2api-go
chmod +x start.sh
./start.shWindows:
# 双击运行或在 cmd 中执行
start-go.bat
# 或在 Git Bash / Windows Terminal 中
./start-go-utf8.bat# 克隆项目 git clone https://github.com/libaxuan/cursor2api-go.git cd cursor2api-go # 下载依赖 go mod tidy # 编译 go build -o cursor2api-go # 运行 ./cursor2api-go
git clone https://github.com/libaxuan/cursor2api-go.git
cd cursor2api-go
go run main.go服务将在 http://localhost:8002 启动
- 构建镜像:
# 构建镜像 docker build -t cursor2api-go .
- 运行容器:
# 运行容器(推荐) docker run -d \ --name cursor2api-go \ --restart unless-stopped \ -p 8002:8002 \ -e API_KEY=your-secret-key \ -e DEBUG=false \ cursor2api-go # 或者使用默认配置运行 docker run -d --name cursor2api-go --restart unless-stopped -p 8002:8002 cursor2api-go
- 使用 docker-compose.yml:
# 启动服务 docker-compose up -d # 停止服务 docker-compose down # 查看日志 docker-compose logs -f
- 自定义配置:
修改
docker-compose.yml文件中的环境变量以满足您的需求:
- 修改
API_KEY为安全的密钥 - 根据需要调整
MODELS、TIMEOUT等配置 - 更改暴露的端口
- 编译并移动二进制文件:
go build -o cursor2api-go sudo mv cursor2api-go /usr/local/bin/ sudo chmod +x /usr/local/bin/cursor2api-go
- 创建系统服务文件
/etc/systemd/system/cursor2api-go.service:
[Unit] Description=Cursor2API Service After=network.target [Service] Type=simple User=your-user WorkingDirectory=/home/your-user/cursor2api-go ExecStart=/usr/local/bin/cursor2api-go Restart=always Environment=API_KEY=your-secret-key Environment=PORT=8002 [Install] WantedBy=multi-user.target
- 启动服务:
# 重载 systemd 配置 sudo systemctl daemon-reload # 启用开机自启 sudo systemctl enable cursor2api-go # 启动服务 sudo systemctl start cursor2api-go # 查看状态 sudo systemctl status cursor2api-go
curl -H "Authorization: Bearer 0000" http://localhost:8002/v1/modelscurl -X POST http://localhost:8002/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer 0000" \ -d '{ "model": "claude-sonnet-4.6", "messages": [{"role": "user", "content": "Hello!"}], "stream": false }'
curl -X POST http://localhost:8002/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer 0000" \ -d '{ "model": "claude-sonnet-4.6", "messages": [{"role": "user", "content": "Hello!"}], "stream": true }'
在任何支持自定义 OpenAI API 的应用中(如 ChatGPT Next Web、Lobe Chat 等):
- API 地址:
http://localhost:8002 - API 密钥:
0000(或自定义) - 模型: 选择支持的模型之一
| 变量名 | 默认值 | 说明 |
|---|---|---|
PORT |
8002 |
服务器端口 |
DEBUG |
false |
调试模式(启用后显示详细日志和路由信息) |
API_KEY |
0000 |
API 认证密钥 |
MODELS |
claude-sonnet-4.6 |
支持的模型列表(逗号分隔) |
TIMEOUT |
60 |
请求超时时间(秒) |
默认情况下,服务以简洁模式运行。如需启用详细日志:
方式 1: 修改 .env 文件
DEBUG=true
方式 2: 使用环境变量
DEBUG=true ./cursor2api-go
调试模式会显示:
- 详细的 GIN 路由信息
- 每个请求的详细日志
- x-is-human token 信息
- 浏览器指纹配置
遇到问题?查看 故障排除指南 了解常见问题的解决方案,包括:
- 403 Access Denied 错误
- Token 获取失败
- 连接超时
- Cloudflare 拦截
项目提供两个 Windows 启动脚本:
start-go.bat(推荐): GBK 编码,完美兼容 Windows cmd.exestart-go-utf8.bat: UTF-8 编码,适用于 Git Bash、PowerShell、Windows Terminal
两个脚本功能完全相同,仅显示样式不同。如遇乱码请使用 start-go.bat。
# 运行现有测试 go test ./...
# 构建可执行文件 go build -o cursor2api-go # 交叉编译 (例如 Linux) GOOS=linux GOARCH=amd64 go build -o cursor2api-go-linux
cursor2api-go/
├── main.go # 主程序入口 (Go 版本)
├── config/ # 配置管理 (Go 版本)
├── handlers/ # HTTP 处理器 (Go 版本)
├── services/ # 业务服务层 (Go 版本)
├── models/ # 数据模型 (Go 版本)
├── utils/ # 工具函数 (Go 版本)
├── middleware/ # 中间件 (Go 版本)
├── jscode/ # JavaScript 代码 (Go 版本)
├── static/ # 静态文件 (Go 版本)
├── start.sh # Linux/macOS 启动脚本
├── start-go.bat # Windows 启动脚本 (GBK)
├── start-go-utf8.bat # Windows 启动脚本 (UTF-8)
└── README.md # 项目说明
欢迎贡献代码!请遵循以下步骤:
- Fork 本仓库
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'feat: Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
- 遵循 Go Code Review Comments
- 使用
gofmt格式化代码 - 使用
go vet检查代码 - 提交信息遵循 Conventional Commits 规范
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
本项目仅供学习和研究使用,请勿用于商业用途。使用本项目时请遵守相关服务的使用条款。
⭐ 如果这个项目对您有帮助,请给我们一个 Star!