Hexo博客搭建并部署到GitHub远程仓库（Windows）

发表于 更新于 分类于

本文记录了在本地Windows系统上搭建Hexo博客，通过Git将经过渲染后的静态文件部署到GitHub远程仓库，最终实现能在互联网上访问到Hexo博客的目的

注册 GitHub

GitHub官网

安装

本地是 Windows 系统

安装 Node.js

从 Node.js官网 下载并安装

打开终端输入：

1
2
node -v
npm -v

出现版本号说明安装成功：

1
2
v16.13.1
8.1.2

安装 Git

从Git官网下载
从阿里镜像下载

安装完成后，在桌面右键出现下图红框内容说明安装成功
1

安装 Hexo

创建 hexo 目录并进入，然后打开终端

安装hexo

1
npm install -g hexo-cli

格式化hexo目录

当前hexo目录下不要有跟hexo同名的文件夹

1
hexo init hexo

安装部署插件

1
npm install hexo-deployer-git --save

启动本地服务器

1
hexo server

浏览器访问 http://localhost:4000/ 成功出现下图：
2

配置

Git配置

在桌面右键选择 Git Bash Here 以打开终端

设置Git用户、邮箱

1
2
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"

生成ssh密钥文件

1
2
ssh-keygen -t rsa -C "你的GitHub注册邮箱"
cat ~/.ssh/id_rsa.pub

下图是 id_rsa.pub 公钥，将它复制，后面会用到：
5

GitHub配置

添加 id_rsa.pub 公钥

首先进入 GitHub
然后依次点击右上角头像 > Settings > SSH and GPG 　keys > New SSH key
然后将复制的 id_rsa.pub 公钥粘贴在 key ( title 可忽略)
最后点击 Add SSHkey

最终结果如下图:
6

验证 id_rsa.pub 公钥

本地终端输入：

1
ssh -T git@github.com

有提示填 yes 并回车:
7

创建仓库

首先进入 GitHub

然后依次点击右上角 + > New repository 进行配置：
3

复制仓库地址，后面会用到
4

2022/02/16

https 开头的仓库地址执行 hexo d 会遇到：

1
2
3
4
5
6
7
8
9
10
 OpenSSL SSL_read: Connection was reset, errno 10054
FATAL {
  err: Error: Spawn failed
      at ChildProcess.<anonymous> (D:\开发\hexo\hexo\node_modules\hexo-util\lib\spawn.js:51:21)
      at ChildProcess.emit (node:events:390:28)
      at ChildProcess.cp.emit (D:\开发\hexo\hexo\node_modules\cross-spawn\lib\enoent.js:34:29)
      at Process.ChildProcess._handle.onexit (node:internal/child_process:290:12) {
    code: 128
  }
} Something's wrong. Maybe you can find the solution here: %s https://hexo.io/docs/troubleshooting.html

解决方法是复制仓库的 SSH 地址写入站点配置文件

Hexo配置

hexo根目录下有一个 _config.yml 站点配置文件：
8

hexo/themes/landscape/ 目录下是 主题配置文件 ：
9

打开 站点配置文件 最下面添加：

1
2
3
4
deploy:
  type: git
  repository: 你的GitHub仓库地址（ssh方式）
  branch: main

注意冒号 : 后接一个空格，格式不对可能造成打开网页404

部署到 GitHub

hexo根目录下打开终端输入：

1
2
3
hexo clean  #清除缓存
hexo g      #生成静态文件
hexo d      #部署

下图最后一行出现 Depioy done:git 表示部署成功
10

浏览器访问 用户名.github.io 就可以看到Hexo博客了（需等待一段时间）

相关文章

参考资料