No title

Cloudflare Pages 域名解析功能详解

Cloudflare Pages 的域名解析功能，是将你拥有的自定义域名（如 blog.example.com）连接到 Pages 上部署的静态网站，让用户通过该域名访问你的内容。其核心依托 Cloudflare 强大的全球 DNS 和 CDN 网络，提供快速、安全的解析服务。

📌 核心功能

  1. 域名绑定：将你的 Pages 项目（项目名.pages.dev）与自定义域名关联。
  2. 自动 SSL 证书：为每个绑定域名自动颁发免费、可信的 SSL/TLS 证书，启用 HTTPS。
  3. 全球 CDN 加速：域名解析后，流量经由 Cloudflare 的全球边缘节点分发，降低延迟。
  4. 智能 DNS 管理：支持 A、CNAME、TXT 等多种记录，并提供 CNAME 展平（CNAME Flattening）等高级特性。

🧭 操作流程概览

  1. 在 Pages 项目中添加自定义域。
  2. 配置 DNS 记录（根据你的 DNS 托管方式）。
  3. 等待 DNS 生效并验证 SSL 证书。

🔧 两种 DNS 配置方式

Cloudflare Pages 提供两种方式将域名指向你的项目，请根据你的 DNS 托管位置选择。

方式一：使用 Cloudflare DNS（推荐）

  • 条件：你的域名已托管到 Cloudflare（即域名的 NS 记录指向 Cloudflare）。
  • 操作：只需在 Pages 控制台输入域名，Cloudflare 自动添加所需的 DNS 记录，无需手动操作。
  • 优点：全自动化，后续可统一管理所有 DNS 记录；享受完整的 Cloudflare 安全防护。

方式二：使用外部 DNS 提供商

  • 条件：你的域名未托管在 Cloudflare（例如使用域名注册商自带的 DNS）。

  • 操作：你需要手动在 DNS 管理后台添加一条 CNAME 记录，将你的域名指向 项目名.pages.dev。

  • 记录示例（假设你的域名是 blog.example.com）：

    记录类型 主机名 目标
    CNAME blog 项目名.pages.dev

  • 注意：如果添加的是裸域名（example.com），请参阅下方“CNAME 展平”说明。

🧩 CNAME 展平（CNAME Flattening）解释

DNS 标准规定，裸域名（也叫根域名，如 example.com）不能直接设置 CNAME 记录，因为裸域名通常需要其他记录（如 MX 邮件记录）来正常工作。

Cloudflare 通过 CNAME 展平技术解决此问题：

  • 当你为裸域名添加 CNAME 记录时，Cloudflare 的 DNS 服务器会自动将 CNAME 解析为最终的 IP 地址，并返回 A 记录响应。
  • 这意味着你的裸域名可以顺利指向 Pages 项目，而不会与 MX 等其他记录冲突。

这一过程完全自动，不需要你进行任何额外操作。

🔒 自动 SSL 证书

绑定域名后，Cloudflare Pages 会通过 Let’s Encrypt 或 Cloudflare 自家的 CA，自动为你的域名申请并部署 SSL 证书，启用 HTTPS 访问。

  • 颁发时间：通常几分钟内完成。
  • 证书类型：支持泛域名证书（如果你的域名是 *.example.com 格式）。
  • 续期：证书到期前自动续期，无需人工干预。

你可以在 Pages 项目的“自定义域”页面查看证书状态。

✅ 验证与故障排查

验证域名是否生效

  • 在 Pages 项目的“自定义域”列表中，查看域名状态是否为 “Active”（活跃）。
  • 在浏览器中访问 https://你的域名，确认能正确显示网站内容。
  • 检查浏览器地址栏小锁图标，确认 SSL 证书有效。

常见问题处理

问题现象 可能原因 解决方法
域名状态长期显示 “Pending” DNS 未正确解析或未生效 检查 DNS 记录是否正确添加，等待 5-30 分钟后再刷新
访问时显示 Cloudflare 的 404 页面 Pages 项目构建失败或未部署 检查 Pages 部署日志，确保构建命令和输出目录正确
访问时出现 400 Bad Request 使用了 HTTP 访问而端口是 HTTPS 改用 https:// 访问，或在 Cloudflare 开启“始终使用 HTTPS”
证书状态显示“错误” 证书颁发失败 检查域名是否有效、DNS 是否正确，等待一段时间后重新尝试

📚 总结

Cloudflare Pages 的域名解析功能将繁琐的 DNS 配置自动化，让你能快速将自定义域名安全地指向自己的静态网站。通过自动 SSL、CNAME 展平和全球 CDN，它保证了访问速度与安全性，是现代静态网站部署的理想选择。

如果你遇到任何具体问题，欢迎查阅 Cloudflare Pages 官方文档 或向我们寻求帮助。