搭建自己的Hexo博客


1 Hexo简介

Hexo基于Node.js的博客部署框架,Hexo能使用Markdown或者其他渲染格式解析文章,安装Hexo只需几分钟时间。
Hexo博客部署框架有如下特点:

  • 快速性
  • 简洁性
  • 高效性

2 环境准备

2.1 安装Node.js

首先访问Node.js的官网获取最新LTS安装包:Node.js官网

下载Node.js

然后打开下载的Node.js安装包点击安装(安装时全程Default即可)

Win+R打开“运行”并输入cmd打开命令窗口,输入如下代码验证安装完整性

1
2
node -v
npm -v
Node.js版本

2.2 安装Git

首先访问Git的官网获取最新的Git安装包:Git官网

获取Git安装包

然后打开下载的Git安装包点击安装(安装时全程Default即可)

安装Git

Win+R打开“运行”并输入cmd打开命令窗口,输入如下代码验证安装完整性

1
git --version
Git版本

3 Hexo部署

3.1 安装Hexo框架

通过npm install -g hexo-cli命令部署hexo框架

1
npm install -g hexo-cli
安装Hexo框架

3.2 Hexo初始化

通过hexo init命令初始化博客

1
hexo init
Init

3.3 Hexo生成

通过hexo generate命令生成博客

1
hexo generate
Generate

3.4 Hexo启动

通过hexo server命令

1
hexo server
Server

再通过 http://localhost:4000/ 即可本地访问博客主页

本地访问

3.5 Hexo部署

通过hexo deploy命令

1
hexo deploy
Deploy

3.6 Hexo清除

1
hexo clean
Clean

3.7 添加文章

在博客文件夹下的 /source/_post 文件夹下面创建需更新的博客,完成后便可将其部署到GitHub服务器上

1
hexo new post <新建的Markdown文件名>

4 将Hexo博客部署到GitHub上托管

4.1 新建GitHub仓库

第一步:在GitHub本人主页上点击加号(+)选择new repository创建新仓库

新建仓库

第二步:在新建仓库的页面键入本人的Repository name(注意一定要以.github.io结尾)

输入仓库名称

第三步:生成以后的仓库中红框部分是后面将Hexo博客部署到GitHub上所需的链接

仓库链接

4.2 将Hexo博客部署到GitHub服务器上

将博客根目录下的_config.yml配置文件进行如下更改:

部署博客到Git上

完成操作之后重新部署生效到GitHub上


5 更改Hexo博客主题

5.1 获取主题

使用如下命令克隆GitHub仓库中的主题到本地

1
git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia
获取主题

5.2 更改配置文件

将本地博客所下载的主题根目录的_config.yml文件进行如下更改:

修改主题的Config配置文件

5.3 重新部署到服务器

后续执行以下操作部署到GitHub上即可完成主题更换操作

1
2
3
hexo clean
hexo generate
hexo deploy

5.4 绑定个人域名

绑定个人域名参照: Github个人博客:绑定域名


6 Hexo博客搭建常见问题

6.1 无法远程访问GitHub仓库

第一次部署时候可能出现无法无法访问GitHub仓库的情况,考虑可能是SSH配置错误,只需正确配置SSH key即可,详细可参见如下链接的解决方法:正确配置SSH key并远程访问GitHub

6.2 DNS域名解析异常

在部署过程中可能遇到无法将博客部署到GitHub上的情况,通过Windows控制的ping命令无法ping通GitHub官网网址,则是出现了DNS域名解析异常。
解决方法一

  1. 在Windows系统中,访问 C:\Windows\System32\drivers\etc\hosts 文件并在末尾添加如下命令
  2. 在Linux系统中,访问 /etc/hosts 文件并在末尾添加如下命令
1
2
#前者为GitHub的网址IP,后者为GitHub网址的域名
140.82.112.4 github.com

解决方法二:更改为国内的Gitee码云,部署方法与GitHub类似

6.3 部署失败

  1. 在执行hexo deploy命令时出现 ERROR Deployer not found: git 的错误
    解决方法是执行如下代码然后再重新部署
1
npm install --save hexo-deployer-git
Hexo安装git组件
  1. 出现403错误可以将 _config.yml 配置文件中 repo 字段的 https 地址更改为 SSH 地址。

搭建自己的Hexo博客
http://example.com/2020/04/10/搭建自己的Hexo博客/
作者
DustWind
发布于
2020年4月10日
许可协议