GitHub搭建Hexo博客并绑定域名的完整指南

1. 前言

搭建一个属于自己的博客已经成为越来越多人的需求，而使用 Hexo 框架结合 GitHub 提供的免费托管服务，则是一个理想的选择。本文将为您详细介绍如何在 GitHub 上搭建 Hexo 博客并绑定自己的域名。

2. 环境准备

在开始之前，确保您的计算机上已经安装了以下环境：

• Node.js：Hexo 基于 Node.js，因此需要安装 Node.js。可以从 Node.js 官网 下载并安装。
• Git：用于与 GitHub 进行交互。可以从 Git 官网 下载并安装。

3. 安装 Hexo

在安装好 Node.js 和 Git 之后，您可以通过以下步骤安装 Hexo：

bash

npm install -g hexo-cli

4. 创建 Hexo 博客

在命令行中执行以下命令以创建您的 Hexo 博客：

bash

hexo init myblog

cd myblog

npm install

5. 启动 Hexo 本地服务

您可以在本地查看您的 Hexo 博客：

bash

hexo server

在浏览器中访问 http://localhost:4000，您就可以看到默认的 Hexo 博客页面。

6. 部署到 GitHub

要将您的博客部署到 GitHub，您需要进行以下操作：

6.1 创建 GitHub 仓库

1. 登录您的 GitHub 账号。
2. 点击右上角的 “+” 符号，选择 “New repository”。
3. 为您的仓库命名，例如 myblog，并确保选择 Public。
4. 点击 “Create repository”。

6.2 安装 Hexo 部署插件

在您的博客目录中，安装 Hexo 部署插件：

bash npm install hexo-deployer-git –save

6.3 配置 _config.yml

在博客根目录下找到 _config.yml 文件，添加以下内容：

yaml

deploy: type: git repo: https://github.com/USERNAME/myblog.git branch: gh-pages

注意将 USERNAME 替换为您的 GitHub 用户名。

6.4 部署博客

在命令行中执行以下命令来生成并部署博客：

bash

hexo generate

hexo deploy

如果一切正常，您的 Hexo 博客应该已经成功部署到 GitHub 上。

7. 绑定自定义域名

接下来，您可以将自定义域名绑定到您的 GitHub Pages。

7.1 在域名提供商处设置 DNS

1. 登录您的域名注册商账户。
2. 找到域名的 DNS 管理界面。
3. 添加一条 CNAME 记录：
   • 主机名：www（或其他子域名）
   • 值：USERNAME.github.io
   • TTL：默认即可

7.2 在 GitHub 仓库中配置自定义域名

1. 返回到您的 GitHub 仓库，进入 “Settings”。
2. 在 “Pages” 部分找到 “Custom domain”。
3. 输入您的域名，例如 www.yourdomain.com。
4. 点击 “Save” 按钮。

8. 验证域名绑定

等 DNS 生效后，您可以在浏览器中输入您的自定义域名以查看您的 Hexo 博客。如果一切顺利，您的博客应该可以正常访问。

9. FAQ

9.1 如何在 Hexo 中更改主题？

您可以通过访问 Hexo 主题官网 找到喜欢的主题，然后按照说明进行安装。通常只需克隆主题到 themes 文件夹，并在 _config.yml 中更改主题名称。

9.2 为什么我的博客无法显示？

如果您的博客无法显示，请检查以下几项：

• 确认 GitHub Pages 已经启用。
• 检查 DNS 记录是否已生效，可能需要等待一段时间。
• 检查 _config.yml 配置是否正确。

9.3 如何添加新文章？

您可以通过命令 hexo new "文章标题" 创建新的文章，并在 source/_posts 目录中找到新生成的 Markdown 文件进行编辑。

10. 结语

通过上述步骤，您就可以在 GitHub 上成功搭建 Hexo 博客，并绑定自定义域名。无论是分享您的技术心得，还是记录生活中的点滴，您的博客都将成为展示自己的重要平台。希望本文对您有所帮助！