转载请注明出处：小锋学长生活大爆炸[xfxuezhang.cn]
如果本文帮助到了你，欢迎[点赞、收藏、关注]哦~
如果你不想买Token Plan，又想用免费模型，那学长真心建议你跟着我走完这篇教程！！！
软件介绍
WorkBuddy很好用，而且经常有免费无限制的模型可以薅，但它不能对外提供API给Claude、Codex用，非常可惜。
今天学长发现了几个开源项目，直接把WorkBuddy协议给逆向了，从而实现了让WorkBuddy能对外提供OpenAI和Anthropic格式的API。并且对Windows系统支持一键启动脚本，还支持部署到NAS，总之非常牛批。这三个项目都是同一类型的，如果要最简单的就用第1个，如果要最复杂的就用第3个，如果要部署到NAS的推荐用第2个：
- • https://github.com/Tom6814/WorkBuddy2API
- • https://github.com/linguo2625469/workbuddy2api-panel
- • https://github.com/ardeyouxipianyi/workbuddy2api-hub
学长想部署到飞牛上，所以学长选择了第2个项目。
部署步骤
1、安装非常简单，登录飞牛后执行以下命令即可：
curl -fsSL https://gh-proxy.com/https://raw.githubusercontent.com/ardeyouxipianyi/workbuddy2api-hub/main/quick-deploy.sh | sudo bash或者也可以用compose：
services: wb-proxy: image: ghcr.io/ardeyouxipianyi/workbuddy2api-hub:latest # 或 ardeyouxipianyi/workbuddy2api-hub:latest container_name: wb-proxy restart: unless-stopped ports: - "8788:8788" # 左侧宿主端口可自选；右侧必须与下面的 PORT 一致 environment: - HOST=0.0.0.0 - PORT=8788 # - API_KEY=your_secret_key # 留空则自动生成并打印在启动日志 - TZ=Asia/Shanghai volumes: - ./accounts:/app/accounts # 账号凭证与配置（更新/重建容器不丢） - ./usage:/app/usage # 用量流水日志（更新/重建容器不丢）2、启动后：API 地址 http://127.0.0.1:8788/v1，Web 看板 http://127.0.0.1:8788/。首次启动还没有账号，打开看板点「+ 添加账号 (OAuth)」完成授权即自动入库。
- • 绿色包自带的精简 Python 运行时只覆盖 Windows；macOS / Linux 直接使用系统 Python，需要 3.9+（启动脚本找不到内置运行时会明确打印所用的解释器与版本）。Docker 部署自带基础镜像，不受影响。
- • zip 解压后若提示权限不足，先执行一次：chmod +x start-wb-proxy.sh start-wb-proxy.command start-wb-proxy-lan.sh start-wb-proxy-lan.command allow-firewall.command
3、看板需要面板访问密码（默认 admin），它与 API Key 相互独立：密码只用于打开看板，可在「设置」页修改（或启动时 --panel-password 指定），以 PBKDF2-SHA256 摘要存于 accounts/settings.json（不存明文），登录态只留在浏览器会话里。
本机 / 受信局域网自用可带 ?pwd=面板密码 免手输直接进面板（如 http://127.0.0.1:8788/?pwd=admin）；公网暴露时不要用——密码会留在浏览器历史与反向代理日志里。注意它和局域网共享的 ?key= 不同：?key= 只把 API Key 存给 /v1 用，不会自动登录面板。首次登录后请立即改掉默认密码。
4、首先点击“添加”来登录WorkBuddy。
如果只登陆了国内版，记得切换默认出口方式：
这里还能一键做任务：
5、首次启动生成高强度随机API Key，写入 accounts/settings.json 并打印在终端。也可以通过以下命令查看：
docker logs wb-proxy | grep -i 'api key'当然，如果上面的key无效，或者相关增加key，也可以在设置页面添加专属的API Key，它可以限制每个Key所能使用的模型，默认是无限制。
6、然后就可以在你本地测试了。
先测试一下模型列表：
https://ip:8788/v1/models?key=xxx
然后测试一下API调用：
最后测试一下接入cc-switch和claude：
url = https://ip:8788/v1 key = xxxxx非常完美！！
