Hexo 博客搭建教程

一、安装依赖环境

在开始之前，请确保你的电脑已安装以下基础工具。

📦 安装 Node.js

Hexo 基于 Node.js 运行。

官网地址：
👉 https://nodejs.org/

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

1
2

node -v
npm -v

🧰 安装 Git

Git 用于代码管理与部署。

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

安装完成后，验证：

1

git --version

二、安装 Hexo CLI

Hexo CLI 是 Hexo 的命令行工具。

1

npm install -g hexo-cli

验证安装是否成功：

1

hexo -v

三、初始化 Hexo 项目

📁 创建并初始化项目

1
2
3
4

mkdir hexo
cd hexo
hexo init
npm install

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

1

hexo server

在浏览器中访问：

http://localhost:4000

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

四、初始化 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"

五、推送代码到 GitHub

1️⃣ 创建 GitHub 仓库

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

2. 点击右上角 + → New repository

3. 填写仓库信息：

Repository name：如 hexo-blog

Description：可选

Public（推荐）

4. 其余选项保持默认，点击 Create repository

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

复制仓库地址，例如：

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

执行推送命令：

1
2
3

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

⚠️ 提示

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

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

六、使用 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 项目绑定自己的域名，让博客使用更专业的访问地址。

☁️ 自动解析（推荐）

适用于：域名 DNS 已托管在 Cloudflare

操作步骤：

1. 进入 Cloudflare Pages 项目

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

3. 点击 设置自定义域名

4. 输入域名（如 example.com）

5. Cloudflare 会自动配置 DNS

6. 等待几分钟即可生效

✅ 无需手动配置 DNS，最省心

✋ 手动解析（子域名或未托管）

适用于：

域名 DNS 不在 Cloudflare

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

步骤如下：

1. 在 Pages 中选择「我将手动添加 DNS 记录」

2. Cloudflare 会提供一条 CNAME 记录

3. 前往你的域名服务商后台

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

1
2
3
4

类型：CNAME
主机记录：blog
记录值：xxxx.pages.dev
TTL：自动

5. 保存 DNS

6. 返回 Cloudflare Pages

7. 点击 检查 DNS 记录

8. 等待解析生效

⏱ DNS 生效时间说明

通常：几分钟 ～ 1 小时

最长：不超过 24 小时

🔒 HTTPS 自动启用

Cloudflare Pages 会自动签发 免费 SSL 证书
域名生效后将自动支持 HTTPS，无需额外配置 ✅