一句话总结:GitHub Pages 的 .com 域名无法 ICP 备案,导致 sitemap 提交和站长统计不可用。但通过文件验证 + API 提交的组合方式,仍然可以完成收录。核心是选对验证方式和提交途径。


目录

  1. GitHub Pages 的备案困境
  2. 站长平台的三步接入流程
  3. 验证方式选择:文件验证 vs HTML 标签
  4. Hexo 的 skip_render 配置
  5. 三种提交途径对比
  6. 配额限制说明
  7. 维护流程
  8. 总结

GitHub Pages 的备案困境

GitHub Pages 分配的域名是 xxx.github.io,如果绑定自己的 .com 域名(如 example.com),则会遇到以下问题:

功能 需要 ICP 备案? GitHub Pages 兼容?
域名绑定 ✅ 需要 ❌ .com 域名无法备案
sitemap 提交 ✅ 需要 ❌ 不可用
搜索统计 ✅ 需要 ❌ 不可用
API 提交 ❌ 不需要 ✅ 可用
手动提交 ❌ 不需要 ✅ 可用
文件验证 ❌ 不需要 ✅ 可用

核心矛盾:GitHub Pages 是国外服务,无法通过中国工信部的 ICP 备案。而某些搜索平台的部分高级功能(sitemap 提交、搜索统计)要求已备案的域名。

但好消息是——基础收录功能(API 提交 + 手动提交)不要求备案

站长平台的三步接入流程

第一步:添加网站

在站长平台选择”添加网站”,输入你的域名(如 https://cdp.autify.cc)。

第二步:验证网站所有权

三种验证方式:

  1. 文件验证(推荐)→ 下载验证文件 → 放到网站根目录
  2. HTML 标签验证 → 在首页 <head> 中加入 meta 标签
  3. CNAME 验证 → 在 DNS 解析中添加 TXT 记录

对于 GitHub Pages,建议用文件验证

第三步:提交收录

验证通过后,就可以提交 URL 了(详见下文)。

验证方式选择:文件验证 vs HTML 标签

文件验证(推荐)

站长平台会生成一个验证文件,如 baidu_verify_codeva-xxx.html

操作步骤

  1. 下载验证文件
  2. 放入 Hexo 的 source/ 目录
  3. 配置 skip_render(关键!)
  4. 执行 hexo g -d 部署
1
2
3
4
5
# 目录结构
source/
├── _posts/
├── baidu_verify_codeva-s9dmzkq3Dq.html # 验证文件放这里
└── ...

HTML 标签验证

虽然也可以用,但对于 Hexo 来说比较麻烦——需要修改主题模板,且更新主题时会被覆盖。

文件验证的优势

对比项 文件验证 HTML 标签验证
操作复杂度 简单(放文件即可) 需修改模板文件
持久性 持久(文件不清除就一直有效) 主题更新可能丢失
影响范围 单文件 修改全站模板
被 Hexo 误处理 ⚠️ 需要 skip_render 无影响

Hexo 的 skip_render 配置

这是最容易被忽略的一步。

如果不配置 skip_render,Hexo 的渲染引擎会把验证文件当作普通网页处理——加上 Layout、头尾 HTML 结构。但搜索引擎期望的验证文件是纯文本/原始 HTML,Hexo 渲染后的版本会导致验证失败。

验证文件原始内容(约 32 字节):

1
<meta name="baidu_verify" content="codeva-xxx">

Hexo 渲染后(约 26KB):

1
2
3
4
5
6
7
8
9
10
<html>
<head>...</head>
<body>
<nav>...</nav>
<div id="main">
<meta name="baidu_verify" content="codeva-xxx"> <!-- 被包在页面结构中 -->
</div>
<footer>...</footer>
</body>
</html>

搜索引擎只认第一种。

配置方法

_config.yml 中:

1
2
skip_render:
- 'baidu_verify_*.html' # 匹配所有百度验证文件

使用通配符 * 的好处是——以后换验证文件也不用改配置。

1
2
3
4
# _config.yml 完整示例
skip_render:
- 'baidu_verify_*.html'
- 'google*.html' # Google Search Console 同理

三种提交途径对比

方式 需要备案? 自动化程度 配额 推荐度
sitemap 提交 ✅ 是 全自动 ⭐ 无限制 ❌ 不可用
API 提交 ❌ 否 脚本自动 约 10 条/天 ⭐⭐⭐ 首选
手动提交 ❌ 否 手动粘贴 不明确 ⭐⭐ 备用

API 提交(推荐)

从本地向站长平台的 API 接口发送 POST 请求,无需服务器端支持。

1
2
# 从本地运行脚本提交 URL
python baidu_submit.py

工作原理:

1
2
从 sitemap.xml 提取所有 URL → 对比已提交记录 → 
挑出未提交的 → 每 5 条一批 POST → 更新记录

详见专题文章《收录 API 提交脚本开发实战》。

手动提交(备用)

当 API 配额用完时,在站长平台的”手动提交”页面粘贴 URL。

配额限制说明

无备案的 GitHub Pages 站点在 API 提交时遇到的限制:

限制 说明
每日配额约 10 条 API 提交每日约 10 条额度
单次提交 ≤ 剩余配额 剩余 7 条时提交 10 条会被整批拒绝
配额可能是一次性的 GitHub Pages 无备案站点可能只有一次性总配额
无 sitemap 提交 因备案原因不可用

建议:配额用完后改用手动提交作为补充。

维护流程

每次发布新文章后

1
2
3
4
5
6
# 1. 生成并部署
hexo clean
hexo g -d

# 2. 提交新 URL
python baidu_submit.py

检查收录状态

1
2
3
在搜索框输入:site:你的域名
有结果 = 已收录
无结果 = 还在等待抓取

加快收录的技巧

  1. 持续产出:文章越多、更新越频繁,搜索引擎给的权重越高
  2. 外链引流:在知乎/掘金/CSDN 等平台发文章带上站点链接
  3. 手动补充提交:API 配额用完后,手动提交补充
  4. 耐心等待:新站收录需要 1~4 周

总结

环节 要点
验证方式 文件验证,放到 source/ 目录
关键配置 skip_render 必须配置,否则验证文件被 Hexo 渲染
提交途径 API 提交为主,手动提交为辅
预期管理 新站收录需要 1~4 周,无备案站点限制较多

总结:GitHub Pages 无备案站点虽然无法使用 sitemap 提交和搜索统计,但通过”文件验证 + API 提交”的组合,完全可以完成基础收录。关键是配置好 skip_render,选择合适的提交途径,并对收录时间有合理预期。