You need to enable JavaScript to run this app. GitHub Pages两级子域名配置:可行性、所需DNS记录及www子域名添加方法
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 15:36:03