3 phút đọc
pingmike2/freebuff2api-wokers: Repository mã nguồn mở trên GitHub. – Repository pingmike2/freebuff2api-wokers. Mô tả: Repository mã nguồn mở trên GitHub.. 376 stars, 225 forks, ngôn ngữ chính JavaScript, cập nhật 2026-09-14.
1. Repository làm gì?
🎉 欢迎使用与交流！有任何问题或想法欢迎提 Issue / PR。 开源协议：AGPL-3.0
把 freebuff/codebuff 的免费模型暴露成 OpenAI-compatible API。单文件无依赖，推荐 Docker 容器部署（或自建 VPS 运行），适配任意 OpenAI SDK / 客户端（QwenPaw、Hermes、ChatGPT-Next-Web、LobeChat、one-api 等）。
⚠️ 部署方式重要提示：Freebuff 官方已检测 Cloudflare Worker 部署（识别 cf-worker / cf-ray 等边缘标记），在 CF 上部署会显著增加账号被封禁的风险。因此本项目不推荐 Cloudflare 部署，推荐使用 Docker 容器或自建 VPS 运行（见下方「🐳 Docker 容器化部署」）。
主代码已加入 Anthropic Messages API 适配，当前支持：
⚠️ 测试说明：当前项目维护者没有实际使用 Anthropic Messages API 的客户端环境，因此暂未完成真实 Anthropic 客户端的端到端测试。主代码和本地 stub / 回归测试已经处理并验证转换逻辑，但不代表所有 Anthropic SDK、工具调用组合和客户端行为都已覆盖。
如果你有 Anthropic Messages API 的实际使用场景，欢迎在不影响现有 OpenAI API 线路的前提下进行测试，并反馈请求格式、流式响应、工具调用或模型兼容性问题。反馈时请尽量附上脱敏后的请求结构、响应状态码和错误信息。
2. Dữ liệu và cấu trúc đáng chú ý
Anthropic API 是新增的协议适配层，不改变现有 OpenAI /v1/chat/completions、/v1/responses、账号轮换、session 生命周期和 Freebuff 主调用链。
⭐ 特殊模型：DeepSeek V4 Flash 与 MiMo 2.5
Worker 通过 Cloudflare Workers 访问 Freebuff，上游通常会将请求识别为美国/完整访问模式。官方 Desktop 在完整模式下将下面两个模型归入 unlimited 非 Premium 类别；这里的 unlimited 主要表示模型分类和并发类别，不是对所有账号、地区、接口和时间都作绝对无限量保证：
⚠️ 受限模式官方明确为 DeepSeek V4 Flash 和 MiMo 2.5 每天 6 个一小时 session；Worker 默认走美国出口，通常不属于该受限模式。最终是否可用及实际额度仍以 Freebuff 上游返回为准，官方规则也可能调整。
除这两个特殊模型外，普通模型统一按 每日 6 次基础 session / 太平洋日 理解（北京时间约 15:00 重置）。referral、streak、独立共享池和上游临时限制属于额外条件，不能据此宣传为无限量。
💡 关于额度：扣额度按「创建 session」计（不是每次对话）。一次 session 约 1 小时有效，期间多轮对话不重复扣。所以 4 个账号 × 每天 6 次 ≈ 全天覆盖。
📝 广告与 streak 说明：创建新 session 前，Worker 会按官方客户端流程请求广告，并调用 GET /api/v1/freebuff/streak 尝试签到。连续使用是否获得额外额度、额度增加多少，由 freebuff 官方服务端决定；该流程不是额度保证，也不会改变 session 本身的扣额度规则。
3. Khả năng ứng dụng và giới hạn
🌐 自定义域名：如果 *.workers.dev 域名访问不通（部分地区被墙/受限），可给 Worker 绑定自己的域名，Base URL 改为 https://你的域名/v1。配置方法见下方「自定义域名」。
freebuff 登录凭证（authToken）通过官方 CLI 同款授权码轮询获取。项目自带提取工具 freebuff_tools/extract_freebuff.py，交互方式与 cline_oauth.py 一致。
方式 A：GitHub Actions 工作流（推荐，远程提取）
仓库自带工作流 .github/workflows/extract-token.yml，在 GitHub Actions 里跑提取，授权链接和 token 只发到你的 Telegram，日志全程掩码（::add-mask::），不泄露敏感信息。
第一步：配置 Secrets（仓库 Settings → Secrets and variables → Actions）：
没配 TG_BOT_TOKEN / TG_CHAT_ID 时工作流第一步直接失败，不会执行提取。
本地运行 login 时，每个账号会分键追加保存到 freebuff_tools/freebuff_credentials.json（不覆盖已有账号，支持 Google / GitHub 登录，均自动记录）。该文件已被 .gitignore 忽略，不会提交到 GitHub；结构参考 freebuff_tools/freebuff_credentials.example.json。
💡 show 内部用 GET /api/v1/freebuff/session 探测每个账号（不创建 session、0 消耗），一次显示全部状态：存活 + 额度 / token 失效 / 被封禁 / 地区受限 / 额度用完。官方对 banned 账号会在所有接口返回 status: banned。多账号时 export 输出的每行 token 直接粘贴到 Cloudflare Worker 变量 FREEBUFF_TOKEN（换行分隔）即可。
适合本地/NAS/VPS 长期运行：不受 Cloudflare Workers 限制，不会暴露 CF 边缘标记（cf-worker / cf-ray），账号封禁风险显著低于 CF 部署。镜像已发布到 Docker Hub，无需 clone 仓库、无需构建，一条命令即可部署。
Số liệu repository có thể thay đổi; nên mở liên kết nguồn để kiểm tra README, giấy phép và trạng thái phát hành.
Nguồn tham khảo: Xem bài gốc
