
### 前言
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](https://vercel.com/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 管理页面添加记录。

#### 推荐方案（最常用）
| 域名类型       | 记录类型 | 主机记录 | 记录值（以仪表板显示为准）          | 备注 |
|----------------|----------|----------|------------------------------------|------|
| **www 子域名** | CNAME    | `www`    | `cname.vercel-dns.com`             | 推荐 |
| **根域名 (Apex)** | A     | `@` 或留空 | `76.76.21.21`                      | 必须用 A，不能用 CNAME |

**中国/香港用户优化（强烈建议）**：
- 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`
- 用命令检查：
  ```bash
  dig example.com A          # 检查根域名
  dig www.example.com CNAME  # 检查子域名
  ```
---

### 步骤 4：设置 www 重定向
1. 在 Domains 页面同时添加 `example.com` 和 `www.example.com`
2. 为其中一个域名设置 **Redirect** 到另一个（避免重复内容，SEO 更好）
   - 推荐：非 www → www（或反之）
---

### 使用 CLI 添加（可选）
```bash
# 添加域名
vercel domains add example.com

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

---

### 常见问题排查
| 问题                  | 解决方法 |
|-----------------------|----------|
| **Invalid Configuration** 一直显示 | 确认记录类型、值、主机完全一致（无多余空格） |
| **DNS 未生效**        | 等待 TTL 时间，用 dnschecker.org 检查 |
| **大陆访问慢/打不开** | 使用 `cname-china.vercel-dns.com` + Cloudflare Proxy（橙色云朵） |
| **域名已被其他 Vercel 账号使用** | 添加 TXT 验证记录（Vercel 会提示） |
| **SSL 未颁发**        | DNS 正确后多等 5-10 分钟，Vercel 会自动重试 |
| **根域名无法访问**    | 确认用了 A 记录，不是 CNAME |

---

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