第一期:零基础快速搭建个人博客:Hexo + GitHub Pages + Cloudflare Pages 全流程指南,免费部署超详细教程!
第一期:零基础快速搭建个人博客:Hexo + GitHub Pages + Cloudflare Pages 全流程指南,免费部署超详细教程!
Limin本这是一系列视频,暂时包括,搭建,美化,如何在不同设备上同时管理hexo。至少3期视频,大家可以先订阅我,有问题可以到我的电报群。windows和macOS操作基本一样,我以macOS演示。
如果有任何疑问,可以加入我的电报群实时交流:
- 电报群链接:https://t.me/limingroup
- 官方电报频道:https://t.me/liminchannel
1. 前期准备工作
- Node(必备)
- Git(必备)
- VSCode(可选)
- 域名,建议配置一个域名以避免被防火墙阻挡,推荐购买链接: https://spaceship.sjv.io/limin
- 配置 Cloudflare,托管域名:托管教程
- 创建免费图床:图床搭建教程
- 注册cloudflare怕被扣费,推荐用myfine有50张虚拟卡(需要护照),教程链接:注册教程
- Hexo官方主题展示:点击跳转
2.1. 安装 Node
从 Node 官网 下载适合自己系统的版本。
完成安装,Windows电脑建议使用默认目录
C:/Program Files/nodejs/
,苹果电脑无所谓。验证安装成功,在命令行中输入
node -v
检查版本信息。苹果用户可通过右键文件夹,选择“服务”,新建终端窗口以便操作。
2.2. 安装 Git
从 Git 官网 下载适配的 Git 版本。
Windows 用户可使用默认目录安装 Git,Mac 用户则按提示在终端操作。
验证安装完毕后,Windows 用户会在开始菜单中看到
Git Bash
等应用。
3. 配置 Git 密钥并连接至 Github
常用 Git 命令:
1 | git config -l |
3.1. 配置用户名和邮箱
1 | git config --global user.name "你的用户名" |
通过 git config -l
验证是否成功。
3.2. 配置公钥连接 Github
- 生成 SSH 公钥:
1 | ssh-keygen -t rsa -C "你的邮箱" |
一路回车生成密钥,进入 .ssh
文件夹复制 id_rsa.pub
公钥内容,配置到 Github 的 SSH 设置中。
在苹果电脑上,如果你知道文件的路径,可以通过以下几种方式快速找到文件:
打开Finder。
按下 Command + Shift + G,在弹出的对话框中输入文件路径,然后按 Enter。这样可以直接跳转到该路径下的文件。
在windows电脑上:
打开C盘下用户文件夹下的.ssh的文件夹,会看到以下文件
id_rsa 私钥
id_rsa.pub 公钥
找到公钥匙,并复制,打开GitHub开始配置
- 将 SSH KEY 配置到 GitHub
进入github,点击右上角头像 选择settings,进入设置页后选择 SSH and GPG keys,名字随便起,公钥填到Key那一栏。
- 测试连接:
1 | ssh -T [email protected] |
第一次连接会提示Are you sure you want to continue connecting (yes/no/[fingerprint])?,输入yes即可
3.3. 创建 GitHub.io 仓库
- 点击右上角的
+
按钮,选择新建仓库,命名格式为<用户名>.github.io
,(注意:前缀必须为用户名)选择公开Public
。 - 点击 Creat repository 进行创建即可。
4. 初始化 Hexo 博客
- 创建文件夹保存博客源码:
苹果用户随意创建好文件夹后,在文件夹右击,选择“服务”选择“新建终端窗口以便操作”
Windows用户可以(例如 D:/Hexo-Blog
),在该文件夹内启动 Git Bash 或终端。
- 安装 Hexo:
1 | npm install -g hexo-cli && hexo -v |
出现此页面代表安装成功
- 初始化 Hexo 项目安装依赖:
1 | hexo init blog-demo |
现在你的文件夹会有这些内容
- 启动项目并验证:
1 | hexo cl && hexo s |
在浏览器中访问 http://localhost:4000/ 以查看效果。
5. 将静态博客挂载到 GitHub Pages
- 修改
_config.yml
文件,配置repository
为你的 GitHub 地址,分支改为main
:
1 | deploy: |
- 安装
hexo-deployer-git
:
1 | npm install hexo-deployer-git --save |
- 部署到 GitHub:
1 | // Git BASH终端 |
访问 https://<用户名>.github.io/
以查看博客。
6. 将静态博客挂载到 Cloudflare Pages
- 通过 Cloudflare Pages 连接 Git 仓库。
- 登录 GitHub,点击保存并部署。
- 部署成功后,访问 Cloudflare 提供的链接。
如有自定义域名,可以在 Cloudflare Pages 中绑定。没有建议去申请,这样博客就不被墙了。
如何使用
新建一篇博文
1 | hexo new 这是一篇新的博文 |
编辑 _posts
文件夹中的新建文章,使用 Markdown 语法编写内容。
本地预览
1 | hexo cl && hexo s |
推送到 GitHub
1 | hexo cl && hexo g && hexo d |
进阶教程预告
接下来会介绍 Hexo 主题美化 文章写作 赶紧订阅我吧!
解决 VSCODE 报错
如果首次执行 VSCODE 终端出现报错,可以使用管理员身份打开 PowerShell,并执行以下命令:
1 | Set-ExecutionPolicy RemoteSigned |