GitHub Pages两级子域名配置:可行性、所需DNS记录及www子域名添加方法
可行性结论
你想要配置的形如www.example.example.com的两级子域名GitHub Pages站点完全可行,不存在平台侧的功能限制,配置逻辑和你已经完成的单级子域名配置没有本质区别。
具体配置方案
DNS侧配置(在你域名托管的DNS服务商后台操作)
因为你已经完成了单级子域名example.example.com的配置,这次添加www两级子域名只需要在现有解析规则下新增对应记录即可:
- 方案1(固定IP解析,兼容性最好):新增4条A记录
- 主机记录栏填写
www(系统会自动拼接现有域名后缀example.example.com,生成完整解析域www.example.example.com) - 4条记录的对应值分别填写GitHub Pages公开的固定IPv4接入地址:
185.199.108.153、185.199.109.153、185.199.110.153、185.199.111.153
- 主机记录栏填写
- 方案2(CNAME解析,免维护IP):新增1条CNAME记录
- 主机记录栏同样填写
www - 记录值填写你个人GitHub Pages的默认访问地址(格式为
<你的GitHub用户名>.github.io)
- 主机记录栏同样填写
- 可选:如果需要支持IPv6访问,再对应新增AAAA记录,主机记录填
www,记录值填写GitHub Pages公开的IPv6接入地址即可
注意:不要在主机记录栏填写完整的
www.example.example.com全路径,大部分DNS服务商的主机记录是相对路径形式,填全路径会生成www.example.example.com.example.example.com这类错误的解析层级,导致访问失效。
GitHub仓库侧配置
- 打开你存放站点内容的GitHub仓库,进入「Settings」-「Pages」设置页
- 在「Custom domain」输入框中,填入完整的两级域名
www.example.example.com,点击保存等待验证 - 系统验证通过后,勾选「Enforce HTTPS」选项,确保站点支持加密访问
- 注意:验证通过后仓库根目录会自动生成一个内容为
www.example.example.com的CNAME文件,不要手动删除该文件,否则自定义域名绑定会自动失效
已有单级子域名的兼容调整
如果你之前已经将单级子域名example.example.com绑定到了这个站点,现在加完www两级域名后,可以按需求选择访问规则:
- 保留双域名访问:只需要在Custom domain栏把两个域名都填上,GitHub会自动让两个域名都能正常访问站点
- 单域名跳转:留你想要作为主访问地址的域名(比如
www.example.example.com)在Custom domain栏,另一个单级域名会被GitHub自动配置成301永久跳转,不会分散SEO权重
配置验证小提示
DNS记录修改后需要10-30分钟的全网缓存生效时间,等待期间如果GitHub侧的域名验证不通过,可以本地执行nslookup www.example.example.com命令,检查解析返回的IP是不是和你配置的GitHub接入地址一致,确认DNS生效后验证会自动完成。
内容的提问来源于stack exchange,提问作者Cora Lewis
相关产品推荐
相关产品推荐

