基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
技术实践2026-11-20 16:29

用路由白名单安全联调模型回调

dev.to · AI#本地联调#访问控制#模型回调
Editor brief · 编辑速览

托管视频模型需要从本机下载输入文件,再通过 Webhook 回传结果。作者在公网隧道前加了白名单,只开放带时效签名的文件下载和模型回调,避免暴露启用免密登录的开发应用。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

AI 深度解读

托管视频模型要先从 URL 下载输入文件,任务结束后还要向 Webhook 发起 POST。模型服务访问不到你电脑上的 localhost,于是作者用 cloudflared 开了一个临时公网入口。但本地应用开着 DEV_AUTO_SIGNIN=1,如果直接把入口指向开发服务器,拿到地址的人就能以本地账号打开应用。

作者在隧道前加了一段约 30 行的 Node.js 代理,只转发取文件和收回调所需的请求。最值得借鉴的是上线前的验证顺序:先确认应用页面进不去,再确认放行的接口依然验签,最后用一条真实签名 URL 验证文件确实能下载。

随机域名为什么挡不住免密登录

把 cloudflared tunnel --url http://127.0.0.1:3000 指向开发服务器,几秒内就能拿到一个形如 https://<random>.trycloudflare.com 的公网地址。这个地址会跟着文件 URL 一起交给模型服务,也会出现在对方的日志里。只要有人看到或猜到域名,就能访问被转发的页面。作者的应用会自动登录本地账号,而应用后端还接着真实的模型 API key。

模型服务实际只需要两类请求。第一类是 GET /api/files/<bucket>/<key>?exp=…&sig=…,文件路由用 HMAC 校验 bucket、key 和过期时间。第二类是 POST /api/webhooks/model,回调路由用未经解析的请求体校验供应商签名。两条路由本来就有自己的认证逻辑,代理只需决定哪些请求能抵达应用。

Node 代理放行哪些请求

下面的代理在 127.0.0.1:3001 接收隧道流量,把符合规则的请求转到 127.0.0.1:3000。

// allow.mjs — the tunnel's front door: only what the provider needs gets through.
import http from 'node:http';

const TARGET = { host: '127.0.0.1', port: 3000 };
const PORT = 3001;

const allowed = (method, path) =>
  ((method === 'GET' || method === 'HEAD') && path.startsWith('/api/files/')) ||
  (method === 'POST' && path === '/api/webhooks/model');

http
  .createServer((req, res) => {
    const path = new URL(req.url, 'http://x').pathname;
    const ok = allowed(req.method, path);
    console.log(new Date().toISOString(), ok ? 'pass' : 'refuse', req.method, path);
    if (!ok) {
      res.writeHead(404).end();
      return;
    }
    const upstream = http.request(
      { ...TARGET, method: req.method, path: req.url, headers: { ...req.headers, host: `localhost:${TARGET.port}` } },
      (up) => {
        res.writeHead(up.statusCode ?? 502, up.headers);
        up.pipe(res);
      },
    );
    upstream.on('error', () => res.writeHead(502).end());
    req.pipe(upstream);
  })
  .listen(PORT, '127.0.0.1', () => console.log('proxy on', PORT));

留意 http.request 里的 path: req.url。代理用 pathname 判断是否放行,转发时用原始请求 URL,因此文件路由还能拿到 exp 和 sig。文件规则按 /api/files/ 前缀放行 GET 和 HEAD,这个前缀下的路由都得自己做好认证。请求头只改写 Host;如果应用信任 X-Forwarded-*,需要明确这些头由哪一层设置。

作者运行 node allow.mjs,再用 cloudflared tunnel --no-autoupdate --url http://127.0.0.1:3001 建隧道。开发服务器用隧道地址生成签名 URL 和注册 Webhook,浏览器继续打开 http://localhost:3000。

从公网测一遍,哪些状态码才算对

作者在提交真实任务前,从隧道地址跑了六个请求,检查代理的拒绝规则和应用的验签逻辑。

U=https://<random>.trycloudflare.com
curl -s -o /dev/null -w '%{http_code}\n' $U/                          # 404
curl -s -o /dev/null -w '%{http_code}\n' $U/studio                    # 404
curl -s -o /dev/null -w '%{http_code}\n' $U/api/auth/get-session      # 404
curl -s -o /dev/null -w '%{http_code}\n' -X POST $U/api/generate      # 404
curl -s -o /dev/null -w '%{http_code}\n' $U/api/files/uploads/x       # 403: reached the app, no signature
curl -s -o /dev/null -w '%{http_code}\n' -X POST -d '{}' $U/api/webhooks/model   # 401: reached the app, bad signature

看最后两行。403 和 401 表明请求已经过了代理,分别被文件路由和回调路由拒绝。随后作者签了一条真实文件 URL,从公网下载时拿到了 200,内容类型和字节数也符合预期。任务跑起来后,代理日志显示模型服务对每个输入发了一次 GET,还对视频发了 HEAD 和第二次 GET,完成后发来了 POST。只测一次文件下载,很容易漏掉 HEAD。

演练模式还踩了一个坑。它用预置视频代替模型输出,开发服务器的任务轮询器会从自己的公开基地址下载片段。基地址换成隧道后,/media/ 被代理拦成 404,任务一直显示 running。作者于是把 /media/ 加入了允许列表。

我的判断

最有说服力的是这次实跑覆盖了三件事:应用页面挡得住,公开路由验签仍生效,供应商实际用到的请求也能走通。文章由负责小产品日常工作的 AI agent 撰写,经创始人审核。它给出了一次任务的验证和日志,没有提供对照数据,关于这种接法是否更省事,只能当作经验判断。

如果团队已有 staging,且能在那里用测试账号和测试密钥复现流程,staging 更适合反复跑联调。使用带访问规则的隧道,则要先确认供应商的文件下载端和回调端能满足规则。原文这段代理适合临时跑一次,因为它依赖上游路由各自验签,也没有限流,临时隧道没有可用性承诺。作者在任务结束后关闭了隧道和代理。

能拿来做什么

  • 给视频或文件处理 API 做本地联调时,先列出供应商需要的 HTTP 方法和路径。文件接口是否要放行 HEAD,可以用真实请求日志确认。
  • 提交真实任务前,把页面入口、无签名文件请求、无效回调和有效签名下载都测一遍。文件签名的有效期尽量短,同时留够供应商拉取和重试的时间。
  • 改公开基地址时,顺手搜索 Node 服务里引用它的地方。任务轮询器、演练模式和静态素材下载都可能经由公网入口绕回来。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
计费 API 如何处理智能体超时重试
下一篇
用 n8n 给入站消息分类并接入人工兜底

资讯速览

dev.to · AI · 2026-11-20 16:29

AI 评分 8.0 / 10

相关标签

#本地联调#访问控制#模型回调

继续阅读

  • 用固定评测决定是否保留智能体改动
  • 计费 API 如何处理智能体超时重试
  • 用 n8n 给入站消息分类并接入人工兜底
  • Google Ads 转化埋点的开发检查清单
  • 微软预览用 USB4 串联电脑跑大模型