Hexo 部署及 Qexo 部署管理 Hexo 博客教程

一、将 Hexo 博客部署到 GitHub

1. 安装 Git

Git 是目前最先进的分布式版本控制系统，可以高效管理 Hexo 博客并上传至 GitHub。

Linux 系统安装 Git

1 2	sudo apt-get install git-core # Ubuntu/Debian 系统 sudo yum install git-core # Fedora/Red Hat/CentOS

检查安装是否成功

1	git --version

2. 安装 Node.js 和 npm

Hexo 依赖于 Node.js 和 npm，请先安装它们。

Windows 安装

前往 Node.js 官方下载选择 LTS 版本安装。

Linux 安装

1	sudo apt-get install nodejs npm

检查安装是否成功

1	node -vnpm -v

3. 安装 Hexo

3.1 全局安装 Hexo

1	npm install -g hexo-cli

3.2 初始化 Hexo 博客

1	mkdir -p ~/hexocd hexohexo initnpm install

Hexo 目录结构说明

node_modules  # 依赖包
public        # 生成的静态页面
scaffolds     # 文章模板
source        # 存放博客文章
themes        # 主题
_config.yml   # 配置文件
db.json       # 解析所得数据
package.json  # 依赖模块配置

3.3 生成静态文件

1	hexo clean && hexo generate

3.4 启动本地预览

1	hexo server -p 4000

然后访问：

本地：http://127.0.0.1:4000
服务器：http://your-vps-ip:4000

使用 Ctrl + C 可停止服务。

4. 生成 SSH 并添加到 GitHub

1	git config --global user.name "GitHub用户名"git config --global user.email "GitHub邮箱"ssh-keygen -t rsa -C "[email protected]"

在 ~/.ssh 目录中，找到 id_rsa.pub 并添加到 GitHub：

进入 GitHub > Settings > SSH and GPG keys
点击 “New SSH key”
复制 id_rsa.pub 内容到 Key 栏目
确认添加

测试 SSH 连接

1	ssh -T [email protected]

输入 yes 并回车。

5. 部署 Hexo 博客到 GitHub

⚠️ 注意：如果要配合 Cloudflare Pages + Qexo 来管理博客，可跳过此步骤。

5.1 创建 GitHub 仓库

登录 GitHub
创建新仓库，命名为 yourusername.github.io
设置为 Public
复制 SSH 地址 [email protected]:yourusername/yourusername.github.io.git

5.2 安装 Hexo 部署插件

1	npm install hexo-deployer-git --save

5.3 配置 `_config.yml`

1	deploy: type: git repo: [email protected]:yourusername/yourusername.github.io.git branch: main

二、GitHub 仓库 + Cloudflare Pages 部署 Hexo 博客

通过 Cloudflare Pages 部署，可实现私有化博客源代码管理。

1. 创建 GitHub 私有仓库

创建一个私有仓库 Hexo-Source 用于存放 Hexo 源代码。

2. 上传 Hexo 源代码

1	git initgit add .git commit -m "first commit"git remote add origin [email protected]:用户名/Hexo-Source.gitgit push -u origin main

3. Cloudflare Pages 设置

进入 Cloudflare > Workers & Pages
选择 Pages > 连接到 GitHub
绑定 GitHub 账号，选择 Hexo-Source 仓库

4. 构建 Hexo 博客

框架预设：无
构建命令：npm install hexo-cli -g && hexo generate
构建输出目录：public
建议：在环境变量中指定 NODE_VERSION 版本，与本地 Hexo 兼容。

三、使用 Qexo 作为 Hexo 博客管理后台

Qexo 是一个在线管理 Hexo 博客的工具，支持文章管理、配置编辑等功能。

1. 获取 GitHub Token

进入 GitHub Settings
Developer Settings > Personal access tokens > Tokens (classic) > Generate new token (classic)
选择 No expiration，勾选 repo 和 workflow
复制生成的 Token
在 Hexo-Source 仓库的 Settings > Secrets and variables > Actions > New repository secret 添加 Token