Vercel部署Skill vercel

---

name: vercel description: 在Vercel上部署和管理应用程序，包括预览部署和部署保护。适用于处理Vercel托管项目或配置Vercel部署。 triggers:

• vercel
• preview deployment

---

Vercel部署指南

部署保护和代理访问

Vercel部署可能启用了部署保护，这需要身份验证才能访问预览部署。这可能会阻止自动化测试和代理访问预览URL。

识别受保护的部署

如果在访问Vercel预览URL时遇到登录页面或身份验证要求，则部署已启用保护。迹象包括：

• 重定向到 vercel.com/login 或SSO登录页面
• 访问部署时出现401/403错误
• 需要Vercel团队会员资格的预览URL

通过保护旁路启用代理访问

为允许代理和自动化系统访问受保护的部署，用户需要设置自动化保护旁路：

1. 导航到项目设置

   • 转到Vercel仪表板
   • 选择项目
   • 点击设置 → 部署保护

2. 生成保护旁路密钥

   • 在“自动化保护旁路”下，点击生成密钥
   • 安全地复制生成的密钥

3. 使用旁路密钥

   密钥可以通过两种方式使用：

   作为头部：

   curl -H "x-vercel-protection-bypass: <secret>" https://your-preview-url.vercel.app
   

   作为查询参数：

   https://your-preview-url.vercel.app?x-vercel-protection-bypass=<secret>
   

4. 用于基于浏览器的测试

   • 在预览URL后附加 ?x-vercel-protection-bypass=<secret>
   • 密钥将存储在cookie中，供后续请求使用

替代方案：为预览禁用保护

如果保护旁路不合适，用户可以禁用预览部署的保护：

1. 转到设置 → 部署保护
2. 将“Vercel身份验证”设置为仅生产部署或禁用

<重要> 如果您因身份验证要求无法访问Vercel预览部署，请告知用户他们需要：

1. 设置保护旁路密钥并提供给您，或者
2. 在其Vercel项目设置中禁用预览部署的部署保护

不要在没有旁路密钥的情况下重复尝试访问受保护的URL。 </重要>

环境变量

在Vercel仪表板的设置 → 环境变量中设置环境变量，或使用Vercel CLI：

vercel env add MY_SECRET

在您的应用程序中访问：

const secret = process.env.MY_SECRET;

Vercel CLI 命令

常见的Vercel CLI命令：

# 登录到Vercel
vercel login

# 部署到预览
vercel

# 部署到生产
vercel --prod

# 列出部署
vercel ls

# 查看部署日志
vercel logs <deployment-url>

# 拉取环境变量到本地
vercel env pull