使用 Hexo 创建博客并使用 GitHub Pages 和 Cloudflare 实现自定义域名以及 HTTPS

什么是 Hexo

Hexo 是一个使用 Markdown 编写文章并生成静态网页的博客系统。

安装 Hexo

以下都是基于 WSL1 Ubuntu 的操作。

官方安装文档:
https://hexo.io/zh-cn/docs/

安装依赖

  • Node.js 10.13+
  • Git
1
2
3
4
5
6
7
8
# 安装 nodejs
# https://github.com/nodesource/distributions/blob/master/README.md#debinstall
curl -fsSL https://deb.nodesource.com/setup_17.x | sudo -E bash -
sudo apt update
sudo apt install -y nodejs

# 安装 git
sudo apt install -y git

安装 Hexo

1
sudo npm install -g hexo-cli

创建博客

官方文档:
https://hexo.io/zh-cn/docs/setup

1
2
3
4
5
6
# 创建博客
hexo init blog
cd blog
npm install
# 启动博客内置的服务器
hexo server

通过浏览器访问 http://localhost:4000/ 博客

配置博客

官方文档:
https://hexo.io/zh-cn/docs/configuration

新建文章

官方文档:
https://hexo.io/zh-cn/docs/writing

1
hexo new <blog-name>

生成静态页

1
hexo generate

部署博客

官方文档:
https://hexo.io/zh-cn/docs/github-pages#%E7%A7%81%E6%9C%89-Repository

1
npm install hexo-deployer-git --save

在 _config.yml(如果有已存在的请删除)添加如下配置:

1
2
3
4
5
deploy:
type: git
repo: https://github.com/<username>/<project>
# example, https://github.com/hexojs/hexojs.github.io
branch: gh-pages

部署

1
hexo clean && hexo deploy

自定义域名

https://docs.github.com/cn/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site#configuring-a-subdomain