当前位置:首页 > 行业动态 > 正文

如何解除GitHub Pages自定义域名的绑定?

要解除GitHub Pages的GitIO域名绑定,首先进入仓库的Settings页面,在Pages设置中删除自定义域名并保存,随后前往域名注册商管理后台,移除关联的CNAME或A记录解析,最后清除浏览器缓存以确保变更生效,完成操作后原域名将不再指向该页面。

在GitHub Pages项目中使用过Git.io短链域名的用户,如需解除原有绑定或迁移到新域名,需按照以下流程操作,本文基于GitHub官方文档及技术社区验证整理,内容符合技术规范及安全指引。

Git.io服务现状说明

GitHub已于2022年4月全面终止Git.io短链接服务(官方公告),现有绑定需迁移至其他服务,解除绑定涉及三个核心环节:

  1. GitHub仓库设置
  2. DNS解析配置
  3. 本地文件更新

分步操作指南

  1. GitHub Pages设置更新

    • 访问仓库 → Settings → Pages
    • 在「Custom domain」栏点击「Remove domain」
    • 点击「Save」保存变更
  2. 删除CNAME文件

    git rm CNAME
    git commit -m "移除旧域名绑定"
    git push origin main

    提示:若使用自动生成Pages的分支,请切换到对应分支操作

    如何解除GitHub Pages自定义域名的绑定?  第1张

  3. DNS记录清理
    | 记录类型 | 内容 | 操作建议 |
    |———-|——————–|—————–|
    | CNAME | 原Git.io域名 | 删除或停用 |
    | A/AAAA | GitHub服务器IP | 仅限新域名使用 |
    注意:域名服务商控制台操作存在延迟,变更后建议执行dig +trace yourdomain.com验证

  4. HTTPS证书刷新

    • 解除绑定后GitHub自动撤销SSL证书
    • 重新绑定新域名时会触发自动证书签发
    • 证书状态可在Pages设置的「Enforce HTTPS」处查看

特殊情况处理

场景1:恢复默认github.io域名

  • 完成上述步骤后,系统自动恢复<username>.github.io<username>.github.io/<repo>的访问地址
  • 若出现404错误,检查仓库是否开启GitHub Pages服务

场景2:迁移至新自定义域名

  1. 在新域名控制台添加CNAME记录指向<username>.github.io
  2. 在Pages设置中填写新域名并保存
  3. 等待DNS生效(通常10-120分钟)

操作后验证

  1. 本地缓存清理

    curl -I http://yourdomain.com  # 检查返回头信息
    chrome://net-internals/#dns  # Chrome清除DNS缓存
  2. 生效时间监控

    • GitHub服务器更新:即时生效
    • DNS全球传播:最长48小时
    • 可通过全球DNS检查工具(如dnschecker.org)确认传播进度

技术建议

  1. 若原Git.io域名仍需使用,建议:

    • 向GitHub支持团队提交解除锁定请求
    • 使用301重定向到新域名(需服务器支持)
  2. 推荐替代方案:

    • Cloudflare Pages(自带短链功能)
    • Vercel/VPS自建短链服务
    • GitHub原生github.io域名

引用声明
本文操作指引参考:

  • GitHub官方文档
  • ICANN域名解析标准
  • Mozilla SSL配置指南
    数据更新至2025年10月,请以各平台最新文档为准。
0