Skip to Content
Nextra 4.0 is released 🎉
博客从零开始:用 Vercel + GitHub 实现自动化部署与自定义域名配置

从零开始:用 Vercel + GitHub 实现自动化部署与自定义域名配置

什么是 Vercel?

Vercel 是一个专注于 前端开发和静态站点部署 的云平台,以其极速、简单易用和开发者体验著称。它特别适合部署 Next.js、React、Vue、Svelte 等现代前端框架。

Vercel 核心优势

  • 全球边缘网络:自动部署到离用户最近的服务器节点
  • 无服务器函数:支持 Node.js, Go, Python 等后端逻辑
  • 自动 CI/CD:与 Git 仓库深度集成
  • 零配置:主流框架自动识别最优配置
  • 预览环境:每个 PR 生成独立可分享的测试 URL
  • 免费 HTTPS:自动为所有部署提供 SSL 证书

Vercel 与 GitHub 的完美协作

Vercel 与 GitHub 形成了前端开发的黄金组合:

关键集成点

  • 账号关联:使用 GitHub 账号直接登录 Vercel
  • 项目同步:直接导入 GitHub 仓库作为部署源
  • 自动化触发器
    • 主分支推送 → 生产环境部署
    • Pull Request → 预览环境部署
  • 状态反馈:部署状态实时显示在 GitHub commit/PR 页面

完整部署流程

第一步:准备 GitHub 仓库

  1. 创建新仓库

    # 在 GitHub 上创建新仓库 git clone https://github.com/yourusername/your-project.git cd your-project
  2. 初始化项目

    # 如果是 Next.js 项目 npx create-next-app@latest . --typescript --tailwind --eslint # 或者如果是现有项目 npm install
  3. 推送代码到 GitHub

    git add . git commit -m "Initial commit" git push origin main

第二步:配置 Vercel

  1. 登录 Vercel

  2. 导入项目

    • 点击 “New Project”
    • 选择 “Import Git Repository”
    • 选择你的 GitHub 仓库
    • 点击 “Import”
  3. 配置部署设置

    • Framework Preset:选择你的框架(如 Next.js)
    • Root Directory:如果项目在子目录,指定路径
    • Build Command:通常自动检测,如 npm run build
    • Output Directory:构建输出目录,如 .nextdist
    • Install Command:依赖安装命令,如 npm install
  4. 环境变量配置

    • 添加必要的环境变量
    • 如 API 密钥、数据库连接等
  5. 部署

    • 点击 “Deploy”
    • 等待构建完成

第三步:阿里云域名配置

1. 获取 Vercel 的 DNS 记录

在 Vercel 项目设置中找到 “Domains” 部分:

  • 添加你的自定义域名(如 yourdomain.com
  • Vercel 会提供必要的 DNS 记录信息:
    • A 记录:指向 Vercel 的 IP 地址
    • CNAME 记录:指向 Vercel 的域名
    • TXT 记录:用于域名验证

2. 在阿里云控制台配置 DNS

  1. 登录阿里云控制台

    • 进入 “域名” 管理页面
    • 找到你的域名,点击 “解析”
  2. 添加 DNS 记录

    • A 记录

      • 主机记录:@(代表根域名)
      • 记录值:Vercel 提供的 IP 地址
      • TTL:建议设置为 600 秒(10分钟)
    • CNAME 记录

      • 主机记录:www
      • 记录值:Vercel 提供的 CNAME 地址
      • TTL:建议设置为 600 秒(10分钟)
  3. 等待 DNS 生效

    • 重要提醒:DNS 配置完成后,不是立即生效的!
    • 通常需要等待 10分钟到24小时 不等
    • 影响因素:
      • TTL 设置值
      • 各地 DNS 服务器缓存
      • 网络运营商 DNS 刷新策略

3. 验证域名配置

  1. 检查 DNS 传播状态

    • 使用 whatsmydns.net  检查全球 DNS 传播状态
    • 使用 nslookupdig 命令检查本地 DNS 解析
  2. 等待 Vercel 验证完成

    • 在 Vercel 控制台查看域名状态
    • 显示 “Valid Configuration” 表示配置成功

常见问题与解决方案

1. DNS 解析失败

症状:域名无法访问,显示 DNS 解析错误

解决方案

  • 检查 DNS 记录是否正确添加
  • 确认 TTL 设置合理(建议 600 秒)
  • 等待 DNS 传播完成(通常 10-30 分钟)

2. HTTPS 证书问题

症状:HTTPS 访问失败,证书错误

解决方案

  • Vercel 会自动为自定义域名生成 SSL 证书
  • 确保 DNS 配置正确且已生效
  • 等待证书生成完成(通常 24 小时内)

3. 部署失败

症状:代码推送后 Vercel 部署失败

解决方案

  • 检查构建日志,定位具体错误
  • 确认 package.json 中的脚本配置正确
  • 检查环境变量是否配置完整

最佳实践建议

1. DNS 配置优化

  • TTL 设置:生产环境建议 600 秒,开发环境可以设置更短
  • 多级域名:合理规划子域名结构
  • 备份记录:考虑添加备用 DNS 记录

2. 部署策略

  • 分支部署:主分支自动部署到生产环境
  • 预览部署:PR 自动生成预览链接
  • 回滚机制:保留历史部署版本,支持快速回滚

3. 监控与维护

  • 性能监控:使用 Vercel Analytics 监控网站性能
  • 错误追踪:集成错误监控服务
  • 定期检查:定期验证 DNS 配置和 SSL 证书状态

总结

通过 Vercel + GitHub 的组合,你可以实现:

零配置自动化部署
全球边缘网络加速
免费 HTTPS 证书
预览环境支持
无缝域名管理

特别提醒:配置阿里云域名后,请耐心等待 DNS 生效,通常需要 10 分钟以上,这是正常现象,不要急于修改配置。

最近更新:12/9/2025, 2:17:54 AM