SuperAPI AI 工具集

lovstudio-deploy-to-vercel

部署与运维

查看项目

更新于 10-16 00:01

技能介绍

用途:把前端项目部署到 Vercel,并自动完成自定义域名与 Cloudflare DNS 配置。适用于用户说“deploy to vercel”或“部署到某域名”、前端项目构建后需要托管、或为已有 Vercel 部署设置自定义域名时。

主要能力:自动识别项目类型(Vite、Next.js、CRA、静态站点);为 Vite/CRA 等 SPA 项目在缺失时生成 vercel.json 重写规则;调用 Vercel CLI 部署;添加自定义域名并设置 alias;通过 Cloudflare API 创建或更新 CNAME 记录指向 cname.vercel-dns.com;最后验证域名是否返回 200。

使用方式:通过 $ARGUMENTS 传入参数,如 <domain>(如 sbti.lovstudio.ai)、--preview(仅预览部署)、--no-dns(跳过 Cloudflare DNS 自动配置)、--link-only(仅关联项目不部署)。核心命令包括 vercel --yes --prod、vercel domains add "$DOMAIN"、vercel alias set "$PROD_URL" "$DOMAIN"。Cloudflare 部分需设置 CLOUDFLARE_API_KEY 环境变量(具备 DNS 编辑权限的 API Token)。

限制与注意:仅 vercel domains add 不够,必须再执行 vercel alias set,否则域名会返回 ERR_CONNECTION_CLOSED;package.json 的 name 必须为小写且无特殊字符,否则报“Project names must be lowercase”;Cloudflare 记录的 proxied 必须为 false(仅 DNS),否则与 Vercel 的 SSL 证书签发冲突;SPA 子路由 404 需补 vercel.json 重写;未设置 CLOUDFLARE_API_KEY 时只输出手动 DNS 指引。DNS 解析到 198.18.x.x 通常是本地代理所致,可用 dig @8.8.8.8 检查。