v1.5.0 — Docker + SOCKS5 + 工具調用修復

Windsurf 的 AI 模型
變成你熟悉的 API

同時支援 /v1/chat/completions/v1/messages 雙協定。Claude Code、Cursor、Cline 直接連。零 npm 依賴,Docker 一鍵部署。

零 npm 依賴 Node.js ≥ 20 MIT License Docker 就緒
0
AI 模型
9
供應商
2
相容協定
0
npm 依賴
雙協定 · Dual Protocol

同一個伺服器,兩套標準

不管你手上的客戶端走 OpenAI 還是 Anthropic 協定,指向同一個 Windsurf API 實例就能用。

S

OpenAI 相容

POST /v1/chat/completions
$ curl http://localhost:3003/v1/chat/completions \
  -H "Authorization: Bearer sk-ws-demo" \
  -d '{
    "model": "gpt-5.2",
    "messages": [
      {"role":"user","content":"hello"}
    ],
    "stream": true
  }'
# → Server-Sent Events (OpenAI chunk 格式)
A

Anthropic 相容

POST /v1/messages
$ curl http://localhost:3003/v1/messages \
  -H "x-api-key: sk-ws-demo" \
  -d '{
    "model": "claude-opus-4.6",
    "messages": [
      {"role":"user","content":"hello"}
    ],
    "stream": true
  }'
# → SSE (Anthropic message_delta 格式)
同一個請求體格式、同一個帳號池、同一個速率限制器——切換協定只是換路由前綴。Claude Code、Cline 吃 /v1/messages,Cursor/OpenAI SDK 吃 /v1/chat/completions,互不干擾。
模型 · Models

一個 API 背後,多個供應商

從 Claude Opus 到 GPT-5、從 Gemini 3 到 DeepSeek R1,9 個供應商的模型統一接入。

免費帳號:僅支援 gpt-4o-minigemini-2.5-flash。其餘模型需 Windsurf Pro 訂閱。
看不到最新模型?你的 Language Server binary 可能落後 Windsurf 雲端,從桌面端拷貝最新版 LS 覆蓋即可——/v1/models 會自動從雲端發現新模型。
架構 · Architecture

中間多一層,全都接住

請求進來後經過協定翻譯、帳號池選號、語言伺服器轉 gRPC,最後到 Windsurf 雲端。

CLIENT Claude Code Cursor · Cline NODE.JS PROXY Windsurf API 帳號池 · 協定翻譯 速率限制 · SOCKS5 gRPC Language Server HTTPS Windsurf Cloud HTTP gRPC TLS
請求流 回應流 本專案
管理後台 · Dashboard

10 個面板,帳號運維全搞定。

訪問 /dashboard,暗色 Web 介面。日誌即時串流、帳號一鍵登入、模型黑白名單、封禁偵測。

1

總覽

運行時間、帳號池狀態、分模型成功率

2

登入取號

Email/密碼直接註冊,自動取得 Token

3

帳號管理

新增、刪除、停用、餘額 Credits 查詢

4

模型控制

全域與帳號層的模型白/黑名單

5

代理配置

全域及個別帳號 HTTP/SOCKS5 代理

6

日誌檢視

即時 SSE 串流,級別篩選,關鍵字高亮

7

請求統計

按模型/帳號維度的指標與圖表

8

封禁偵測

錯誤模式偵測,帳號健康自動監控

9

自動更新

一鍵 git pull + PM2 重啟服務

10

致謝

Contributors 列表

部署 · Deploy

從零到跑起來,五分鐘

兩種方式任選。

安裝 Node.js 20+

bash
$ curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
$ apt install -y nodejs

Clone + 安裝 Language Server

bash
$ git clone https://github.com/dwgx/WindsurfAPI.git
$ cd WindsurfAPI
$ bash install-ls.sh

設定 .env

.env
PORT=3003
API_KEY=                   # 留空 = 不驗證
DEFAULT_MODEL=gpt-4o-mini
LS_BINARY_PATH=/opt/windsurf/language_server_linux_x64
DASHBOARD_PASSWORD=         # 留空 = 後台免密碼

啟動

bash
$ npm install -g pm2
$ pm2 start src/index.js --name windsurf-api
$ pm2 save && pm2 startup
一鍵更新:bash update.sh

準備配置

bash
$ git clone https://github.com/dwgx/WindsurfAPI.git
$ cd WindsurfAPI
$ cp .env.example .env

啟動容器

bash
$ docker compose up -d --build
$ docker compose logs -f
預設掛載:.docker-data/data 持久化帳號/配置,.docker-data/opt/windsurf 放 LS binary。容器首次啟動會自動下載。
客戶端接入 · Integrations

你常用的那個 IDE,已經兼容了

改 BASE_URL,塞 API KEY,完事。

CClaude Code

/v1/messages · Anthropic 協定

export ANTHROPIC_BASE_URL="http://YOUR_IP:3003"
export ANTHROPIC_API_KEY="sk-ws-your-key"
claude

CCursor

/v1/chat/completions · OpenAI 協定

# Settings → Models → Custom OpenAI
Base URL: http://YOUR_IP:3003/v1
API Key:  sk-ws-your-key
Model:    claude-opus-4.6

CCline / Roo Code

AnthropicOpenAI provider 皆可

# Provider: OpenAI Compatible
Base URL: http://YOUR_IP:3003/v1
API Key:  sk-ws-your-key

OOpenAI SDK

/v1/chat/completions

from openai import OpenAI
client = OpenAI(
    base_url="http://YOUR_IP:3003/v1",
    api_key="sk-ws-your-key",
)
常見問題 · FAQ

你可能想問的。

需要 Windsurf 付費帳號嗎?
免費帳號可以跑,但僅限 gpt-4o-minigemini-2.5-flash。Claude、GPT-5 全系、Gemini 3 等都需要 Windsurf Pro 訂閱。後台會自動偵測並標記每個帳號的 tier。
可以 Windows 上跑嗎?
HTTP 伺服器和管理後台能跑,但 Language Server binary 只有 Linux 版本(language_server_linux_x64),所以聊天功能僅限 Linux。Windows 建議放 WSL2 或純 Linux VM。
看不到最新模型(opus-4.7、gpt-5.3 之類)怎麼辦?
Exafunction 公開 release 停在 v2.12.5(2026-01),不含 4.7。從 Windsurf 桌面端 App 裡把 LS binary 拷出來即可:
• macOS:~/Library/Application Support/Windsurf/.../language_server_macos_arm
• Linux:~/.windsurf/bin/language_server_linux_x64
拷過去後 /v1/models 會自動從雲端 discover 最新目錄。
帳號會被封嗎?
高頻 burst 確實容易被識別。後台的封禁偵測面板會監控錯誤率,按 5 分鐘窗口做速率冷卻。推薦:每帳號 RPM < 10、配不同出口代理(支援 SOCKS5)、混用思考型和普通模型。
和其他類似專案的區別?
三點核心差異:
(1) 雙協定——同時有 /v1/messages/v1/chat/completions
(2) planner_mode=NO_TOOL——關掉 Cascade 內建工具循環,消除路徑洩露。
(3) 完整管理後台 + 帳號池——多號輪詢 + 故障轉移 + Docker 一鍵部署。
MIT License,可以商用嗎?
代碼本體 MIT License,法律上允許商用。README 顶上有一段作者態度:沒給 Star 和 Follow 的請別商業轉售,點了的隨便用。