上一篇
如何解除GitHub Pages自定义域名的绑定?
- 行业动态
- 2025-04-22
- 3255
要解除GitHub Pages的GitIO域名绑定,首先进入仓库的Settings页面,在Pages设置中删除自定义域名并保存,随后前往域名注册商管理后台,移除关联的CNAME或A记录解析,最后清除浏览器缓存以确保变更生效,完成操作后原域名将不再指向该页面。
在GitHub Pages项目中使用过Git.io短链域名的用户,如需解除原有绑定或迁移到新域名,需按照以下流程操作,本文基于GitHub官方文档及技术社区验证整理,内容符合技术规范及安全指引。
Git.io服务现状说明
GitHub已于2022年4月全面终止Git.io短链接服务(官方公告),现有绑定需迁移至其他服务,解除绑定涉及三个核心环节:
- GitHub仓库设置
- DNS解析配置
- 本地文件更新
分步操作指南
GitHub Pages设置更新
- 访问仓库 → Settings → Pages
- 在「Custom domain」栏点击「Remove domain」
- 点击「Save」保存变更
删除CNAME文件
git rm CNAME git commit -m "移除旧域名绑定" git push origin main
提示:若使用自动生成Pages的分支,请切换到对应分支操作
DNS记录清理
| 记录类型 | 内容 | 操作建议 |
|———-|——————–|—————–|
| CNAME | 原Git.io域名 | 删除或停用 |
| A/AAAA | GitHub服务器IP | 仅限新域名使用 |
注意:域名服务商控制台操作存在延迟,变更后建议执行dig +trace yourdomain.com
验证HTTPS证书刷新
- 解除绑定后GitHub自动撤销SSL证书
- 重新绑定新域名时会触发自动证书签发
- 证书状态可在Pages设置的「Enforce HTTPS」处查看
特殊情况处理
场景1:恢复默认github.io域名
- 完成上述步骤后,系统自动恢复
<username>.github.io
或<username>.github.io/<repo>
的访问地址 - 若出现404错误,检查仓库是否开启GitHub Pages服务
场景2:迁移至新自定义域名
- 在新域名控制台添加CNAME记录指向
<username>.github.io
- 在Pages设置中填写新域名并保存
- 等待DNS生效(通常10-120分钟)
操作后验证
本地缓存清理
curl -I http://yourdomain.com # 检查返回头信息 chrome://net-internals/#dns # Chrome清除DNS缓存
生效时间监控
- GitHub服务器更新:即时生效
- DNS全球传播:最长48小时
- 可通过全球DNS检查工具(如dnschecker.org)确认传播进度
技术建议
若原Git.io域名仍需使用,建议:
- 向GitHub支持团队提交解除锁定请求
- 使用301重定向到新域名(需服务器支持)
推荐替代方案:
- Cloudflare Pages(自带短链功能)
- Vercel/VPS自建短链服务
- GitHub原生
github.io
域名
引用声明
本文操作指引参考:
- GitHub官方文档
- ICANN域名解析标准
- Mozilla SSL配置指南
数据更新至2025年10月,请以各平台最新文档为准。