请求协助排查GCP Cloud DNS记录无法解析至GitHub Pages的问题
GCP Cloud DNS 配置 GitHub Pages 域名失效排查方案
1. 确认域名权威DNS服务器指向GCP Cloud DNS
执行dig NS 你的域名,检查返回的NS记录是否为GCP提供的服务器(格式如ns-cloud-xx.googledomains.com)。若不是,需在GCP域名注册控制台更新DNS服务器地址为Cloud DNS的NS值。
2. 修正DNS记录配置
CNAME记录注意事项
- 根域名(如
xxx.com)禁止使用CNAME,必须配置A/AAAA记录指向GitHub官方IP:- A记录:
185.199.108.153、185.199.109.153、185.199.110.153、185.199.111.153 - AAAA记录:
2606:50c0:8000::153、2606:50c0:8001::153、2606:50c0:8002::153、2606:50c0:8003::153
- A记录:
- 子域名(如
www.xxx.com)的CNAME值必须写buahaha.github.io.(末尾的点不能省略,确保是绝对域名)。
TXT记录验证
用于GitHub验证的TXT记录,主机名填@(根域名),值必须完全匹配GitHub提供的验证字符串(格式如github-pages-verification=xxxxxxx),不能有多余空格或符号。
3. 绕过本地DNS缓存验证
用公共DNS直接查询,确认记录是否已传播:
- Google DNS:
dig @8.8.8.8 你的域名 CNAME/dig @8.8.8.8 你的域名 TXT - Cloudflare DNS:
dig @1.1.1.1 你的域名 CNAME/dig @1.1.1.1 你的域名 TXT
若公共DNS能查到正确记录,本地执行缓存刷新: - Windows:
ipconfig /flushdns - macOS:
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
4. 同步GitHub Pages域名设置
进入GitHub仓库的「Settings → Pages」,删除当前自定义域名后重新输入并保存,触发GitHub的DNS验证流程。同时确认Pages服务已启用,源分支设置正确。
5. 调整Cloud DNS记录TTL
若TTL设置过大(如86400秒),会延长传播时间。临时将TTL改为300秒(5分钟),待记录生效后再改回正常值。
内容的提问来源于stack exchange,提问作者blacha
相关产品推荐
相关产品推荐

