如何设置Github Pages将DNS请求从子域(例如www)重定向到顶级域(TLD,Apex记录)？

Question

如何以这样的方式配置DNS服务提供商,以便向两者请求www.example.com并example.com显示在GitHub Pages服务器上托管的网站？我的浏览器地址栏应包含example.com网站打开时的内容.

我的DNS服务提供商是gandi.net.它不支持ALIASDNS记录类型.

Answer 1

简短的回答

步骤1:将新文件添加CNAME到仅包含一行的GitHub页面存储库:您的顶级域名.

例如:

example.com

第2步:[可选]但强烈推荐

2.1:A从DNS配置中删除所有其他类型的顶级记录(带有@前缀).

2.2:删除CNAME第二级域的记录(www如果存在).

第3步:将这3个条目添加到DNS配置的最顶层:

@        A        192.30.252.153
@        A        192.30.252.154
www      CNAME    your_github_username.github.io.

替换your_github_username为您的实际GitHub用户名.

第4步:等待DNS更改传播.

DNS更改无法立即生效.它们可能需要一整天才能传播.

答案很长

这个问题有两个方面.一个是DNS配置本身.另一个是GitHub Pages转发HTTP请求的方式.

我们需要了解一些事情,以了解GitHub在他们的文档中试图说些什么.

DNS条目类型

我们感兴趣的有两种类型的DNS记录:CNAME和A.

A也被称为Apex或有时被称为root entry.它将请求转发到指定的固定 IP地址.CNAME条目将请求转发到指定的URL(实际有效的纯文本URL,而不是IP地址).

DNS负载平衡

GitHub有一个中心URL地址,它接受GitHub页面的所有DNS请求:http://username.github.io.该URL根据您的地理位置解析为不同的IP地址.托管在GitHub上的页面的网站是一个简单的集合HTML,CSS和JS文件.GitHub将这些文件分发到全球的不同服务器.因此,当您的浏览器从欧洲发送请求时,它会从欧洲的服务器接收数据.这同样适用于亚洲和美国的要求.

GitHub想说的是什么

由于ADNS中的记录必须包含IP地址,并且它们必须是192.30.252.153或者192.30.252.154,因此无法将请求转发到位于欧洲或亚洲某个地方的服务器.您在GitHub Pages上托管的网站将从中央GitHub Pages服务器下载.如果由于某种原因两个GitHub页面DNS服务器(x.x.x.153和x.x.x.154)都将关闭,则存在一个小风险,所有使用固定GitHub页面IP地址的自定义域将无法访问(其DNS请求将无法解析).

这就是为什么GitHub强烈建议为您的GitHub页面使用二级域名(例如blog.example.com)或使用支持记录类型ALIAS作为A记录的DNS服务提供商,但转发请求到URL地址(例如username.github.io)而不是固定IP地址.

GitHub页面如何处理HTTP请求

在将DNS请求your_github_username.github.io.解析为IP地址后,例如,192.30.252.153您的浏览器使用HTTP标头向该服务器发送HTTP请求Host.下面是curl加载同一网站的示例(如果您在代理服务器后面,这些示例可能不起作用):

$> curl --header "Host: your_github_username.github.io" http://192.30.252.153/
$> curl --header "Host: www.example.com" http://192.30.252.153/
$> curl --header "Host: example.com" http://192.30.252.153/

通过这种方式,GitHub Pages服务器可以知道要服务的用户网站.

如果您的CNAME文件包含example.com但是www.example.com被请求,GitHub Pages服务器将自动将HTTP请求重定向到顶级域.

如果您的CNAME文件包含www.example.com但HostHTTP请求中的标头包含,则同样有效example.com.

为什么我不能在我的DNS配置中添加CNAME接受顶级请求(@)的记录条目？

引自GitHub Pages文档:

警告:不要为自定义顶点域创建CNAME记录!这样做可能会导致该域上的其他服务(例如电子邮件)出现问题.

参考文献:

使用GitHub页面设置自定义域

我的自定义域无效

无法通过IP地址访问我的GitHub Pages网站