用途:在 Vercel 上部署和管理应用,包括预览部署与部署保护配置,适用于处理 Vercel 托管项目或需要让自动化系统访问预览 URL 的场景。
主要能力与用法:
- 部署保护识别:若访问预览 URL 时跳转到 vercel.com/login 或 SSO 登录页、返回 401/403、或要求 Vercel 团队成员身份,说明已启用部署保护。
- 自动化绕过:在 Vercel Dashboard 进入项目 Settings → Deployment Protection,在 Protection Bypass for Automation 下点击 Generate Secret 生成密钥。使用方式有两种:作为请求头 curl -H "x-vercel-protection-bypass: <secret>" https://your-preview-url.vercel.app,或作为查询参数 https://your-preview-url.vercel.app?x-vercel-protection-bypass=<secret>。浏览器测试时在预览 URL 后追加该查询参数,密钥会存入 cookie 供后续请求使用。
- 替代方案:可将 Settings → Deployment Protection 中的 Vercel Authentication 设为 Only Production Deployments 或 Disabled,以关闭预览部署保护。
- 环境变量:在 Dashboard 的 Settings → Environment Variables 设置,或用 CLI 命令 vercel env add MY_SECRET,应用中通过 process.env.MY_SECRET 读取。
- 常用 CLI:vercel login、vercel(预览部署)、vercel --prod(生产部署)、vercel ls、vercel logs <deployment-url>、vercel env pull。
限制与注意:不要在未配置绕过密钥的情况下反复尝试访问受保护 URL。密钥需安全保存。资料未提供收费、价格、平台支持范围等更多信息。