折腾日记-Github pages + Hexo 的个人博客

本文以Linux为演示环境

1. 准备阶段

1. 注册github账号

打开github

由于github在CDN域名遭到DNS污染
国内用户可能需要自备梯子

提示

在注册账号之前,需要准备一个可用的邮箱
如果没有，请先去注册一个可用的邮箱

点击github主页右上角的Sign up,然后根据引导注册账号

2. 创建仓库

在注册好账号后，我们需要创建一个username.github.io格式的仓库

3. 创建ssh密钥

提示

github已经不再支持输入账号密码的方式push代码了

打开终端,输入命令

ssh-keygen -t rsa -C "your_email@example.com"

ssh-keygen的参数含义:

-t 参数指代密钥类型，默认为rsa，可省略
-C 参数设置注释文字，如: 你的邮箱

接下来一路回车
当你看到如下提示时，密钥就创建成功了

如果没有指定-f参数，ssh密钥对的默认名称为id_rsa(私钥)和id_rsa.pub(公钥)

接下来将id_rsa.pub添加到你的github账户中
点击Settings->SSH keys and GPG keys->New SSH Key
在当前界面中的Title文本框中输入标题

建议输入有一定含义的名字

在Key文本框中输入id_rsa.pub文件中的内容

接着点击Add SSH Key完成key的添加

在终端中输入

>ssh -T git@github.com

如若返回

>Hi HuaLiMao-AQ! You've successfully authenticated, but GitHub does not provide shell access.

则ssh密钥添加无误

---

2. 开始搭建Hexo

首先创建项目目录

cd ~
mkdir hexo
cd hexo

通过npm安装hexo-cli

npm install hexo-cli

如若提示权限不足, 请在命令前加sudo后再执行

接着运行hexo init blog 初始化博客

在blog目录下执行

hexo s -g

接下来打开localhost:4000 就可以看到博客内容了

---

3. 将博客部署到Github Pages

接下来打开hexo根目录的**_config.yml**文件
找到deploy配置

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type:
  repo:
  branch:

...

像如下填入内容

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repo: git@github.com:username/username.github.io.git
  branch: main

...

执行hexo d -g 就可以将博客部署到Github Pages了

静待几分钟,就可以通过<username.github.io>访问你的博客了!

4. 国内访问加速

这需要你拥有一个域名

首先在cloudflare注册一个账号

输入你的域名后继续

选择免费计划

继续下一步

修改你域名的DNS服务器
将域名服务商默认的DNS服务器替换为从cloudflare获得的nameservers


然后打开cloudflare仪表盘左侧的SSL/TLS,将模式改为Full (strict)

Flexible 可能会出现 重定向次数过多 的问题，进而导致网站打不开

接着进入Github->Repositories->username.github.io->Setting->Pages
在Custom domain中填入你的域名
并打开Enforce HTTPS

通过域名提供商，修改刚刚的域名解析，通过 A 记录分别解析到以下 4 个 IP：

185.199.108.153
185.199.109.153
185.199.110.153
185.199.111.153

主记录输入 @

接下来你就可以通过你的域名访问你的博客了!!!