Windsurf 开源反代工具：59 个 AI 模型一站式接入

1. 统一接口，多模型切换#

不同 AI 厂商的 API 格式各不相同，想换个模型用用，得重新研究文档、调整代码。WindsurfAPI 把这些差异都屏蔽了，你只需要改一个参数：

1
model: "claude-opus-4-7-max"  # 切换模型

支持的模型阵容：

2. 账号池与负载均衡#

单个账号的调用次数有限制，团队协作或高频使用时很容易触顶。WindsurfAPI 允许多个账号组成资源池：

• 自动在账号间轮换请求
• 某个账号额度不足时自动切换
• 模型级别的故障不影响其他调用
• 实时监控账号状态，提前预警

从调用方的角度看，就像有一个「无限额度」的账号在背后支撑。

3. 零外部依赖#

这个项目最让人印象深刻的是代码风格——完全不依赖第三方 npm 包，全部使用 Node.js 原生模块：

• HTTP 服务：http
• 文件系统：fs
• 路径处理：path
• 环境变量：process.env
• gRPC 通信：内置实现

在 JavaScript 生态里，这种「洁癖式」的写法相当罕见。好处也很明显：没有供应链攻击风险，部署简单，维护成本低。

4. Web 管理界面#

访问 http://你的服务器:3003/dashboard 可以打开管理后台：

账号管理功能：

• 添加或删除 Windsurf 账号
• 启用/禁用特定账号
• 查看各账号的使用统计
• 批量导入 Token

监控仪表盘：

• 实时请求量
• 平均响应时间
• 错误率变化趋势
• 各模型调用占比

代理与限流：

• 全局 HTTP/SOCKS5 代理配置
• 单账号独立代理设置
• 模型访问白名单/黑名单
• 请求频率限制

对于需要管理多个账号的场景，这个界面能省不少事。

前置条件#

• Node.js 20 或更高版本
• 至少一个 Windsurf 账号（免费版即可）
• Language Server 可执行文件（需自行提取）

1
# 下载安装包
2
wget https://downloads.windsurf.com/windsurf-linux.deb
3

4
# 解压
5
dpkg-deb -x windsurf-linux.deb windsurf-extracted
6

7
# 定位文件
8
find windsurf-extracted -name "language_server_linux_x64"

安装流程#

1
# 1. 获取项目
2
git clone https://github.com/dwgx/WindsurfAPI.git
3
cd WindsurfAPI
4

5
# 2. 部署 Language Server
6
mkdir -p /opt/windsurf
7
cp language_server_linux_x64 /opt/windsurf/
8
chmod +x /opt/windsurf/language_server_linux_x64
9

10
# 3. 准备数据目录
11
mkdir -p /opt/windsurf/data/db
12

13
# 4. 设置环境变量
14
cat > .env << 'EOF'
15
PORT=3003
16
API_KEY=
17
DEFAULT_MODEL=gpt-4o-mini
18
MAX_TOKENS=8192
19
LOG_LEVEL=info
20
LS_BINARY_PATH=/opt/windsurf/language_server_linux_x64
21
LS_PORT=42100
22
DASHBOARD_PASSWORD=你的密码
23
EOF
24

25
# 5. 运行服务
26
node src/index.js

服务启动后监听 http://0.0.0.0:3003。

进程守护（PM2）#

1
# 安装 PM2
2
npm install -g pm2
3

4
# 启动应用
5
pm2 start src/index.js --name windsurf-api
6

7
# 持久化配置
8
pm2 save
9

10
# 配置开机自启
11
pm2 startup

1
pm2 stop windsurf-api
2
pm2 delete windsurf-api
3
fuser -k 3003/tcp 2>/dev/null
4
sleep 2
5
pm2 start src/index.js --name windsurf-api --cwd /root/WindsurfAPI

网络配置#

1
# Ubuntu 防火墙
2
ufw allow 3003/tcp
3

4
# CentOS 防火墙
5
firewall-cmd --add-port=3003/tcp --permanent
6
firewall-cmd --reload
7

8
# 云服务器：在安全组规则中开放 3003 端口

配置 Windsurf 账号#

1
# 单个账号（使用 Token）
2
curl -X POST http://localhost:3003/auth/login \
3
  -H "Content-Type: application/json" \
4
  -d '{"token": "你的 windsurf-token"}'
5

6
# 批量添加
7
curl -X POST http://localhost:3003/auth/login \
8
  -H "Content-Type: application/json" \
9
  -d '{"accounts": [{"token": "token1"}, {"token": "token2"}]}'

验证部署#

1
curl http://localhost:3003/v1/chat/completions \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "model": "gpt-4o-mini",
5
  "messages": [{"role": "user", "content": "你好"}],
6
  "stream": false
7
}'

收到正常响应即表示部署成功。

开源协议#

项目采用 MIT 许可证，但作者在 README 中附加了额外条款：

• 禁止商业用途（除非获得书面授权）
• 禁止转售或代部署服务
• 个人学习和研究不受限制

使用前请仔细阅读相关条款。

安全建议#

管理后台密码必须设置：DASHBOARD_PASSWORD 环境变量不要留空，否则任何人都能访问你的后台并查看账号信息。

代理支持#

如果服务器网络需要代理，可以在管理后台配置：

1
# 全局代理配置
2
curl -X POST http://localhost:3003/proxy/config \
3
  -H "Content-Type: application/json" \
4
  -d '{"type": "http", "host": "proxy.example.com", "port": 8080}'
5

6
# 单账号代理
7
curl -X POST http://localhost:3003/account/1/proxy \
8
  -H "Content-Type: application/json" \
9
  -d '{"type": "socks5", "host": "proxy.example.com", "port": 1080}'

支持 HTTP 和 SOCKS5 两种协议，可以全局配置也可以为单个账号单独设置。

模型访问权限#

Windsurf 对不同订阅等级的账号开放了不同的模型：

• 免费账号：gpt-4o-mini、gemini-2.5-flash 等基础模型
• Pro 订阅：Claude 系列、GPT-5.4、Kimi 2.5 等高级模型

具体可用模型列表可在管理后台查看。

调用限额#

Windsurf 对账号实行周限额制度：

多账号池的设计初衷就是为了解决这个问题。