Hexo博客部署到GitHub Pages并绑定自定义域名教程

发表于 分类于 ， 阅读次数：

Hexo博客部署到GitHub Pages并绑定自定义域名教程

一、准备工作

  1. 安装Node.js和npm环境
  2. 安装Git
  3. 注册GitHub账号
  4. 购买并拥有一个自定义域名

二、创建GitHub仓库

  1. 登录GitHub，创建一个新的仓库
  2. 仓库名格式必须为：用户名.github.io
  3. 设置仓库为Public（公开）

三、配置Hexo项目

  1. 在Hexo项目根目录执行：

    1
    npm install hexo-deployer-git --save

  2. 编辑_config.yml文件，在deploy部分添加：

    1
    2
    3
    4
    deploy:
      type: git
      repo: https://github.com/用户名/用户名.github.io.git
      branch: main

四、部署到GitHub Pages

  1. 生成静态文件：

    1
    hexo clean && hexo generate

  2. 部署到GitHub：

    1
    hexo deploy

  3. 访问地址：https://用户名.github.io

五、绑定自定义域名

方法一：使用CNAME文件

  1. 在Hexo项目source目录下创建CNAME文件（无后缀）
  2. 文件内容写入你的域名，例如：www.example.com

方法二：通过GitHub设置

  1. 进入GitHub仓库设置页面
  2. 找到”Pages”选项卡
  3. 在”Custom domain”中输入你的域名并保存

六、DNS配置

根据你的域名提供商，添加以下DNS记录：

A记录（推荐）

1
2
3
4
5
6
记录类型：A
主机记录：@
记录值：185.199.108.153
记录值：185.199.109.153
记录值：185.199.110.153
记录值：185.199.111.153

CNAME记录（二选一）

1
2
3
记录类型：CNAME
主机记录：www
记录值：用户名.github.io

七、启用HTTPS

  1. GitHub Pages会自动为自定义域名申请SSL证书
  2. 在仓库设置的Pages选项中，勾选”Enforce HTTPS”
  3. 等待证书生效（可能需要几分钟到几小时）

八、注意事项

  1. 部署后可能需要等待几分钟才能访问
  2. 每次更新博客后需要重新部署
  3. 确保CNAME文件在每次部署时都存在
  4. DNS更改可能需要一段时间生效