5 分钟把 Agent Skill 站点部署到 Vercel

前置条件

• 已安装 Node.js 18+
• 已有 Vercel 账号
• 项目已推送到 GitHub

步骤 1：安装 Vercel CLI

npm i -g vercel

步骤 2：登录 Vercel

vercel login

按提示在浏览器中完成授权。

步骤 3：关联项目

在项目根目录运行：

vercel link

选择你的 Vercel 团队和项目名称。首次部署会自动创建项目。

步骤 4：首次部署

vercel deploy --prod

Vercel 会自动检测 Next.js 项目，执行 next build，并将产物部署到全球 CDN。

步骤 5：绑定自定义域名

在 Vercel 控制台 → Settings → Domains 中添加你的域名。

然后在 DNS 服务商处添加 CNAME 记录：

类型	名称	目标
CNAME	agentskil	cname.vercel-dns.com

⚠️ 重要：先不要开启 CDN 代理（如 Cloudflare 的橙色云），使用纯 DNS 模式让 Vercel 完成域名验证后再开。

步骤 6：验证

• 访问 https://agentskil.qzz.io 确认站点可访问
• 检查 SSL 证书是否自动配置（Vercel 自动处理）
• 用 PageSpeed Insights 检查性能

常见问题

构建失败

• 检查 next build 是否在本地通过
• 查看构建日志中的错误信息
• 确认 Node.js 版本匹配（在 package.json 中指定 engines）

域名验证失败

• 确认 CNAME 记录已生效（用 dig agentskil.qzz.io 检查）
• 关闭 CDN 代理后重试

404 错误

• 确认 vercel.json 中没有冲突的重写规则
• 检查 Next.js App Router 的路由结构是否正确