You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

AWS Route 53域名指向GitHub Pages出现空白或404问题求助

问题根因&解决步骤
  • 第一步:调整GitHub Pages站点的仓库配置
    你当前使用的是组织下的普通仓库部署GitHub Pages,这类仓库的默认访问路径固定带/<repoName>/后缀,自定义根域名直接指向时,GitHub无法匹配到根路径对应的站点内容,就会出现空白页;而访问带后缀的路径时,GitHub无法通过自定义域名匹配到对应组织的仓库,就会返回404。
    要实现根域名直接访问,最简便的方案是将当前仓库重命名为<githubOrgName>.github.io,这是GitHub Pages为组织根站点预留的特殊仓库名,部署后站点默认对应根路径,无需带仓库名后缀。如果不想修改仓库名,也可以在站点的配置文件中移除路径前缀配置,同时添加重定向规则将根路径请求映射到仓库子路径,但兼容性不如修改为组织根站点仓库的方案。
  • 第二步:校验GitHub侧的自定义域名配置
    进入仓库的「Settings」→「Pages」页面:
  1. 确认Custom domain输入框填写的是你的根域名my-domain.com,保存后等待GitHub校验DNS配置,校验通过会显示绿色对勾
  2. 等待数分钟后勾选「Enforce HTTPS」选项,开启强制HTTPS访问
  3. 确认仓库根目录下自动生成了CNAME文件,文件内容仅为my-domain.com,不要包含协议、路径等额外内容
  • 第三步:修正Route 53的解析配置
    进入Route 53对应域名的托管区域,删除原有配置错误的记录,添加如下解析记录:
  1. 4条A记录,记录值分别为GitHub Pages官方IPv4地址:185.199.108.153、185.199.109.153、185.199.110.153、185.199.111.153,TTL建议设置为300
  2. 如需支持IPv6,可额外添加4条AAAA记录,记录值分别为2606:50c0:8000::153、2606:50c0:8001::153、2606:50c0:8002::153、2606:50c0:8003::153
    不要为根域名配置CNAME记录,会导致解析异常。
  • 第四步:验证生效
    配置完成后等待DNS解析生效,最长不超过24小时,本地可执行nslookup my-domain.com命令查看解析出的IP是否为上述GitHub官方地址,确认解析正确后访问根域名即可正常打开站点。

内容的提问来源于stack exchange,提问作者X0r0N

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.25 21:45:03