解决 Hexo 部署到 GitHub Pages 自定义域名失效问题

在使用 Hexo 部署博客到 GitHub Pages 时，可能会遇到每次运行 hexo d 后自定义域名失效的问题。以下是两种解决方法，帮助你实现自定义域名的永久配置。

方法一就够用了

方法一：手动添加 CNAME 文件

  1. 找到 source 文件夹
    在 Hexo 博客的根目录下，找到名为 source 的文件夹（注意不是主题的 source 文件夹）。

  2. 创建 CNAME 文件
    在 source 文件夹中新建一个文件，命名为 CNAME（全部大写，无后缀，不是CNAME.yml）。

  3. 写入自定义域名
    在 CNAME 文件中写入你的自定义域名（不包含 http:// 或 www. 等），例如：

    1
    bilicili.com

  4. 保存并部署
    保存文件后，运行以下命令进行部署：

1
hexo clean && hexo generate && hexo deploy

每次部署时，CNAME 文件都会被同步到 GitHub Pages，从而避免域名失效。

方法二：使用 hexo-generator-cname 插件

  1. 安装插件
    在 Hexo 博客的根目录下运行以下命令安装插件：

    1
    npm install hexo-generator-cname --save

  2. 配置插件
    在 _config.yml 文件中添加以下内容：

    1
    2
    plugins:
      - hexo-generator-cname

  3. 部署博客
    保存配置文件后，运行以下命令进行部署：

    1
    hexo clean && hexo generate && hexo deploy

    插件会自动生成 CNAME 文件并部署到 GitHub Pages。

注意事项

  • 如果你之前已经安装了 hexo-generator-cname 插件，但仍然遇到问题，可以尝试卸载插件，然后按照方法一手动添加 CNAME 文件。
  • 确保在 GitHub Pages 的设置中正确配置了自定义域名，并且域名解析设置正确。
  • 如果你使用的是 HTTPS，还需要在 GitHub Pages 设置中开启强制 HTTPS 功能。