用路由白名单安全联调模型回调
托管视频模型需要从本机下载输入文件,再通过 Webhook 回传结果。作者在公网隧道前加了白名单,只开放带时效签名的文件下载和模型回调,避免暴露启用免密登录的开发应用。
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 服务里引用它的地方。任务轮询器、演练模式和静态素材下载都可能经由公网入口绕回来。