WindsurfPoolAPI

Enterprise-grade multi-account pool proxy for Windsurf AI platform.
Expose 87+ models (Claude / GPT / Gemini / DeepSeek / Grok / Qwen) via standard OpenAI & Anthropic APIs.
_{企业级 Windsurf 多账号池化 API 代理 —— 87+ 模型，OpenAI / Anthropic 双协议兼容}

Quick Start · Features · Dashboard · API Reference · Deployment · FAQ

⚠️ Disclaimer / 声明

This project is for personal learning, research, and self-hosting only. Commercial use, resale, paid deployment, or repackaging as a service without written authorization is strictly prohibited.

本项目仅供个人学习、研究、自用。未经作者书面授权，禁止任何商业用途、付费代部署、中转转售或包装成服务对外销售。

✨ Features / 核心特性

• 双协议兼容 — OpenAI + Anthropic 原生端点，无需任何中间件
• 87+ 模型 — 启动时自动拉取 Windsurf 最新 catalog，实时更新
• 多账号池 — 按剩余容量均衡分配，自动故障转移，per-model 限速隔离
• Token + Credit 精细统计 — 按 API × 模型分层聚合，精确到单次请求
• Dashboard 管理后台 — 账号管理、代理配置、实时日志、使用图表、封禁侦测
• 批量操作 — 一键多选账号批量启用/停用
• OAuth 登录 — 支持 Google/GitHub Firebase OAuth 登录
• 动态超时检测 — 根据输入长度自适应超时阈值（30s~90s），大上下文不误判
• 全持久化 — 所有设置、账号状态、Token 均持久化存储，重启不丢失
• 零依赖 — 纯 Node.js 内置模块，开箱即用

🚀 Quick Start / 快速开始

Prerequisites / 前置条件

• Node.js ≥ 20
• Windsurf Language Server binary (language_server_linux_x64 or language_server_darwin_arm64)
• At least one Windsurf account (Free tier supports limited models)

Install & Run / 安装启动

git clone https://github.com/guanxiaol/WindsurfPoolAPI.git
cd WindsurfPoolAPI

# Place Language Server binary / 放置 Language Server 二进制
sudo mkdir -p /opt/windsurf
sudo cp /path/to/language_server_linux_x64 /opt/windsurf/
sudo chmod +x /opt/windsurf/language_server_linux_x64

# Optional: configure / 可选配置
cp .env.example .env    # Edit API_KEY, DASHBOARD_PASSWORD, etc.

# Start / 启动
node src/index.js

macOS — Run bash scripts/install-macos.sh for auto-start on login.

Windows — Run scripts\install-windows.bat for guided installation.

Dashboard: http://localhost:3003/dashboard

Docker

docker compose up -d --build

Mount the LS binary at /opt/windsurf/ on the host before starting.

🔑 Account Management / 账号管理

⚠️ Always use Token login! / 必须使用 Token 方式登录！

Windsurf has a known bug where email/password login may route requests to the wrong account.

Windsurf 官方存在 bug：邮箱/密码登录可能导致请求路由到错误账号。

Get your token / 获取 Token：https://windsurf.com/editor/show-auth-token?workflow=

# ✅ Add account via Token (recommended / 推荐)
curl -X POST http://localhost:3003/auth/login \
  -H "Content-Type: application/json" \
  -d '{"token": "your-windsurf-token"}'

# Batch add / 批量添加
curl -X POST http://localhost:3003/auth/login \
  -H "Content-Type: application/json" \
  -d '{"accounts": [{"token": "t1"}, {"token": "t2"}]}'

# List accounts / 列出账号
curl http://localhost:3003/auth/accounts

# Remove / 删除
curl -X DELETE http://localhost:3003/auth/accounts/{id}

📡 API Reference / 接口文档

OpenAI Compatible / OpenAI 兼容

curl http://localhost:3003/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": false
  }'

Anthropic Compatible / Anthropic 兼容

curl http://localhost:3003/v1/messages \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: sk-your-api-key" \
  -d '{
    "model": "claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Environment Variables / 环境变量

Dashboard API

All endpoints require X-Dashboard-Password header.

🖥 Dashboard / 管理后台

Access at http://localhost:3003/dashboard

Screenshots / 界面预览

Account Pool — Multi-account quota monitoring / 多账号额度监控

Analytics — Token & Credit usage charts / 统计分析面板

Model Stats — Per-model request breakdown / 模型使用统计

Experimental — Cascade reuse & model identity injection / 实验性功能

🤖 Supported Models / 支持的模型

claude-3.5-sonnet · claude-3.7-sonnet[-thinking] · claude-4-sonnet[-thinking] · claude-4-opus[-thinking] ·
claude-4.1-opus[-thinking] · claude-4.5-sonnet[-thinking] · claude-4.5-haiku · claude-4.5-opus[-thinking] ·
claude-sonnet-4.6[-thinking][-1m] · claude-opus-4.6[-thinking] · claude-opus-4.7-{low,medium,high,xhigh,max}

gpt-4o · gpt-4o-mini · gpt-4.1[-mini/nano] · gpt-5[-mini] · gpt-5.2[-low/medium/high] ·
gpt-5.4[-low/medium/high/xhigh] · gpt-5.3-codex · o3[-mini/high/pro] · o4-mini

gemini-2.5-pro · gemini-2.5-flash · gemini-3.0-pro · gemini-3.0-flash · gemini-3.1-pro[-low/high]

deepseek-v3 · deepseek-r1 · grok-3[-mini] · grok-code-fast-1 · qwen-3 · qwen-3-coder ·
kimi-k2 · kimi-k2.5 · swe-1.5[-thinking] · swe-1.6-fast · arena-fast · arena-smart

Model catalog is auto-synced from Windsurf cloud on startup. Free accounts: gpt-4o-mini and gemini-2.5-flash only.

启动时自动从 Windsurf 云端拉取最新模型列表。免费账号仅可用 gpt-4o-mini 和 gemini-2.5-flash。

🚢 Deployment / 部署指南

PM2 (Recommended / 推荐)

npm install -g pm2
pm2 start src/index.js --name windsurfpool --cwd /path/to/WindsurfPoolAPI
pm2 save && pm2 startup

systemd (Linux)

# /etc/systemd/system/windsurfpool.service
[Unit]
Description=WindsurfPoolAPI
After=network.target

[Service]
Type=simple
User=windsurf
WorkingDirectory=/opt/WindsurfPoolAPI
ExecStart=/usr/bin/node src/index.js
Restart=on-failure
RestartSec=5
Environment=PORT=3003

[Install]
WantedBy=multi-user.target

sudo systemctl enable --now windsurfpool

macOS (launchd)

bash scripts/install-macos.sh

Firewall / 防火墙

# Ubuntu
sudo ufw allow 3003/tcp

# CentOS
sudo firewall-cmd --add-port=3003/tcp --permanent && sudo firewall-cmd --reload

Cloud servers: remember to open port 3003 in your security group.

云服务器记得在安全组中开放 3003 端口。

🏗 Architecture / 架构

Client (OpenAI SDK / Anthropic SDK / curl / Cursor / Aider)
   │
   ▼
WindsurfPoolAPI  (Node.js HTTP, :3003)
   ├── /v1/chat/completions    (OpenAI format)
   ├── /v1/messages            (Anthropic format)
   ├── /dashboard/api/*        (Admin API)
   └── /dashboard              (Admin SPA)
   │
   ▼
Language Server Pool  (gRPC-over-HTTP/2, :42100+)
   │
   ▼
Windsurf Cloud  (server.self-serve.windsurf.com)

See ARCHITECTURE.md for module-level details.

❓ FAQ / 常见问题

Q: LS binary not found on startup?
A: Ensure the binary exists at /opt/windsurf/language_server_linux_x64 (or set LS_BINARY_PATH).

Q: No accounts available?
A: Add at least one account via Dashboard or POST /auth/login.

Q: permission_denied for all accounts?
A: Free accounts only support gpt-4o-mini and gemini-2.5-flash. Other models require Windsurf Pro.

Q: How to migrate stats between servers?
A: Export: GET /dashboard/api/usage/export → Import: POST /dashboard/api/usage/import (auto-dedup).

Q: How to update models?
A: Models auto-sync on startup. Restart the service to refresh.

🤝 Contributing

See CONTRIBUTING.md. Issues and PRs are welcome.

🙏 Acknowledgements / 致谢

This project is built upon dwgx/WindsurfAPI. Special thanks to @dwgx for the foundational work and open-source contribution.

本项目基于 dwgx/WindsurfAPI 的初始版本开发，感谢原作者 @dwgx 的开创性工作和开源贡献。

📄 License

MIT