搭建Hexo博客,快速简洁高效,零成本搭建个人博客:Hexo + GitHub Pages + Cloudflare Pages 完整指南

搭建Hexo博客,快速简洁高效,零成本搭建个人博客:Hexo + GitHub Pages + Cloudflare Pages 完整指南

前言

大家好,我是刘飞扬。这是我的Hexo博客的第一篇文章。之前总是想要搭建一个属于自己的博客,记录自己的学习和生活,但总是迟迟没有行动。最近终于下定决心,利用暑假的时间搭建了这个博客。

今天就来分享一下如何使用Hexo框架搭建个人博客,并将其部署到GitHub Pages和Cloudflare Pages上。整个过程非常简单,大约1-2小时就能完成。且部署在GitHub Pages和Cloudflare Pages上完全免费,可以说是零成本建站了。

事前准备

在开始之前,你需要准备以下东西:

  1. 一个GitHub账号(必须)
  2. 一个Cloudflare账号(可选,但推荐)
  3. 一个自己的域名(可选,可以购买一个域名,也可以使用GitHub Pages的免费域名)

环境准备

安装Node.js

Hexo是基于Node.js的静态博客框架,所以首先需要安装Node.js。

  1. 前往Node.js官网下载并安装Node.js。
  2. 安装完成后,打开命令行工具,输入以下命令检查是否安装成功:
$ node -v $ npm -v

如果显示版本号,则说明安装成功。

安装Git

Git是一个分布式版本控制系统,我们需要使用Git将博客部署到GitHub Pages上。

  1. 前往Git官网下载并安装Git。
  2. 安装完成后,打开命令行工具,输入以下命令检查是否安装成功:
$ git --version

如果显示版本号,则说明安装成功。

配置Git

配置Git用户名和邮箱

在使用Git之前,需要先配置用户名和邮箱。打开命令行工具,输入以下命令:

$ git config --global user.name "你的GitHub用户名" $ git config --global user.email "你的GitHub邮箱"

生成SSH密钥

为了方便后续操作,我们需要生成SSH密钥。打开命令行工具,输入以下命令:

$ ssh-keygen -t rsa -C "你的GitHub邮箱"

然后一路回车即可。

添加SSH密钥到GitHub

  1. 打开命令行工具,输入以下命令复制SSH密钥:
Mac

pbcopy < ~/.ssh/id_rsa.pub

Linux

xclip -sel clip < ~/.ssh/id_rsa.pub”>
$ # Windows
clip < ~/.ssh/id_rsa.pub

Mac

pbcopy < ~/.ssh/id_rsa.pub

Linux

xclip -sel clip < ~/.ssh/id_rsa.pub

  1. 打开GitHub,点击右上角头像,选择Settings,然后选择SSH and GPG keys,点击New SSH key,将复制的SSH密钥粘贴到Key框中,点击Add SSH key即可。

  2. 测试SSH密钥是否配置成功:

$ ssh -T git@github.com

如果显示以下信息,则说明配置成功:

$ Hi 你的GitHub用户名! You've successfully authenticated, but GitHub does not provide shell access.

创建GitHub仓库

  1. 打开GitHub,点击右上角的+号,选择New repository。
  2. 在Repository name框中输入你的GitHub用户名.github.io,例如我的GitHub用户名是cmliussss,则输入cmliussss.github.io
  3. 确保仓库是Public的。
  4. 点击Create repository创建仓库。

安装Hexo

全局安装Hexo-cli

打开命令行工具,输入以下命令安装Hexo-cli:

$ npm install -g hexo-cli

初始化Hexo项目

选择一个合适的位置创建Hexo项目,例如D盘根目录:

创建并进入blog文件夹

mkdir blog
cd blog

初始化Hexo项目

hexo init

安装依赖

npm install”>
$ # 切换到D盘
cd /d D:

创建并进入blog文件夹

mkdir blog
cd blog

初始化Hexo项目

hexo init

安装依赖

npm install

本地预览

$ hexo server

然后在浏览器中打开http://localhost:4000即可预览博客。

部署到GitHub Pages

安装deploy插件

$ npm install hexo-deployer-git --save

修改配置文件

打开博客根目录下的_config.yml文件,修改以下内容:

修改部署配置

deploy:
type: git
repo: git@github.com:你的GitHub用户名/你的GitHub用户名.github.io.git
branch: main”>
$ # 修改网站相关信息
title: 你的博客标题
subtitle: 你的博客副标题
description: 你的博客描述
keywords: 你的博客关键词
author: 你的名字
language: zh-CN
timezone: Asia/Shanghai

修改部署配置

deploy:
type: git
repo: git@github.com:你的GitHub用户名/你的GitHub用户名.github.io.git
branch: main

生成静态文件并部署

部署到GitHub Pages

hexo deploy”>
$ # 生成静态文件
hexo generate

部署到GitHub Pages

hexo deploy

部署完成后,打开https://你的GitHub用户名.github.io即可访问你的博客。

部署到Cloudflare Pages

Cloudflare Pages是Cloudflare提供的静态网站托管服务,相比GitHub Pages,它的访问速度更快,且支持自动部署。

创建Cloudflare Pages项目

  1. 登录Cloudflare,进入Pages页面,点击Create a project。
  2. 选择Connect to Git,然后选择GitHub,点击Connect GitHub。
  3. 选择你的博客仓库,点击Begin setup。
  4. 设置项目名称,Build settings中设置:
    • Framework preset: None
    • Build command: npm run build
    • Build output directory: public
  5. 点击Save and Deploy开始部署。

部署完成后,Cloudflare会自动分配一个域名,例如项目名.pages.dev,访问这个域名即可查看你的博客。

绑定自定义域名

如果你有自己的域名,可以在Cloudflare Pages的Custom domains中添加。

  1. 在Pages项目中,点击Custom domains。
  2. 点击Set up a custom domain。
  3. 输入你的域名,点击Continue。
  4. 按照提示设置DNS记录即可。

日常使用

创建新文章

$ hexo new post "文章标题"

然后在source/_posts目录下找到新创建的文章,使用Markdown编辑器编辑即可。

本地预览

$ hexo server

生成静态文件并部署

部署到GitHub Pages

hexo deploy”>
$ # 生成静态文件
hexo generate

部署到GitHub Pages

hexo deploy

如果你使用的是Cloudflare Pages,只需要将修改推送到GitHub仓库,Cloudflare会自动部署。

后续计划

至此,一个基本的Hexo博客就搭建完成了。但这只是一个默认主题的基础博客,还有很多可以优化和美化的地方。下一篇文章,我将介绍如何美化你的Hexo博客,敬请期待。

参考资料

致谢

感谢以下项目:

  • Hexo:一个快速、简洁且高效的博客框架
  • GitHub Pages:GitHub提供的静态网站托管服务
  • Cloudflare Pages:Cloudflare提供的静态网站托管服务

如果你对这篇文章有任何疑问或建议,欢迎在评论区留言。