1.使用 Cloudflare + GitHub + Hexo 搭建高效免费的个人博客

作者: mensa

发表于2026-05-11

更新于2026-05-15

博客搭建

我会把这里打造成我的个人知识库，记录下每一个阶段遇到的问题和思考。与其说是写给别人看，不如说是写给未来的自己。希望通过这种最笨也最扎实的方式，把学到的东西真正留下来。

引言

搭建这个博客的想法其实很简单：我发现很多技术问题在解决后，如果不及时记录，过段时间再遇到还是得重新查资料、翻文档，这种重复劳动效率很低。所以我决定把这里当作自己的“知识库”。我会把这里打造成我的个人知识库，记录下每一个阶段遇到的问题和思考。与其说是写给别人看，不如说是写给未来的自己。希望通过这种最笨也最扎实的方式，把学到的东西真正留下来。

下面是一些自建博客的优势：

高度自由定制：完全掌控页面设计、布局与功能。
丰富的插件生态：借助 Hexo 庞大的插件库，轻松扩展所需功能。
极致的性价比：依托 Cloudflare 和 GitHub Pages 的免费服务，搭建成本几乎仅为域名费用。
因此，利用 Hexo 搭建个人博客，不仅实用，而且非常经济。

工具与环境

操作系统： Windows。
代码托管与发布：GitHub 账户。
CDN、DNS 与 HTTPS：Cloudflare 账户。
域名：用于访问你的博客 (推荐在 Namesilo 等平台注册，并可无缝托管至 Cloudflare)。
运行环境：Node.js (推荐安装lts版本)。

Node.js安装

推荐安装lts版本，访问[Nodejs官网](Node.js — Download Node.js®),选择合适的平台以及安装方式

安装完成后重启终端(或新开一个bash)，使用node -v和npm -v来检查是否正确安装。

Hexo

安装

在完成了Node.js安装之后，安装Hexo就很简单了，使用下列命令即可安装

1	npm install hexo-cli -g

在终端输入后直接回车便可自动安装，待安装完成后输入hexo -v来验证是否安装成功

新建博客

在hexo安装完成后，切换到你希望存放博客文件的目录，使用下列命令来创建一个博客

1	hexo init [name] # name为你创建博客文件夹的名称，使用时不要加括号，例如:hexo init blog

成功后会输出下列信息

1
2
3

INFO  Cloning hexo-starter https://github.com/hexojs/hexo-starter.git
INFO  Install dependencies
INFO  Start blogging with Hexo!

接着进入博客目录，修改配置文件_config.yml,主要修改下列几项

title: #网站标题
subtitle: #网站副标题
author: #作者
language: zh-CN #语言选项
timezone:  Asia/Shanghai #时区，大陆填这个就行
url: #网站的域名
# 如果采用github pages，则为https://username.github.io/,后续会讲
# 如果采用CloudFlare，则为购买的域名
theme: landscape #主题，可以自己选择自己喜欢的，下载完成后修改为对应的主题名称即可
#下面为采用GitHub Pages需要的配置，如采用CloudFlare则不用配置
deploy:
  type: git
  repo: https://github.com/username/username.github.io.git #username为你的GitHub用户名
  branch: main
  message: 'Site updated: {{ now("YYYY-MM-DD HH:mm:ss") }}'

接下来就可以生成本地预览了

1 2	hexo g #生成静态文件 hexo s #启用本地预览

接着访问http://localhost:4000/即可预览博客，正常情况下你应该能看到如下界面

至此，你已经成功搭建了一个博客了，对于主题，我用的是neow，更多主题请访问hexo官网查看。

以下为hexo常用命令

1
2
3

hexo clean # 用以清理生成的静态文件
hexo g     # 生成静态文件
hexo s     # 启用本地预览

Github

ssh配置

首先使用下列命令生成ssh密钥

1	ssh-keygen -t rsa -C "xxx@xxx.com" # 将 "xxx@xxx.com" 替换为你自己GitHub的邮箱地址

接着获取公钥内容（下面的是Linux的方法，windows的话直接找到对应的文件用记事本打开就可以）

1 2	cd ~/.ssh cat id_rsa.pub # 查看公钥内容，复制

GitHub设置中添加公钥,打开GitHub->Settings，选择SSH and GPG keys –> new SSH key,名称随意,粘贴刚刚复制的密钥(Title随便填)

使用以下命令检测是否配置成功，出现successful字样即为成功

1	ssh -T git@github.com

新建仓库

Github Pages(不稳定)

对于使用GitHub Pages的读者，需要创建一个名为username.github.io的仓库，username为GitHub用户名，在yml文件中配置好deploy后，使用下列命令即可完成博客搭建

hexo d

后续更新只需要使用下列命令即可更新GitHub Pages

1	hexo clean && hexo g && hexo d

CloudFlare(推荐)

由于GitHub在国内的访问并不稳定，有概率无法打开网站，因此推荐采用CloudFlare+域名的方式来托管博客，操作如下

在github上新建一个仓库(名称随意，但仓库权限最好设置为私有，以防hexo中一些配置用到ID和Key泄露)

接着回到博客目录下，使用下列命令来将本地内容push到GitHub

git init #建立本地仓库
git remote add origin https://github.com/username/blog.git #与GitHub仓库建立连接，将地址更改为你仓库的地址
git add .
git commit -m "sync"
git branch -M main
git push -u origin main

至此就成功将博客存储在GitHub，后续更新只需要commit并push即可。