hexo绑定域名

发表于 分类于

本文面向使用 Hexo + GitHub Pages 搭建静态博客的开发者，完整梳理自定义域名绑定的分步操作，彻底解决每次部署后仓库域名配置被重置的麻烦。

步骤1：购置域名

可选择国内正规域名服务商（阿里云/腾讯云/华为云）购买心仪域名，新手优先推荐 .com/.cn 后缀，辨识度高、兼容性好。

补充说明：若仅用于 GitHub Pages 境外托管，域名无需备案即可完成解析与访问；若后续切换至国内服务器，需先完成域名 ICP 备案。

步骤2：域名解析配置

这一步的核心是将你的自定义域名指向 GitHub Pages 仓库地址，操作路径为：域名服务商控制台 → 域名管理 → 解析设置，新增解析记录，核心配置如下：

记录类型 主机记录 记录值 TTL 配置说明
CNAME @ 你的GitHub Pages仓库地址（如 jinyang0418.github.io.） 10分钟（默认） 根域名解析（例：xxx.com）
CNAME www 你的GitHub Pages仓库地址（如 jinyang0418.github.io.） 10分钟（默认） www二级域名解析（例：www.xxx.com）

关键避坑提醒：

  1. 记录值末尾必须加英文句号.，否则会导致解析失败；
  2. 记录值仅填写仓库域名，不可加 http/https 前缀；
  3. 主机记录 @ 对应根域名，www 对应带www的二级域名，可按需选择，建议两条都配置保证访问兼容性。

步骤3：配置域名持久化（解决部署后重置问题）

这是绑定域名的核心步骤，若跳过此操作，每次执行 hexo deploy 部署后，GitHub 仓库的自定义域名配置会被自动重置，需要反复手动修改。

完整操作方法：

  1. 打开本地 Hexo 博客的根目录，进入 source 文件夹；
  2. 在 source 文件夹内新建名为 CNAME 的文件（必须全大写，无任何后缀名，不可保存为 CNAME.txt 等格式）；
  3. 打开 CNAME 文件，仅填写你的自定义域名（例：xxx.com），无需加 http/https 前缀、无需加末尾斜杠，保存文件即可。

原理解释：Hexo 执行构建部署时，会将 source 文件夹内的所有文件原样复制到生成的 public 静态目录中，同步推送到 GitHub 仓库，从而永久保留自定义域名配置，不会被部署操作覆盖。

步骤4：本地构建与部署更新

完成上述配置后，在本地博客根目录打开 Git Bash / 终端，依次执行以下命令，将配置更新推送到 GitHub 仓库：

1
2
3
4
5
6
7
8
# 1. 清理本地缓存与旧的静态文件
hexo clean

# 2. 生成最新的静态网站文件（可简写为 hexo g）
hexo generate

# 3. 部署推送到 GitHub 仓库（可简写为 hexo d）
hexo deploy

步骤五：生效验证

  1. 解析生效验证：本地终端执行 ping 你的域名，若返回的 IP 地址指向 GitHub Pages 服务器，说明解析已生效（解析生效通常需要 1-10 分钟，最长不超过 24 小时）；
  2. 访问验证：浏览器输入你的自定义域名，若能正常打开 Hexo 博客，说明绑定成功；
  3. 仓库配置验证：打开 GitHub 博客仓库 → Settings → Pages，可见 Custom domain 栏已自动填充你的自定义域名，无需手动修改。