GitHub Pages 域名验证最容易踩的坑：TXT 记录主机名到底怎么填？

-

最近在给 GitHub Pages 绑定自定义二级域名时，踩了一个极其常见却很少有人说透的坑。

明明已经老老实实按照 GitHub 的提示添加了 TXT 解析记录，后台却一直报错「DNS 名称不存在」或验证失败。排查后才发现，几乎所有失败都出在 DNS 面板中 主机记录 (Host / Name) 的填写方式上——不少人因为没看懂 GitHub 界面的分段设计，反而“画蛇添足”改错了。

核心结论 太长不看版

GitHub 页面上的复制框里其实已经帮你截取好了正确的相对主机名（例如 _github-pages-challenge-用户名.blog）。直接点击复制按钮原样粘贴即可，千万不要把框外面的主域名（.blogsmith.com）一起复制进去，也不要手动删掉末尾的 .blog！

1. 问题现象

当你在 GitHub（Settings → Pages → Verified domains）添加自定义二级域名（假设为 blog.blogsmith.com）时，GitHub 会给出类似下面这样的界面提示：

添加 DNS TXT 记录
在我们验证 blog.blogsmith.com 之前，您需要完成以下步骤：
1. 在 DNS 配置中为以下主机创建 TXT 记录：
_github-pages-challenge-liamchen.blog 复制 .blogsmith.com

注意看这个细节：GitHub 把 _github-pages-challenge-liamchen.blog 放在了可复制的输入框内，而把主域名 .blogsmith.com 放在了输入框外面。但很多人在去域名服务商后台填写时，却因为各种误解改错了内容。

2. 为什么会出错？（原理剖析）

主流域名服务商（阿里云、腾讯云、Cloudflare、Namecheap、GoDaddy 等）的 DNS 解析面板有一个共同规则：「主机记录」填写的是相对名称，系统会自动在末尾拼接上你的主域名（即 .blogsmith.com）。

以验证 blog.blogsmith.com 为例：
  • 你的主域名：blogsmith.com（DNS 面板会自动补全）
  • 要验证的二级域名：blog.blogsmith.com
  • GitHub 最终要查询的完整记录：_github-pages-challenge-liamchen.blog.blogsmith.com

很多同学在填写时，容易陷入以下两种“自作聪明”的误区，导致最终解析出来的域名完全不对：

避坑指南 两种最常见的错误操作
错误 1（手动把框外的主域名也复制了）：
以为框外的 .blogsmith.com 是 GitHub 漏放进框里的，于是手动全选复制了整行 _github-pages-challenge-liamchen.blog.blogsmith.com。
→ DNS 拼接后变成：_github-pages-challenge-liamchen.blog.blogsmith.com.blogsmith.com（主域名重复，报错！）
错误 2（手动删掉了末尾的 .blog）：
点击复制后，看到末尾带了个 .blog，误以为“主机记录不能带任何域名前缀”，手动删成了 _github-pages-challenge-liamchen。
→ DNS 拼接后变成：_github-pages-challenge-liamchen.blogsmith.com（缺少 .blog，变成验证主域名了！）
标准配置 正确的 DNS 解析填写对照表
验证场景 类型 主机记录 / Name（直接粘贴框内内容） 记录值 / Value
二级域名
blog.blogsmith.com 		TXT _github-pages-challenge-liamchen.blog GitHub 提供的验证字符串
主域名 (Apex)
blogsmith.com 		TXT _github-pages-challenge-liamchen GitHub 提供的验证字符串

3. 正确操作与验证步骤

  1. 在 GitHub 验证页面中，直接点击第 1 步输入框右侧的「复制」图标（不要手动框选外面的主域名）。
  2. 登录你的域名服务商后台，进入主域名（如 blogsmith.com）的 DNS 解析管理 页面，添加一条 TXT 记录。
  3. 主机记录（Host） 直接粘贴刚刚复制的内容（即 _github-pages-challenge-liamchen.blog），一字不改。
  4. 记录值（Value） 复制并粘贴 GitHub 第 2 步提供的随机验证码字符串。
  5. 保存记录，耐心等待 5～15 分钟 让全球 DNS 缓存刷新。
  6. 在本地终端运行以下命令，确认记录是否已成功对外生效：
Windows (PowerShell) DNS CHECK 
Resolve-DnsName -Name _github-pages-challenge-liamchen.blog.blogsmith.com -Type TXT
macOS / Linux (Terminal) DNS CHECK 
dig _github-pages-challenge-liamchen.blog.blogsmith.com +short TXT

只要终端里能正确返回 GitHub 给你的那串验证码，此时回到 GitHub 页面点击绿色的 「验证 (Verify)」 按钮，基本就能秒过！

4. 总结与注意事项

  • 相信 GitHub 的复制按钮：GitHub 已经贴心地把 _github-pages-challenge-用户名.子域名 和 .主域名 分开了，点复制按钮直接粘贴就是最准确的相对主机记录。
  • 耐心等待同步：不同 DNS 服务商的全球同步速度不同，如果刚添加完点验证失败，先用命令行工具测试是否已解析成功。
  • 切勿删除记录：验证通过后，请保留这条 TXT 记录不要删除。GitHub 会定期复查域名所有权，一旦删除可能导致验证状态失效，甚至引发子域名被他人抢注劫持的风险。

希望这篇小指南能帮你省下折腾 DNS 的时间！如果你在配置过程中遇到其他报错，欢迎在评论区留言交流～

评论

发表评论

此博客中的热门博文

Cloudflare Warp + Zero Trust 全平台闭环配置详细教程

-
图片
Warp + Zero Trust 全平台配置通关教程 深度闭环：安卓/iOS 一键连接，支持 MASQUE 高阶分流操作 一、 团队账户初始化 (Zero Trust 入门) 1 建立团队域 初学者强烈建议注册一个全新的 Cloudflare 账号，以便在不需要时直接注销账号，省去繁杂的清理过程。 登录 Cloudflare 官网，点击左侧菜单 Zero Trust 。 点击 开始使用 (Get Started) ，设置你的团队名称（例如 `qiangge008`）。系统会为你生成一个永久且唯一的域。 选择 Free (免费) 计划。 跳过付款 ：在添加信用卡页面，直接点击右上角的“取消并退出”，返回主页即可看到团队已成功创建。 二、 首次设备集成与向导 (关键环节) 2 注册首台设备 通过集成向导，后台会自动生成一套默认的注册规则和流量配置： 点击左侧 集成 (Integrations) -> 服务提供商 (Service providers) 。 找到 WARP ，点击 添加设备 (Add device) 。 向导式设置 ： 下载并安装 Windows 客户端，暂时不启动连接。 点击“继续”，定义 注册策略 (Enrollment policy) ：Selector 选 Emails ，Value 填入你的登录邮箱。 服务模式 ：选择“流量和 DNS (Gateway with DNS)”。 分流模式 ：默认为“排除模式 (Exclude Mode)”。 ...
阅读全文

最新版本BPB部署基础教程｜百分百成功｜利用 Cloudflare & BPB Panel ｜告别1101报错、节点泄露！

-
BPB Panel 部署教程：个人专属免费 VPN 节点 今天我将分享如何通过 Cloudflare Workers 和 Pages 搭建 BPB Panel 代理面板，帮助大家轻松搭建免费 VPN，实现永久免费节点订阅。该方案适用于 singbox-core 和 xray-core 等跨平台客户端。 背景介绍 近期 Cloudflare 官方加强了对 BPB 等项目的审查，直接使用源码或原作者提供的混淆代码容易出现 1101 错误代码。这可能是因为代码中包含敏感关键词，或者使用了与他人相同的混淆代码。 本教程将教你如何利用未混淆的源码进行自定义加密混淆，生成独一无二的代码，成功绕过 Cloudflare 的限制。我们采用了轻量级混淆方案，既能通过 Cloudflare 的安全检查，又不会触发 CPU 限制导致部署失败。 部署前的准备工作 在开始之前，你需要准备以下资源： GitHub 账号 ：用于创建代码仓库和自动执行混淆任务 Cloudflare 账号 ：用于部署混淆后的代码 域名 （可选但推荐）：Cloudflare Pages 自带域名可能访问受限 第一步：GitHub 仓库设置 首先，我们需要在 GitHub 上创建一个仓库并配置自动化工作流： 登录 GitHub，创建一个新的私有仓库 在仓库根目录创建目录 .github/workflows/ 在该目录下创建文件 Obfuscate.yml ，内容如下： 复制代码 name: Build Obfuscate BPB Panel on: push: branches: - main schedule: # 每天凌晨1点自动执行 - cron: "0 1 * * *" permissions: contents: write jobs: build: runs-on: ubuntu-latest steps: - name: Check out the code uses: actions/checkout@v4 - name: Set up Node.js ...
阅读全文

VPS + Cloudflare WARP 出站规则 解锁.google 地区限制（2026最新）

-
✅ VPS + Cloudflare WARP 出站规则 解锁 labs.google / Flow 地区限制（2026最新） 本教程适用于 VPS 上安装 WARP + 出站分流规则 的用户，完美解决 Google Labs（Flow 提示 Unsupported Country、Pomelli、Stitch 等实验工具）的地区封锁问题。 ✅ 完美分流域名列表（符合一键脚本规则） 🎯 甬哥 Sing-box-yg 脚本专属（在主菜单输入 5 -> 1 -> 1 后，直接复制下方整行粘贴）： x.ai google.com googleapis.com withgoogle.com gstatic.com googleusercontent.com labs.google.com flow.google stitch.withgoogle.com labs.google google apple.com icloud.com mzstatic.com apple-dns.net antigravity.google antigravity.googleapis.com antigravity-pa.googleapis.com cloudcode-pa.googleapis.com daily-cloudcode-pa.googleapis.com daily-cloudcode-pa.sandbox.googleapis.com sandbox.googleapis.com cloudaicompanion.googleapis.com generativelanguage.googleapis.com antigravity-unleash.goog oauth2.googleapis.com cloudresourcemanager.googleapis.com people.googleapis.com aistudio.google.com ai.google.dev gemini.google.com 💡 关键点说明： 列表特别补全了 labs.google 和 google 顶级域名后缀。因为 Google 的新版 AI 工具（如 Flow）大量采用非 .com 结尾的独...
阅读全文