SuperAPI AI 工具集

devbox-preview

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

用途:这是 nextjs-fastapi-chat-app-starter 的 Devbox 预览知识,供在 Vercel Devbox/Sandbox(而非本机)运行该 starter 时使用,目标是让预览正常可用,用户无需深入调试 Devbox 内部机制。主要能力与配置:前端需允许 Vercel Sandbox 预览来源,在 Next.js 开发中保留 frontend/next.config.js 的 allowedDevOrigins: [".vercel.run"];否则 Next.js 虽能返回页面,却会拦截来自 https://sb-...vercel.run 的开发专用资源(如 HMR),造成难以理解的预览失败。预览模型:在 Devbox 中,localhost 指远端盒子而非用户笔记本;用户应打开端口 3000 对应的已发布 Sandbox URL,通常形如 https://sb-...vercel.run,不要让其访问本机 http://localhost:3000。前端与后端均通过端口 3000 上的 Vercel dev 访问:前端为 /,后端为 /api/。使用方式:在 Devbox SSH 会话中运行 vercel dev -L --listen 0.0.0.0:3000;随后在 Devbox SSH 之外的本地终端发布端口 3000,执行 SANDBOX_ID=$(devbox get --output json | python3 -c 'import json, sys; print(json.load(sys.stdin)["response"]["devboxes"][0]["sandboxId"])') 与 sandbox config ports "$SANDBOX_ID" -p 3000,再打开该命令输出的 https://sb-...vercel.run 地址。排障:若 Devbox 内 curl -i http://127.0.0.1:3000/ 正常而浏览器失败,优先怀疑 Sandbox 端口发布或 allowedDevOrigins;出现跨源开发资源警告时检查 frontend/next.config.js 并重启 vercel dev;Devbox 内 curl 返回 500 时查看 vercel dev 终端日志中的应用错误。限制:资料未提供其他平台支持、收费或版本兼容信息。