WorkBuddy 反代 API 网关部署与使用教程

WorkBuddy 反代 API 网关部署与使用完整教程

项目定位： WorkBuddy 反向代理网关（如 workbuddy2api-ui）可将腾讯 WorkBuddy / CodeBuddy 账号池中的模型（包括 DeepSeek、Claude、Qwen 等）封装为标准兼容 OpenAI / Anthropic 规范的 API 接口，并提供可视化 Web 控制台，支持自动签到领积分、账号池轮询及多密钥分发。

1. 准备工作与服务器配置

云服务器 (VPS)： 推荐配置 1 核 2GB 内存及以上的纯净 Linux VPS（如 AWS Lightsail、甲骨文云或海外轻量云服务器），推荐系统为 Debian 12。
绑定静态 IP 与开放端口：
- 在云平台控制面板为实例附加固定的静态公网 IP，防止重启实例后 IP 漂移。
- 在防火墙安全组规则中放行必要的入站端口（至少开放 80、443 以及服务所需端口，或测试阶段放行所有 TCP/UDP 流量）。
域名解析： 在 DNS 服务商后台添加一条 A 记录，将二级域名（例如 wb.yourdomain.com）解析至当前 VPS 的静态 IP，并将 TTL 设置为 1 分钟以快速生效。

2. 服务器环境与系统安装

2.1 系统纯净初始化（可选，如遇到云商内置受限镜像）

如果云商初始镜像预装了监控或受限组件，可通过 SSH 远程连接并使用 DD 重装脚本重置为纯净版 Debian 12：

# 获取并执行一键 DD 安装纯净 Debian 12 脚本
sudo apt-get update && sudo apt-get install -y curl wget
# 运行 DD 命令（安装时设置登录密码并重启等待系统就绪）
reboot

2.2 安装基础依赖与一键部署网关

系统重启并重新通过 SSH 连接后（默认 root 账号）：

安装基础工具：

apt update && apt install -y curl sudo wget git

运行一键部署脚本：
执行自动化部署命令，并在参数中指定绑定解析好的域名：
```
# 格式：执行脚本并附带解析到当前 VPS 的域名
bash <(curl -Ls https://raw.githubusercontent.com/baiyea/workbuddy2api-ui/main/install.sh) wb.yourdomain.com
```
注：脚本会自动配置 Docker、拉取前后端核心容器镜像、申请 SSL 证书并启动 Nginx 反向代理。
记录管理凭证： 安装完成后，终端会输出管理面板访问地址（https://wb.yourdomain.com）、默认管理员用户名（admin）以及随机生成的强密码。

3. 访问 Web 控制台与授权账号

在浏览器打开部署成功后的管理域名：https://wb.yourdomain.com。
输入管理员账号 admin 和终端输出的随机密码进行登录。
绑定 WorkBuddy 账号：
- 进入 【账号管理】，点击添加账号（区分“国际版”或“国内版”）。
- 点击 【快速添加 / 浏览器授权】，复制生成的授权链接并在已登录 WorkBuddy 的浏览器窗口中打开并确认。
- 授权成功后返回后台，系统会自动识别并同步账号状态与可用积分。

4. 创建 API 密钥与客户端调用

4.1 生成调用密钥 (API Key)

在管理后台左侧进入 【密钥管理】。
点击 新建密钥，选择关联的账号类型（国内版或国际版），输入备注名称并点击创建。
系统会生成一个专属 API Key（如 sk-...），请立即复制保存（密钥仅在创建时完整显示一次）。

4.2 客户端配置（以 Chatbox / 千问客户端 / 各种 AI 客户端为例）

打开任何兼容 OpenAI API 协议的客户端，配置自定义供应商：

接口类型： OpenAI 兼容
接口地址 (Base URL)： https://wb.yourdomain.com/v1
API 密钥 (API Key)： 填入在 4.1 步中生成的 API Key
模型名称： 填入后台拉取到的完整模型名称（如 deepseek-v3、claude-3-7-sonnet 等，国际版账号注意按后台提示添加国际版标识前缀）

配置完成后点击连接测试，成功收到回复后即可开始使用。

积分消耗注意： 后台模型列表会标明各模型的计费倍率。国际版部分开源模型（如指定 DeepSeek 模型）每日调用免扣积分，高阶专有模型则会按倍率扣除账号积分。可结合后台内置的每日自动签到功能实现积分日常维护。

5. 卸载与清理服务

如果需要停止并彻底移除该反向代理服务，可直接清理 Docker 容器及相关工作目录：

# 停止并移除容器和挂载卷
docker stop workbuddy2api-ui workbuddy2api 2>/dev/null
docker rm workbuddy2api-ui workbuddy2api 2>/dev/null

# 若使用 docker-compose 部署，进入对应目录执行：
# docker compose down -v

# 清理相关配置与数据目录
rm -rf /opt/workbuddy2api /root/workbuddy2api

6. 项目与教程来源

教程出处： YouTube 频道「Teyir科技」——《workbuddy反代实现Token自由积分自由！免费白嫖各种大模型API教程 🚀》
视频链接： https://www.youtube.com/watch?v=_ZVE_jjhfvk
主流开源参考项目： baiyea/workbuddy2api-ui / ithtelab/workbuddy-manager
技术规范： 基于 Docker 容器化运行，提供 OpenAI Chat Completions 与 Anthropic Messages 协议反代转换。