Vercel 项目添加自定义域名完整指南

前言

Vercel 默认给每个项目提供 your-project.vercel.app 域名（支持预览部署）。
通过绑定自定义域名（Custom Domain），可以：

• 使用自己的品牌域名（如 example.com）
• 获得免费自动 SSL 证书（Let’s Encrypt）
• 支持重定向、路径重写等高级功能

支持的域名类型：

• Apex 根域名（example.com）
• 子域名（www.example.com、app.example.com）
• 通配符域名（*.example.com）

限制：Hobby 计划每个项目最多绑定 50 个自定义域名。

步骤 1：在 Vercel 仪表板添加域名

1. 登录 Vercel Dashboard
2. 选择你的项目
3. 左侧边栏 → Settings（设置）→ Domains（域名）
4. 点击 Add Domain（添加域名）

5. 输入域名：

   • 推荐同时添加 example.com + www.example.com
6. 点击 Add

Vercel 会立即显示 Invalid Configuration 并给出精确的 DNS 配置提示（每个项目值可能不同，请以仪表板显示为准）。

步骤 2：配置 DNS 解析

根据 Vercel 提示操作，在你的域名注册商（阿里云、腾讯云、Cloudflare、GoDaddy、Namecheap 等）的 DNS 管理页面添加记录。

推荐方案（最常用）

中国/香港用户优化（强烈建议）：

• CNAME 值改成 cname-china.vercel-dns.com（解析更快，避开 GFW 影响）
• Apex A 记录可尝试 76.223.126.88（若标准 IP 访问慢）

高级方案：使用 Vercel Nameservers（适合通配符域名）

1. Vercel 会给出 2 个 NS 记录（如 ns1.vercel-dns.com、ns2.vercel-dns.com）
2. 在域名商后台把整个域名的 Nameservers 全部改成 Vercel 的
3. 之后所有 DNS 记录（邮件、其他子域名）都在 Vercel 里管理

优点：自动支持通配符 SSL、更方便
缺点：需要迁移原有 DNS 记录

步骤 3：验证与 SSL 生效

• 保存 DNS 记录后，返回 Vercel 点击 Refresh（刷新）
• 等待 DNS 传播（通常 5-30 分钟，Cloudflare 最快）
• 状态变成 Valid / Active 即成功
• SSL 证书自动颁发（几分钟内完成，无需手动操作）

测试方法：

• 清除浏览器缓存
• 直接访问 https://yourdomain.com

• 用命令检查：

  dig example.com A          # 检查根域名
  dig www.example.com CNAME  # 检查子域名

步骤 4：设置 www 重定向

1. 在 Domains 页面同时添加 example.com 和 www.example.com

2. 为其中一个域名设置 Redirect 到另一个（避免重复内容，SEO 更好）

   • 推荐：非 www → www（或反之）

使用 CLI 添加（可选）

# 添加域名
vercel domains add example.com

# 查看 DNS 配置要求
vercel domains inspect example.com

常见问题排查

最佳实践

• 优先用 www.example.com 作为主域名（CNAME 更灵活）
• 香港用户：标准配置即可；若服务大陆用户，务必用 cname-china
• 生产域名绑定到 Production 分支（可在 Domains 设置中指定）
• 一个项目可绑定多个域名
• 推荐域名注册商：Cloudflare（免费 DNS + 安全）、Namecheap、阿里云