跳转至

🐞 常见错误

本页讨论配置EdgeHit-CDN时的常见错误

⚠️ 不完整的记录链

在配置CDN域名时,会生成CNAME记录(站点地图),该记录映射到分配给CDN域名的流量策略。

生成的DNS记录如下:

<User Domain>.<Domain Prefix>.<System DNS Domain> IN   CNAME <Traffic Policy>
<Traffic Policy>                                  IN   A     <IP Address of CDN Edge Node>

举个例子

testing.game23.top.EdgeHit DNS-ops.top.      IN   CNAME default.traffic-polcy.EdgeHit DNS4-ops.top.
default.traffic-polcy.EdgeHit DNS4-ops.top.  IN   A     102.140.93.43

根据上述示例,为了完成CDN域名testing.game23.top.的DNS查询链,需要添加以下CNAME记录。

testing.game23.top.      IN   CNAME testing.game23.top.EdgeHit DNS-ops.top.


请注意,如果为CDN域名配置了站点前缀如 .my ,站点地图值将相应变更。

testing.game23.top.my.EdgeHit DNS-ops.top.      IN   CNAME default.traffic-polcy.EdgeHit DNS4-ops.top.
因此DNS管理员需要配置CNAME记录的以匹配站点地图记录的名称

Info

CDN域名的DNS区域可以由任何托管服务商提供,不一定非要由EdgeHit DNS服务器托管。

Warning

根据RFC 1034规定,CNAME记录不能与其他具有相同名称值的记录共存,所有DNS托管服务商都会强制执行此规则。



⚠️ 缓存清除/预取URL缺少HTTP(s)协议头

执行缓存清除预取操作时,URL必须包含完整协议头(http://https://)。遗漏协议头可能导致:

  • 缓存操作失败
  • 请求被忽略
  • URL格式错误

❌ 错误示例 : example.com

✅ 正确示例 : https://example.com



⚠️ 地理定位资源的常见误解

查阅文档时您会注意到,在DNS和CDN服务器的"服务器详情"高级选项字段中,存在地理区域设置项。 图示

这些设置位于:

  • 首页 > CDN > 服务器 > 详情
  • 首页 > DNS > 服务器 > 详情

但需注意,这些设置仅用于日志记录和管理目的的资源标记,不会影响实际服务和请求流向。

真正启用地理定位内容的功能配置位于: DNS记录的地理定位流量策略的地理定位 ,相关说明详见配置指南文档。



⚠️ 未定义源站服务器Host头值

默认情况下,EdgeHit节点向源站发送请求时会将 Host 头设为null

这在以下环境中可能引发问题:

  • 共享主机环境,源站依赖 Host 头确定服务的虚拟主机
  • 严格安全配置环境,源站使用 Host 头进行访问控制或路由逻辑

建议将 Host 头设置为CDN域名(或源站预期域名)以确保正确路由和兼容性。仅当确认源站不依赖该头值时方可省略或覆盖。