搭建Hexo博客并托管到Github

博主：晚风
发布时间：2023 年 04 月 05 日
437 次浏览
暂无评论
6879字数
分类：网站/教程

> 起因：比较无聊，习惯了使用typecho、wordpress的这种简单博客程序，想试试有点难度的好玩的hexo博客，并且打算借此几乎了解一下get

# 一、安装Git和Node

> 本次教程环境包括Windows与Mac

### 安装Git：

<div class="tab-container post_tab box-shadow-wrap-lg">
<ul class="nav no-padder b-b scroll-hide" role="tablist">
<li class='nav-item active' role="presentation"><a class='nav-link active' style="" data-toggle="tab" 
aria-controls='tabs-1fa3c8eed743a223e29ca6108939bc76290' role="tab" data-target='#tabs-1fa3c8eed743a223e29ca6108939bc76290'>Windows</a></li><li class='nav-item ' role="presentation"><a class='nav-link ' style="" data-toggle="tab" 
aria-controls='tabs-3fb300a78c2fbe0ce16531597e1fecd661' role="tab" data-target='#tabs-3fb300a78c2fbe0ce16531597e1fecd661'>Mac</a></li>
</ul>
<div class="tab-content no-border">
<div role="tabpanel" id='tabs-1fa3c8eed743a223e29ca6108939bc76290' class="tab-pane fade active in">
            
前往：Git 官网: https://git-scm.com/ 下载对应版本的安装包（若网络问题导致下载速度慢可选择代下服务）
安装过程一直点击下一步即可，安装进度条跑完后回到桌面，鼠标右键如果有显示这两个git，代表安装成功。
![Pasted image 20230402231622.png](http://img.wfy.pub/i/2023/04/05/642c6f10af01b.png)
</div><div role="tabpanel" id='tabs-3fb300a78c2fbe0ce16531597e1fecd661' class="tab-pane fade  ">
            
访问:https://sourceforge.net/projects/git-osx-installer/

下载后根据提示安装

![image-20230430151501470](http://img.wfy.pub/i/2023/04/30/644e157c815be.png)

</div>
</div>
</div>

### 安装Node：

前往：Node.js官网：https://nodejs.org/zh-cn/  下载对应版本的安装包（若网络问题导致下载速度慢可选择代下服务）
安装过程一直点击下一步即可，安装完成后按住`WIn+R`键，输入：`node -v` 出现版本号代表安装成功。
![Pasted image 20230402232823.png](http://img.wfy.pub/i/2023/04/05/642c6f10a6055.png)

# 二、安装Hexo：

Hexo官网：https://hexo.io/zh-cn/index.html

### 创建文件夹：

安装Hexo之前，现在本地创建一个用于存放hexo文件的文件夹

### 拉取hexo代码：

在创建的文件夹内右键，点击`Git Bash Here`会弹出一个对话框，对话框的内容是当前文件的路径地址
![Pasted image 20230402233926.png](http://img.wfy.pub/i/2023/04/05/642c6f10aa32a.png)

在hexo的官网下方，复制安装命令**逐条**执行，代码如下：

```
npm install hexo-cli -g
   hexo init blog
   cd blog
   npm install
   hexo server
```

第一行安装过程中非魔法网络可能需要等待一会或者换源
第二行代码运行完毕之后，返回文件夹内可以看到出现一个新的blog文件夹
第三行代码是进入这个新的文件夹内
之后运行第四行代码
最后一行可以改成`hexo s`直接运行
之后就会返回一个blog地址：
![Pasted image 20230403002330.png](http://img.wfy.pub/i/2023/04/05/642c6f11f2547.png)
`http://localhost:4000/`这个就是我们本地的blog地址了，复制到浏览器即可打开
![Pasted image 20230403002424.png](http://img.wfy.pub/i/2023/04/05/642c6f15b6af1.png)
如果显示这个界面，那么hexo就已经安装成功了！

# 三、编辑blog文章

### 创建第一篇文章

进入`blog`文件夹内，右键选择`Git Bash Here`，在弹出的对话框内输入`hexo new "第一篇文章"`即可创建第一篇文章
![Pasted image 20230403003005.png](http://img.wfy.pub/i/2023/04/05/642c6f15a7cea.png)
在`blog`文件夹内，选择`source`进入`_posts`文件内，就可以看到我们刚刚创建的第一篇文章本地位置
路径：`blog\source\_posts`

右击`第一篇文章`，进入编辑， hexo使用的是**markdown语法**，简单学习易用，先随意编写几个东西跑一下看看。

### 生成并运行

运行`hexo g`生成页面，运行`hexo s`运行博客
![Pasted image 20230403005552.png](http://img.wfy.pub/i/2023/04/05/642c70f8bdb1e.png)
已经显示了刚刚创建的第一篇博文：
![Pasted image 20230403002424.png](http://img.wfy.pub/i/2023/04/05/642c6f15b6af1.png)
目前，hexo博客已经部署完成，只不过只能放在本地自己浏览使用。

# 四、更改博客样式：

进入hexo主题：https://hexo.io/themes/
选择一款喜欢的主题并安装，这里以Ayer主题做介绍，地址：https://shen-yu.gitee.io/
每个主题基本都有相关的安装教程，可能略有差异。

## 更换Ayer主题

### 下载主题：

安装命令：
`git clone https://gitee.com/mirrors/ayer.git  themes/ayer`
进入blog根目录（打开blog文件夹）右键`Git Bash Here`，将上行代码复制进去回车运行
![Pasted image 20230403011616.png](http://img.wfy.pub/i/2023/04/05/642c70fa9393d.png)
安装完成后可以在`blog\themes`目录内看到主题文件了。

### 更换主题：

进入`blog`文件夹，选择`_config`文件打开，下滑到最底部，theme后面改成切换的主题名称：
![Pasted image 20230403012135.png](http://img.wfy.pub/i/2023/04/05/642c70fcac9f9.png)

`hexo g`生成网页，`hexo s`运行博客：
如下图显示，就是更换主题成功了！如果在运行的时候有端口占用报错，关闭之前的git对话框即可。
![Pasted image 20230403012558.png](http://img.wfy.pub/i/2023/04/05/642c7108ef6b8.png)

# 五、修改主题配置

https://shen-yu.gitee.io/2019/ayer/
这里的Ayer主题相关的修改教程就在上方连接内，值得注意的是blog配置文件和主题配置文件不能搞混了，在修改主题配置文件之前建议先备份一次副本，以免修改之后出现错误找不出来。
修改的过程就是对照对照代码改改，目前这一步先跳过

> 本次使用了 AnZhiYu主题，官方教程：
> 0：https://anzhiy.cn/posts/61e4.html
> 1：https://anzhiy.cn/posts/220c.html
> 2：https://anzhiy.cn/posts/ce04.html
> 具体安装教程将不再此赘述。

# 六、 部署到 Github Pages

到目前为止，我们的本地博客就成功搭建了，但是现在我们只能通过本地连接查看博客，我们要做的是让其他人也能够访问我们的博客，这就需要我们将博客部署到 Github Pages 上

### 登录/注册github

注册或登录 Github 账户：点击此处访问 [Github 官网](https://github.com/)，点击 注册或登录

### 创建仓库

创建项目代码库：点击 New repository 开始创建，步骤及注意事项见图（选择第一个）：

![Pasted image 20230405015925.png](http://img.wfy.pub/i/2023/04/05/642c70fb8ba10.png)

创建仓库:
![Pasted image 20230405020114.png](http://img.wfy.pub/i/2023/04/05/642c719f41d2e.png)

仓库名称填：你的用户名.github.io
勾选Public，公开仓库别人才能看见你的博客
勾选Add a README file，创建自述文件

### 配置SSH密钥

配置 `SSH` 密钥：只有配置好 `SSH` 密钥后，我们才可以通过 git 操作实现本地代码库与 Github 代码库同步，在你第一次新建的文件夹里面（如：我的文件夹为：`F\QiQi_Blog`） `Git Bash Here` 输入以下命令

```bash
ssh-keygen -t rsa -C "your email@example.com"
//引号里面填写你的邮箱地址，比如我的是2268025923@qq.com
```

之后会出现：

```bash
Generating public/private rsa key pair.
Enter file in which to save the key (/c/Users/you/.ssh/id_rsa):
//到这里可以直接回车将密钥按默认文件进行存储
```

然后会出现：

```bash
Enter passphrase (empty for no passphrase):
//这里是要你输入密码，其实不需要输什么密码，直接回车就行
Enter same passphrase again:
```

接下来屏幕会显示：

```bash
Your identification has been saved in /c/Users/you/.ssh/id_rsa.
Your public key has been saved in /c/Users/you/.ssh/id_rsa.pub.
The key fingerprint is:
这里是各种字母数字组成的字符串，结尾是你的邮箱
The key's randomart image is:
这里也是各种字母数字符号组成的字符串
```

运行以下命令，将公钥的内容复制到系统粘贴板上：

```bash
clip < ~/.ssh/id_rsa.pub
```

### 在 GitHub 账户中添加你的公钥

登陆 GitHub，进入 `Settings`：
![Pasted image 20230405020951.png](http://img.wfy.pub/i/2023/04/05/642c719dbabde.png)
点击 `SSH and GPG Keys`：
![Pasted image 20230405021239.png](http://img.wfy.pub/i/2023/04/05/642c71a043542.png)

如图操作，填写完之后点击Add SSH key：
![Pasted image 20230405021402.png](http://img.wfy.pub/i/2023/04/05/642c71a1817ee.png)

### 测试连接

直接在桌面右键 点击 Git Bash Here，输入以下命令输入以下命令：注意：[git@github.com](mailto:git@github.com)不要做任何更改！

```bash
ssh -T git@github.com
```

之后显示：
![Pasted image 20230405021648.png](http://img.wfy.pub/i/2023/04/05/642c719e43e7f.png)
输入 `yes` 后会显示：
![Pasted image 20230405021724.png](http://img.wfy.pub/i/2023/04/05/642c719e909e5.png)
此时表示设置正确，测试成功。

### 配置 Git 个人信息

Git 会根据用户的名字和邮箱来记录提交，GitHub 也是用这些信息来做权限的处理，输入以下命令进行个人信息的设置，把名称和邮箱替换成你自己的，名字可以不是 GitHub 的昵称，但为了方便记忆，建议与 GitHub 一致

```bash
git config --global user.name "此处填你的用户名"
git config --global user.email "此处填你的邮箱"
```

到此为止 SSH Key 配置成功，本机已成功连接到 Github

> 接下来将本地的Hexo文件更新到Github的库中

### 复制SSH

鼠标移到 Code 按钮，点击按钮复制，或者直接把 SSH 全部复制
![Pasted image 20230405022251.png](http://img.wfy.pub/i/2023/04/05/642c719fea626.png)

### 修改文件

打开本地 Hexo 文件夹，右键用记事本（或者 Notepad++、Vs Code 等）打开该文件夹下的 _config.yml 文件

滑到最下面,按下图修改 _config.yml 文件并保存
![Pasted image 20230405022441.png](http://img.wfy.pub/i/2023/04/05/642c71a0a47bb.png)

按照图片里面内容修改自己文件，106填写在Github辅助的ssh，107行看一下自己创建仓库的分支，大部分是main 。

### 上传文件

在 Hexo 文件夹下分别执行以下命令：

```bash
hexo g
hexo d
```

执行完之后会让你输入你的 Github 的账号和密码，如果此时报以下错误，说明你的 deployer 没有安装成功

```bash
ERROR Deployer not found: git
```

需要执行以下命令再安装一次：

```bash
npm install hexo-deployer-git --save
```

安装后执行：

```bash
hexo g -d
```

之后博客就会部署到 Github 上了

到这里本地文件就上传到GitHub托管了，通过刚才创建仓库的名称访问：你的用户名.github.io 就可以访问你的线上博客了。
后续博客新增内容，在本地编写，通过下方代码就可以将最新文件同步到github。

```bash
hexo g -d
```

本篇文章到此已经结束：
参考了以下相关内容：

- https://www.bilibili.com/video/BV1ts4y1f7Gu/?spm_id_from=333.999.0.0&vd_source=94db365cd015d31bcc03b540b19e26ba
- https://anzhiy.cn/posts/61e4.html
- https://anzhiyu-c-github-io.vercel.app/posts/ddae.html#%E5%B0%86%E5%8D%9A%E5%AE%A2%E9%83%A8%E7%BD%B2%E5%88%B0-Github-Pages-%E4%B8%8A

最后修改：2023 年 05 月 09 日

如果觉得我的文章对你有用，请随意赞赏

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

wu先生
技术文，不明觉历。
泽泽
应该叫迁移不是移植
鸟叔
这种复杂的事情我一般都会交给插件
空空裤兜
用过一段时间，也会偶尔出问题，自建的方案也会出问题，最后就随便吧。
Sirit
是不是只有MySQL支持emoji，sqlite数据库就不支持啊？

搭建Hexo博客并托管到Github

晚风 • 2023 年 04 月 05 日

> 起因：比较无聊，习惯了使用typecho、wordpress的这种简单博客程序，想试试有点难度的好玩的hexo博客，并且打算借此几乎了解一下get

# 一、安装Git和Node

> 本次教程环境包括Windows与Mac

### 安装Git：

下载后根据提示安装

![image-20230430151501470](http://img.wfy.pub/i/2023/04/30/644e157c815be.png)

</div>
</div>
</div>

### 安装Node：

# 二、安装Hexo：

Hexo官网：https://hexo.io/zh-cn/index.html

### 创建文件夹：

安装Hexo之前，现在本地创建一个用于存放hexo文件的文件夹

### 拉取hexo代码：

在hexo的官网下方，复制安装命令**逐条**执行，代码如下：

```
npm install hexo-cli -g
   hexo init blog
   cd blog
   npm install
   hexo server
```

# 三、编辑blog文章

### 创建第一篇文章

右击`第一篇文章`，进入编辑， hexo使用的是**markdown语法**，简单学习易用，先随意编写几个东西跑一下看看。

### 生成并运行

# 四、更改博客样式：

## 更换Ayer主题

### 下载主题：

### 更换主题：

# 五、修改主题配置

# 六、 部署到 Github Pages

### 登录/注册github

注册或登录 Github 账户：点击此处访问 [Github 官网](https://github.com/)，点击 注册或登录

### 创建仓库

创建项目代码库：点击 New repository 开始创建，步骤及注意事项见图（选择第一个）：

![Pasted image 20230405015925.png](http://img.wfy.pub/i/2023/04/05/642c70fb8ba10.png)

创建仓库:
![Pasted image 20230405020114.png](http://img.wfy.pub/i/2023/04/05/642c719f41d2e.png)

仓库名称填：你的用户名.github.io
勾选Public，公开仓库别人才能看见你的博客
勾选Add a README file，创建自述文件

### 配置SSH密钥

```bash
ssh-keygen -t rsa -C "your email@example.com"
//引号里面填写你的邮箱地址，比如我的是2268025923@qq.com
```

之后会出现：

```bash
Generating public/private rsa key pair.
Enter file in which to save the key (/c/Users/you/.ssh/id_rsa):
//到这里可以直接回车将密钥按默认文件进行存储
```

然后会出现：

```bash
Enter passphrase (empty for no passphrase):
//这里是要你输入密码，其实不需要输什么密码，直接回车就行
Enter same passphrase again:
```

接下来屏幕会显示：

运行以下命令，将公钥的内容复制到系统粘贴板上：

```bash
clip < ~/.ssh/id_rsa.pub
```

### 在 GitHub 账户中添加你的公钥

如图操作，填写完之后点击Add SSH key：
![Pasted image 20230405021402.png](http://img.wfy.pub/i/2023/04/05/642c71a1817ee.png)

### 测试连接

直接在桌面右键 点击 Git Bash Here，输入以下命令输入以下命令：注意：[git@github.com](mailto:git@github.com)不要做任何更改！

```bash
ssh -T git@github.com
```

### 配置 Git 个人信息

```bash
git config --global user.name "此处填你的用户名"
git config --global user.email "此处填你的邮箱"
```

到此为止 SSH Key 配置成功，本机已成功连接到 Github

> 接下来将本地的Hexo文件更新到Github的库中

### 复制SSH

鼠标移到 Code 按钮，点击按钮复制，或者直接把 SSH 全部复制
![Pasted image 20230405022251.png](http://img.wfy.pub/i/2023/04/05/642c719fea626.png)

### 修改文件

打开本地 Hexo 文件夹，右键用记事本（或者 Notepad++、Vs Code 等）打开该文件夹下的 _config.yml 文件

滑到最下面,按下图修改 _config.yml 文件并保存
![Pasted image 20230405022441.png](http://img.wfy.pub/i/2023/04/05/642c71a0a47bb.png)

按照图片里面内容修改自己文件，106填写在Github辅助的ssh，107行看一下自己创建仓库的分支，大部分是main 。

### 上传文件

在 Hexo 文件夹下分别执行以下命令：

```bash
hexo g
hexo d
```

执行完之后会让你输入你的 Github 的账号和密码，如果此时报以下错误，说明你的 deployer 没有安装成功

```bash
ERROR Deployer not found: git
```

需要执行以下命令再安装一次：

```bash
npm install hexo-deployer-git --save
```

安装后执行：

```bash
hexo g -d
```

之后博客就会部署到 Github 上了

```bash
hexo g -d
```

本篇文章到此已经结束：
参考了以下相关内容：

搭建Hexo博客并托管到Github

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

一键安装Aria2 + AriaNg + Filebrowser实现离线下载

风铃发卡搭建教程

莫等闲，白了少年头，空悲切！

搭建青龙面板

Hello 2020

一键安装Aria2 + AriaNg + Filebrowser实现离线下载

自建图床-Lsky Pro

国内下载vscode速度慢问题解决

搭建私有笔记

XDD- PLUS安装教程

搭建Hexo博客并托管到Github

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

搭建Hexo博客并托管到Github

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款