CNAME設定
CNAME 配置
CNAME（规范名称）记录用于将您的域名指向 Yewsafe 的 CDN 网络。本指南将说明如何配置 CNAME 记录以实现最佳性能和安全性。
理解 CNAME 记录
CNAME 记录会为您的域名创建一个指向 Yewsafe 边缘服务器的别名。当用户访问您的网站时，DNS 解析会将其引导至最近的 Yewsafe 接入点。
用户请求 → DNS 查询 → CNAME 解析 → Yewsafe 边缘节点 → 源服务器
获取您的 CNAME 目标
在 Yewsafe 中添加域名后，您将获得一个唯一的 CNAME 目标：
进入控制面板中的 域名 页面
选择您的域名
导航至 DNS 设置
复制您的 CNAME 目标（格式：example-com.yewsafe.net）
配置 CNAME 记录
对于子域名（www、api、cdn 等）
在您的 DNS 提供商处添加一条 CNAME 记录：
字段 值
类型 CNAME
名称/主机 www（或您的子域名）
目标/指向 your-domain.yewsafe.net
TTL 300（或自动）
DNS 配置示例：
www.example.com. 300 IN CNAME example-com.yewsafe.net.
api.example.com. 300 IN CNAME example-com.yewsafe.net.
cdn.example.com. 300 IN CNAME example-com.yewsafe.net.
对于根域名/顶点域名
根域名（不带 www 的 example.com）由于 DNS RFC 限制，无法使用标准的 CNAME 记录。请使用以下替代方案之一：
方案 1：CNAME 扁平化（推荐）
部分 DNS 提供商支持在顶点域名处使用类似 CNAME 的功能：
提供商 功能名称
Cloudflare CNAME 扁平化
AWS Route 53 别名记录
DNSimple ALIAS 记录
NS1 链接记录
方案 2：使用 Yewsafe DNS
将您的 DNS 迁移至 Yewsafe 以获得完整的顶点域名支持：
进入控制面板中的 DNS 管理
点击 启用 Yewsafe DNS
将您域名的名称服务器更新为：
- ns1.yewsafe.com
- ns2.yewsafe.com
方案 3：使用任播 IP 的 A 记录
使用 Yewsafe 的任播 IP 地址（仅限企业版）：
example.com. 300 IN A 198.51.100.1
example.com. 300 IN A 198.51.100.2
注意：请联系支持人员以获取您账户的任播 IP。
验证 CNAME 配置
使用命令行
# 检查 CNAME 记录
dig www.example.com CNAME
# 预期输出
;; ANSWER SECTION:
www.example.com. 300 IN CNAME example-com.yewsafe.net.
# 验证解析
dig www.example.com A
# 应解析为 Yewsafe 边缘节点 IP
使用在线工具
DNS Checker - 检查全球传播情况
MXToolbox - DNS 查询和诊断
从 Yewsafe 控制面板
进入 域名 → 选择您的域名
点击 验证 DNS
系统将检查您的 CNAME 配置
DNS 传播
DNS 更改可能需要时间才能在全球范围内传播：
TTL 设置 典型传播时间
300（5 分钟） 5-30 分钟
3600（1 小时） 1-4 小时
86400（24 小时） 最长 48 小时
加速传播的技巧：
在进行更改前，将 TTL 降低至 300
等待旧的 TTL 过期
进行 CNAME 更改
验证在多个区域的传播情况
多个 CNAME 目标
对于高级配置，您可能需要不同的 CNAME 目标：
使用场景 CNAME 目标格式
标准 CDN domain.yewsafe.net
中国加速 domain.yewsafe.cn
视频流 domain-media.yewsafe.net
API 网关 domain-api.yewsafe.net
常见问题
CNAME 与 MX 记录冲突
如果您在同一子域名上配置了邮件服务：
# 这将无法工作 - CNAME 与 MX 冲突
mail.example.com CNAME example-com.yewsafe.net
mail.example.com MX mailserver.example.com
# 解决方案：为 CDN 使用不同的子域名
cdn.example.com CNAME example-com.yewsafe.net
CNAME 链过长
避免创建 CNAME 链：
# 错误示例 - 形成链式结构
www.example.com → alias.example.com → example-com.yewsafe.net
# 正确示例 - 直接 CNAME 指向
www.example.com → example-com.yewsafe.net
配置 CNAME 后出现 SSL 证书错误
若遇到证书错误：
确保已在 Yewsafe 中配置 HTTPS 证书
等待证书签发（最长可能需要 15 分钟）
确认证书已覆盖您的域名
最佳实践
初始使用低 TTL 值：首次配置时建议将 TTL 设为 300 秒
上线前充分测试：可先使用测试子域名进行验证
变更后持续监控：通过控制面板观察流量变化
完善 DNS 记录文档：保持所有 DNS 配置的完整记录
启用 DNSSEC：若平台支持，建议开启 DNSSEC 增强安全性
API 参考
通过 API 配置 CNAME 设置：
# 获取域名的 CNAME 目标地址
curl -X GET https://api.yewsafe.com/v1/domains/example.com/dns \
-H "Authorization: Bearer YOUR_API_KEY"
# 响应示例
{
"cname_target": "example-com.yewsafe.net",
"status": "active",
"verification": "verified"
}
需要 DNS 配置帮助？请联系 support@yewsafe.com