Hexo——从搭建到更换设备

本文主要关于在Ubuntu20.04系统下移植Hexo搭建的个人网站

1、起因

原来自己的笔记本是Win10系统，现接手实验室师兄的主机，重新刷了Ubuntu20.04的系统，想要在新主机上部署自己的博客。在此过程中涉及到了Ubuntu20.04系统重新部署Hexo，故写此笔记记录Ubuntu20.04系统下Hexo从搭建到移植的过程。

2、前期准备——Hexo的搭建

首先是在Ubuntu下搭建自己的Hexo博客，这里主要参考官方文档：

Hexo官方安装文档

参考官方文档中Linux的安装流程，主要需要安装 Git、Node.js 两样程序。其中 Node.js是基于npm安装的 ，官方没有提示，故以下是笔者自己的安装流程：

2.1、安装Git

1	sudo apt install git-core

2.2、安装Node.js

安装Node.js过程需参考 Nodesource 中对应的Node.js版本，这里是 Ubuntu下 v20.x 版本为例。

# 安装 npm
sudo apt install npm
# 安装 Node.js v20.x
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - &&\
sudo apt-get install -y nodejs

2. 3、安装 Hexo

完成上述步骤后，在终端中安装输入安装指令：

1	npm install -g hexo-cil

安装完成后将L将 Hexo 所在的目录下的 node_modules 添加到环境变量之中以使用 Hexo 相关指令：

1 2	# 添加到 home 目录下 .bashrc 文件 echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

2.4、测试

安装好 Hexo 后，做一次简单的测试：

# 初始化新建 Hexo 文件夹
hexo init <folder>
# 移动到新文件夹
cd <folder>
# 安装必要插件
npm install

接着就可以查看自己搭建好的个人博客了：

# 清空 Hexo 缓存
hexo clean
# 编译 Hexo： hexo generate, 简写如下
hexo g 
# 打开本地访问： hexo server, 简写如下
hexo s

输入 hexo s 后终端会给一条本地链接 http://localhost:4000 ，复制后在浏览器中打开即可看见。

3、部署 Hexo 到 Github

按上述操作搭建好 Hexo 后只能在本地显示，要将博客推送到网上还需要与 Github 进行绑定。

3.1、主机 SSH 验证

由于是笔者是新刷的系统，故还需要将本机与 Github 进行验证才可绑定，这里选择 SSH验证。

参考官方文档 Generating a new SSH key and adding it to the ssh-agent

1
2
3

# 生成密钥
ssh-keygen -t ed25519 -C "your_email@example.com"
# 后续直接多次回车，直至生成密钥完成

生成密钥后，将 .ssh 文件夹下的 .pub 文件添加到 Github 中，具体操作参考官方文档 Adding a new SSH key to your GitHub account

3.2、修改 Hexo 配置文件

进行验证后，在终端进行 Github 账号验证（登陆）：

1 2	git config --global user.name "username" git config --global user.email "username@example.com" //注册GitHub时使用的主邮箱

完成上述步骤后，打开 Hexo 文件夹下的配置文件 _config.yml ：

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repo: 
  # 此处添加到自己的 Github 主页
    github: git@github.com:username/username.github.io.git
  branch: master

3.3、部署测试

依次输入如下指令查看部署情况：

hexo clean
hexo g
# 远程部署 hexo deploy, 简写如下
hexo d

登陆 https://username.github.io 即可查看部署效果。

4、Hexo主机迁移

在更换主机设备后，由于我们的博客内容都保留在本地，故想要对博客进行迁移时需要将本地的资料一并保留迁移。

这里主要参考了使用hexo，如果换了电脑怎么更新博客。

按照上述方法解决即可，这里作简要步骤的记录：

4.1、保留必要文件

_config.yml
theme/
source/
scaffolds/
package.json
.gitignore

4.2、进行 npm 安装

将上述文件拷贝到新的 Hexo 文件夹下后，执行如下命令进行模块安装：

1	npm install

同时安装部署模块

1	npm install hexo-deployer-git --save

4.3、测试

参考本文 3.3、部署测试。

4.4、远端迁移方法

每次都要将本地文件进行拷贝比较麻烦，这里参考使用hexo,如果还了电脑怎么更新博客，的方法可以借助 Github 进行远端部署，十分方便。

具体而言，对网页仓库（.github.io结尾）新建一条分支，如：hexo，每次修改完博客后将本地博客 push 到该分支，然后在将博客推送到 master 分支上，即3.2、修改 Hexo 配置文件中的 branch。

# 推送到 hexo 分支
git add.
git commit -m "……"
git push origin hexo
# 推送到个人主页，前提是配置文件中设定好 branch 为 master
hexo g
hexo d

AppZ99's Blog