我用 Cloudflare Worker 搭了个 AI 网关，白嫖 Agnes + DeepSeek 双模型，还能给 Hermes 用

Duckdblab2026-10-04 12:04

我用 Cloudflare Worker 搭了个 AI 网关，白嫖 Agnes + DeepSeek 双模型，还能给 Hermes 用

关键词：Cloudflare Worker、AI 网关、Agnes、DeepSeek、Hermes Agent、智能路由、故障转移

一、为什么要自己搭 AI 网关

最近在用 Hermes Agent 做自动化任务，但遇到几个痛点：

  1. 单一 API 不稳定：Agnes 便宜但偶尔限流，DeepSeek 稳定但贵
  2. 切换麻烦：每次换个模型都要改客户端配置
  3. Key 暴露风险：把上游 Key 直接写在客户端里，泄露了很危险
  4. workers.dev 被墙：想用 Cloudflare Worker 做中转，但默认域名国内访问不了

于是花了半天时间，用 Cloudflare Worker 搭了个智能路由网关，实现：

  • ✅ Agnes 优先，DeepSeek 兜底：Agnes 限流/异常时自动降级
  • ✅ 统一鉴权：客户端只拿一个 ACCESS_TOKEN，上游 Key 完全隐藏
  • ✅ 自定义域名：绑定自己的域名，国内直连
  • ✅ 支持流式输出：SSE 逐字返回，体验和官方一致
  • ✅ 完全免费：Cloudflare Workers 免费额度每天 10 万请求

二、最终效果

先看结果。用 curl 测试：

bash 复制代码 
curl -X POST "https://api.061420.xyz/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的ACCESS_TOKEN" \
  -d '{"model":"deepseek-flash","messages":[{"role":"user","content":"你好"}],"stream":false}'

返回：

json 复制代码 
{
  "id": "a14aac65-...",
  "model": "deepseek-flash",
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "你好！有什么可以帮你的吗？"
    }
  }],
  "usage": {"total_tokens": 85}
}

流式输出也完美：

复制代码 
《秋思》
霜枫染半秋，雁字过西楼。
暮色寒烟起，孤灯照客愁。

三、核心架构

scss 复制代码 
客户端 (Hermes/curl/ChatBox)
        ↓
   api.061420.xyz (自定义域名)
        ↓
   Cloudflare Worker (智能路由)
        ↓
   ┌─────────┐         ┌──────────┐
   │  Agnes  │  ──→    │ DeepSeek │
   │ (优先)  │  降级    │  (兜底)  │
   └─────────┘         └──────────┘

降级触发条件：

  • 401/403 鉴权失败
  • 429 限流
  • 5xx 服务端错误
  • fetch 网络异常

不触发降级：

  • 400 参数错误（客户端问题，换后端也没用）

四、完整代码（可直接部署）

1. Worker 核心代码

javascript 复制代码 
const AGNES_BASE_URL = "https://apihub.agnes-ai.com/v1";
const DEEPSEEK_BASE_URL = "https://api.deepseek.com/v1";

export default {
  async fetch(request, env) {
    const url = new URL(request.url);

    // 权限验证
    const clientAuth = request.headers.get("Authorization");
    const expectedToken = `Bearer ${env.ACCESS_TOKEN}`;

    if (!env.ACCESS_TOKEN) {
      return new Response(
        JSON.stringify({ error: "Server misconfigured" }),
        { status: 500, headers: { "Content-Type": "application/json" } }
      );
    }

    if (clientAuth !== expectedToken) {
      return new Response(
        JSON.stringify({ error: "Unauthorized" }),
        { status: 401, headers: { "Content-Type": "application/json" } }
      );
    }

    // 健康检查
    if (url.pathname === "/" || url.pathname === "") {
      return new Response(
        JSON.stringify({ service: "router", status: "running" }),
        { status: 200, headers: { "Content-Type": "application/json" } }
      );
    }

    if (!url.pathname.startsWith("/v1")) {
      return new Response(
        JSON.stringify({ error: "Not Found" }),
        { status: 404, headers: { "Content-Type": "application/json" } }
      );
    }

    // 读取请求体
    let body = undefined;
    if (request.method === "POST") {
      body = await request.text();
    }

    const upstreamPath = url.pathname.replace(/^\/v1/, "");
    const agnesUrl = AGNES_BASE_URL + upstreamPath;

    try {
      const agnesRequest = new Request(agnesUrl, {
        method: request.method,
        headers: {
          "Content-Type": "application/json",
          Authorization: `Bearer ${env.AGNES_API_KEY}`,
        },
        body: body,
      });

      const agnesResponse = await fetch(agnesRequest);

      if (
        agnesResponse.status === 401 ||
        agnesResponse.status === 403 ||
        agnesResponse.status === 429 ||
        agnesResponse.status >= 500
      ) {
        throw new Error(`Agnes failed: ${agnesResponse.status}`);
      }

      return new Response(agnesResponse.body, {
        status: agnesResponse.status,
        headers: {
          "Content-Type": agnesResponse.headers.get("Content-Type") || "application/json",
          "X-Upstream": "Agnes",
        },
      });
    } catch (error) {
      console.warn("Agnes 不可用，切换到 DeepSeek:", error.message);

      const deepseekUrl = DEEPSEEK_BASE_URL + upstreamPath;

      try {
        const deepseekRequest = new Request(deepseekUrl, {
          method: request.method,
          headers: {
            "Content-Type": "application/json",
            Authorization: `Bearer ${env.DEEPSEEK_API_KEY}`,
          },
          body: body,
        });

        const deepseekResponse = await fetch(deepseekRequest);

        return new Response(deepseekResponse.body, {
          status: deepseekResponse.status,
          headers: {
            "Content-Type": deepseekResponse.headers.get("Content-Type") || "application/json",
            "X-Upstream": "DeepSeek",
          },
        });
      } catch (deepseekError) {
        return new Response(
          JSON.stringify({ error: "Both upstreams unavailable" }),
          { status: 502, headers: { "Content-Type": "application/json" } }
        );
      }
    }
  },
};

2. Cloudflare 图形化部署步骤

第一步：创建 Worker

  • 登录 Cloudflare Dashboard
  • Workers & Pages → Create Worker → 命名 agnes-deepseek-router
  • 粘贴上面的代码，Deploy

第二步：配置环境变量

  • Worker → Settings → Variables and Secrets
  • 添加三个 Secret 类型变量：
    • AGNES_API_KEY：Agnes 平台的 Key
    • DEEPSEEK_API_KEY：DeepSeek 官方的 Key
    • ACCESS_TOKEN：你自己生成的随机令牌（客户端用它鉴权）

第三步：绑定自定义域名（关键！）

  • Worker → Settings → Domains & Routes → Add Custom Domain
  • 输入 api.你的域名.com
  • 不要用 Route，用 Custom Domain，Cloudflare 会自动处理 DNS 和 SSL

⚠️ 避坑：workers.dev 域名在国内被 SNI 阻断，必须绑定自定义域名才能用。

五、配置 Hermes Agent

Hermes 支持自定义 OpenAI 兼容端点。最可靠的配置方式：

编辑 ~/.hermes/config.yaml：

yaml 复制代码 
model:
  provider: custom:myrouter
  default: deepseek-flash

custom_providers:
  - name: myrouter
    base_url: https://api.061420.xyz/v1
    key_env: HERMES_ROUTER_KEY
    model: deepseek-flash
    api_mode: chat_completions

编辑 ~/.hermes/.env：

ini 复制代码 
HERMES_ROUTER_KEY=你的ACCESS_TOKEN值

验证：

bash 复制代码 
hermes chat -q "Reply with exactly: provider ok"

如果报 Provider authentication failed，去 ~/.hermes/logs/gateway.log 看 401 还是 404。401 是 Token 不匹配，404 是路径问题。

六、踩坑记录

坑 1：workers.dev 国内连不上 curl: (28) Failed to connect，不是代码问题，是域名被墙。必须绑自定义域名。

坑 2：自定义域名返回空 404 Content-Length: 0 的 404 是 Cloudflare 边缘返回的，说明请求没到 Worker。原因是用了 Route 通配符 *.域名/*，被其他路由吃掉了。改用 Custom Domain 解决。

坑 3：Agnes 返回 429 限流 免费额度用尽会限流。你的降级逻辑会自动切到 DeepSeek，但想用 Agnes 优先就得升级套餐或降低频率。

坑 4：模型名不匹配 Agnes 支持的模型是 deepseek-flash 和 deepseek-v4-pro，不是 agnes-3.0-flash。传错会返回 400。

七、总结

整套方案成本：

项目 成本
Cloudflare Workers 免费（10 万请求/天）
自定义域名 已有域名即可
Agnes 免费额度 免费（有限流）
DeepSeek 兜底 按量付费

核心价值：

  • 一个域名统一入口，客户端零配置切换
  • Agnes 优先，成本最低
  • DeepSeek 兜底，可用性最高
  • Token 统一鉴权，上游 Key 不暴露

如果你也在用 Hermes、ChatBox、NextChat 这类工具，强烈建议搭一个。半天时间，一劳永逸。

相关资源：

如果这篇对你有帮助，点个赞再走～有问题评论区见！

相关推荐
海宇数据1 小时前
零信任架构实战：基于海宇活体识别V步骤1构建自动化考前活体认证网关
运维·人工智能·架构·自动化
bullkingluo1 小时前
从零到一搭建企业级智能问答系统：Ch12 · 结构化输出与工具调用
人工智能·架构·llm
桃西西呀1 小时前
LangChain 之五：智能体与工具
人工智能·langchain·llm
bullkingluo1 小时前
从零到一搭建企业级智能问答系统：Ch11 ·大模型调参与效果评测
人工智能·架构·llm
模拟器连接器曾工1 小时前
一进多出M12分线盒4口8口12口可选 PNP和NPN通用传感器集线器
网络·人工智能·m12分线盒·npn通用传感器集线器·pnp通用传感器集线器
回眸&啤酒鸭1 小时前
GLM 5.3 Flash 批量处理实战指南
大数据·人工智能
羲云1 小时前
用 AceData Studio 做 AI 短片：从分镜、首帧到参考图编辑
人工智能
硅谷秋水1 小时前
EmbodiedSWE：面向长时程灵巧机器人的编程智能体
人工智能·机器学习·语言模型·机器人·软件工程
郝学胜_神的一滴1 小时前
AI 编程智能体 04：一文看懂智能体的核心能力与概念辨析
人工智能·python
热门推荐
01如何新建文件夹？ 电脑新建文件夹的4种方法02历年考研数学一、数学二、数学三真题试卷及答案PDF03国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）04Telegram APK 下载安装完整指南 — 2026年最新05蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接06GitHub 镜像站点072026 爱知・名古屋亚运会怎么看？直播平台+赛程安排分享08微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新09Windows 10/11 如何退出微软账户并改用本地账户登录（含找不到选项的解决方法）10给AI一张“业务概念地图“：本体如何从哲学走向企业智能