用途:把前端项目部署到 Vercel,并自动完成自定义域名与 DNS 配置。适用于用户说“deploy to vercel”或“部署到某域名”、前端项目构建后需要托管、或为已有 Vercel 部署设置自定义域名时。
主要能力:自动识别项目类型(Vite、Next.js、CRA、静态站点);为 Vite/CRA 等 SPA 项目在缺失时创建 vercel.json 重写规则;执行 Vercel 部署;添加自定义域名并设置 alias;通过 Cloudflare API 自动创建或更新 CNAME 记录;最后验证域名可访问性并输出摘要。
使用方式:通过 $ARGUMENTS 传入参数,如 <domain>(要配置的自定义域名)、--preview(仅预览部署)、--no-dns(跳过 Cloudflare DNS 自动配置)、--link-only(仅关联项目不部署)。部署前先检查 CLI:vercel --version || npm i -g vercel;部署命令为 vercel --yes --prod。配置域名需先 vercel domains add "$DOMAIN",再 vercel alias set "$PROD_URL" "$DOMAIN",仅添加域名不够,必须设置 alias 否则会返回 ERR_CONNECTION_CLOSED。Cloudflare DNS 自动配置需要环境变量 CLOUDFLARE_API_KEY(具备 DNS 编辑权限的 API Token),CNAME 目标为 cname.vercel-dns.com,proxied 必须为 false(仅 DNS),否则会与 Vercel 的 SSL 证书签发冲突;未设置该变量时改为打印手动 DNS 指引。
限制与注意:package.json 的 name 必须为小写且无特殊字符,否则报“Project names must be lowercase”;SPA 子路由 404 需补 vercel.json 重写;SSL 未就绪多因 Cloudflare 代理开启;DNS 解析到 198.18.x.x 通常是本地代理所致。生产部署前若目标项目、生产/非生产模式或自定义域名不明确,应先向用户确认。