Hexo 博客部署到 GitHub 和 Cloudflare Pages 完整指南

本文将带你从 零开始，完成 Hexo 博客的安装、初始化，并分别部署到 GitHub 和 Cloudflare Pages。

1. 安装依赖环境
   📦 安装 Node.js
   官网地址：
   👉 https://nodejs.org/

安装完成后，验证是否成功：

1
2

node -v
npm -v

🧰 安装 Git

下载地址：
👉 https://git-scm.com/downloads

安装完成后，验证：

1

git --version

2. 安装 Hexo CLI

在终端中执行：

1

npm install -g hexo-cli

验证安装：

1

hexo -v

3. 初始化 Hexo 项目

📁 创建并初始化项目

1
2
3
4

mkdir hexo
cd hexo
hexo init
npm install

🔍 启动本地服务器查看效果

1

hexo server

在浏览器中访问：

http://localhost:4000

如果看到 Hexo 默认博客页面，说明初始化成功 🎉

4. 初始化 Git 仓库并提交代码

🛠 设置 Git 用户信息（只需一次）

1
2

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

确认设置是否成功：

1

git config --global --list

📦 初始化仓库并提交

1
2
3

git init
git add .
git commit -m "Initial commit"

5. 推送代码到 GitHub

1️⃣ 在 GitHub 创建新仓库

1. 登录 GitHub：https://github.com/

2. 点击右上角 + → New repository

3. 填写仓库信息：

Repository name：如 hexo.github.io

Description：如「我的 Hexo 博客」（可选）

选择 Public

4. 其他选项保持默认

5. 点击 Create repository

2️⃣ 添加远程仓库并推送代码

📋 复制仓库地址

示例：

https://github.com/your-username/hexo.git

🚀 推送代码

1
2
3

git remote add origin https://github.com/your-username/hexo.git
git branch -M main
git push -u origin main

说明：

your-username 替换为你的 GitHub 用户名

hexo 替换为你的仓库名

若 GitHub 要求认证，请使用 Personal Access Token（Token）

6. 使用 Cloudflare Pages 自动部署

📌 创建 Pages 项目

1. 登录 Cloudflare 控制台
   👉 https://dash.cloudflare.com/

2. 进入 Pages

3. 点击 创建项目

4. 连接 GitHub

5. 授权并选择你的 Hexo 仓库

🛠 构建设置（非常重要）

构建命令

1

npx hexo generate

发布目录

1

public

框架预设

None

保存并开始部署后，Cloudflare Pages 会自动构建并生成访问地址 🎉

✅ 部署完成
Cloudflare 构建成功后，会自动生成一个 .pages.dev 域名用于预览

下面是整理好的 Markdown（.md）版本，可直接接在你前面的第 6 步后面使用👇

7. 配置自定义域名（可选）

你可以为 Cloudflare Pages 项目绑定自己的域名，让博客使用更专业的访问地址。

☁️ 自动解析（顶级域名已托管在 Cloudflare）

适用于：域名 DNS 已托管到 Cloudflare 的情况

1. 进入 Cloudflare Pages 项目

2. 打开 自定义域名（Custom domains）

3. 点击 设置自定义域名

4. 输入你的域名（如：example.com）

5. Cloudflare 会自动为你生成并配置 DNS 解析

6. 等待几分钟，域名即可生效

✅ 无需手动添加 DNS 记录，最省心的方式

✋ 手动解析（域名未托管在 Cloudflare 或使用子域名）

适用于：

域名 DNS 不在 Cloudflare

使用子域名（如 blog.example.com）

操作步骤

1. 在 Cloudflare Pages 中选择
   “我将手动添加 DNS 记录”

2. Cloudflare 会提供一条 CNAME 记录

3. 前往你的域名 DNS 服务商（如阿里云、腾讯云、Namecheap 等）

4. 添加以下 DNS 记录（示例）：

类型：CNAME
主机记录：blog
记录值：xxxx.xxx.xx
TTL：自动

5. 保存 DNS 记录

6. 返回 Cloudflare Pages

7. 点击 检查 DNS 记录

8. 等待解析生效（通常几分钟～数小时）

⏱ 解析生效说明

DNS 生效时间取决于域名服务商

一般 几分钟到 1 小时

最长可能需要 24 小时

🔒 HTTPS 自动启用

Cloudflare Pages 会自动签发 免费 SSL 证书

域名生效后将自动支持 https://

无需任何额外配置