Hexo 博客连接 GitHub 实现自动部署史上最详细教程

Hexo 博客连接 GitHub 实现自动部署史上最详细教程

为什么要用 GitHub 自动部署？

之前我们手动生成静态文件后，需要手动上传到 Cloudflare Pages。每次写完文章都要重复这个过程，很麻烦。

连接 GitHub 后：写完文章 → git push 推送到 GitHub → Cloudflare 自动检测到更新 → 自动部署上线

好处：

  • 不用每次手动上传
  • 文章版本管理（可以回溯历史版本）
  • 多设备同步（在任何电脑都能继续写文章）

整体流程

1
2
3
4
5
本地写文章 → git 提交 → git 推送 → GitHub 仓库
                                            ↓
                                      Cloudflare Pages
                                            ↓
                                       网站上线

第一步：注册 GitHub 账号

操作步骤

  1. 打开浏览器，访问 https://github.com/
  2. 点击 Sign up（注册）
  3. 填写信息：
    • Email address：你的邮箱
    • Password：设置密码
    • Username：你想用的用户名（之后会成为你的仓库地址，如 https://github.com/你的用户名）
  4. 按提示完成验证（勾选图形验证码）
  5. 选择免费计划（Free），点 Continue
  6. 个性化设置可以跳过

注册完成后会看到什么？

进入 GitHub 主页，界面是英文的。右上角显示你的用户名，左侧是仓库列表（刚开始是空的）。

第二步：创建仓库

什么是仓库？

仓库（Repository）就是存放代码/文章的地方，相当于一个文件夹，但可以在线访问和协作。

操作步骤

  1. 点击页面左上角的 + 按钮
  2. 选择 New repository
  3. 填写仓库信息：
    • Repository name：填 my-blog（或其他名字，不能有中文）
    • Description：可选，描述一下这个仓库
    • Public / Private：选 Public（免费，Cloudflare 才能访问）
    • Add a README file：不要勾选（我们用已有的）
    • Add .gitignore：选 None
    • Choose a license：选 None
  4. 点击 Create repository

创建完成后会看到什么？

进入仓库页面，地址类似 https://github.com/你的用户名/my-blog，显示空仓库，提示：

1
2
Quick setup — if you've done this kind of page before
Get started by creating a new file or uploading an existing files.

第三步：在本地初始化 Git

什么是 Git？

Git 是一个版本管理工具，可以记录文件的修改历史，方便协作和回溯。

操作步骤

打开 Ubuntu 终端，进入博客目录：

1
cd ~/my-blog

初始化仓库

1
git init

按回车后会看到什么？

显示：

1
Initialized empty Git repository in /home/你的用户名/my-blog/.git/

说明 Git 仓库创建成功。

第四步：配置 Git 用户信息

操作步骤

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

这两行命令只需要运行一次，之后在所有仓库都有效。

第五步：关联 GitHub 仓库

操作步骤

1
git remote add origin https://github.com/你的用户名/my-blog.git

把 你的用户名 换成你真实的 GitHub 用户名。

验证关联

1
git remote -v

应该显示：

1
2
origin  https://github.com/你的用户名/my-blog.git (fetch)
origin  https://github.com/你的用户名/my-blog.git (push)

第六步：添加到 .gitignore

为什么要添加？

有些文件不应该上传到 GitHub，比如：

  • node_modules/（依赖包，太大）
  • .deploy_git/（部署生成的文件）
  • db.json（数据库文件）

操作步骤

1
nano .gitignore

在编辑器中添加以下内容：

1
2
3
4
5
node_modules/
public/
.deploy_git/
db.json/
*.log

保存退出（Ctrl + O，回车，Ctrl + X）。

第七步：提交所有文件

什么是提交？

提交（Commit）相当于给当前的文件状态”拍一张快照”，并写下说明。

操作步骤

1
git add .

. 表示添加当前目录所有文件。

按回车后会看到什么？

不会显示任何输出，这是正常的。git add 只是把文件放入”暂存区”。

提交

1
git commit -m "initial commit"

按回车后会看到什么？

显示类似：

1
2
3
[main (root-commit) abc1234] initial commit
 XX files changed, XXX insertions(+), XXX deletions(-)
 create mode 100644 ...

说明提交成功！

第八步：推送到 GitHub

操作步骤

1
2
git branch -M main
git push -u origin main

按回车后会看到什么？

第一次推送会要求登录 GitHub：

1
Username for 'https://github.com':

输入你的 GitHub 用户名，回车。

1
Password for 'https://你的用户名@github.com':

输入你的 GitHub 密码（输入时不显示字符），回车。

注意：如果是 GitHub 账号开启了两步验证，需要使用 Personal Access Token 而不是密码。创建方法见下文。

登录成功后开始上传，显示上传进度：

1
2
3
4
5
6
7
8
Enumerating objects: XX, done.
Counting objects: 100% (XX/XX), done.
Writing objects: 100% (XX/XX), XX KiB | XX KiB/s, done.
Total XX (delta XX), reused XX (delta XX)
remote: Resolving deltas: 100% (XX/XX), done.
To https://github.com/你的用户名/my-blog.git
 * [new branch]      main -> main
Branch 'main' set up to track remote branch 'main' from 'origin'.

完成后去 GitHub 刷新页面

应该能看到所有文件了！包括：

  • _config.yml
  • package.json
  • source/ 文件夹
  • themes/ 文件夹
  • 等等

第九步：创建 Personal Access Token（如果需要）

什么时候需要？

如果你的 GitHub 开启了两步验证（强烈建议开启），密码就不能用了，需要用 Token 代替。

操作步骤

  1. 点击右上角头像 → Settings
  2. 左边菜单往下拉，点 Developer settings
  3. 点 Personal access tokens → Tokens (classic)
  4. 点 Generate new token
  5. 填写：
    • Note：随便填，如 hexo-deploy
    • Expiration：选 No expiration（永不过期）或具体日期
    • Select scopes：勾选 repo（完全控制仓库）
  6. 点 Generate token
  7. 重要：页面会显示一串 Token，只能看一次！复制保存好

使用 Token 登录

推送时，密码输入框输入这串 Token（不是你的 GitHub 密码）。

第十步：连接 Cloudflare Pages

操作步骤

  1. 打开 https://dash.cloudflare.com/ → 登录
  2. 左边菜单找到 Workers & Pages
  3. 点 Create application
  4. 选择 Connect to Git
  5. 如果还没连接 GitHub，点 Authorize Cloudflare 授权
  6. 选择刚才创建的仓库 my-blog
  7. 配置构建：
    • Production branch：填 main
    • Build command：留空（Hexo 是本地构建好的）
    • Build output directory：填 public
  8. 点 Save and Deploy

等待部署

页面会显示部署进度，等几分钟。成功后显示类似：

1
2
3
✓ 部署完成
✓ 您的网站已在以下网址可用:
https://xxx.pages.dev

第十一步：绑定自定义域名（可选）

操作步骤

  1. 在 Cloudflare Pages 页面，点你的项目
  2. 点 Custom domains
  3. 输入你的域名，如 blog.ccwu.cc
  4. 点 Add domain
  5. 按照提示在 DNS 设置中添加记录

以后写文章的完整流程

以后每次写新文章，流程变成：

1. 写文章

用 Markdown 写，保存到 source/_posts/ 目录。

2. 本地预览（可选）

1
2
cd ~/my-blog
hexo server

打开浏览器访问 http://localhost:4000 预览。

3. 生成静态文件

1
2
hexo clean
hexo generate

4. 提交并推送

1
2
3
git add .
git commit -m "添加新文章：文章标题"
git push

5. 自动部署

Cloudflare 检测到 GitHub 有新提交，自动开始部署。等待 1-2 分钟，网站就更新了！

常见问题

Q1: 推送时提示权限错误

1
Permission denied (publickey).

解决：配置 SSH Key，或者用 https 方式（上面教程用的是 https）。

Q2: 每次推送都要输入用户名密码？

第一次输入后，Git 会保存凭证。以后不用再输入。

Q3: 推送失败显示 “non-fast-forward”

说明远程仓库有新内容，需要先拉取：

1
git pull origin main --allow-unrelated-histories

然后再推送。

Q4: Cloudflare 部署失败

检查：

  • 仓库是否 Public
  • Build output directory 是否填 public
  • .gitignore 是否忽略了 public 文件夹（不应该忽略，因为 Cloudflare 需要）

Q5: 想在其他电脑继续写文章？

1
2
3
git clone https://github.com/你的用户名/my-blog.git
cd my-blog
npm install

就能同步下来，继续写。

完整命令回顾

1
2
3
4
5
6
7
8
9
10
11
# 第一次设置
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

# 推送文章
cd ~/my-blog
hexo clean
hexo generate
git add .
git commit -m "更新博客"
git push

搞定！以后写文章就是这么简单：写完 → git push → 自动上线！

Windows系统配置 Hermes Agent 史上最详细教程（WSL版）

Windows 系统配置 Hermes Agent 史上最详细教程（WSL版）

为什么要看这篇教程？

Hermes Agent 是一个运行在终端里的 AI 助手，它可以帮你写代码、查资料、操作文件，相当于一个随时待命的程序员助理。

但是 Hermes Agent 是用 Python 写的，只能在 Linux 系统上运行。Windows 系统本身不支持直接运行，所以需要借助 WSL（Windows Subsystem for Linux）来创建一个 Linux 环境。

简单理解：WSL 就像在 Windows 系统里装了一个虚拟机，可以运行 Linux 系统和 Linux 软件。

第一步：启用 WSL

操作步骤

  1. 鼠标右键点击 开始菜单（左下角 Windows 图标）
  2. 选择 Windows PowerShell (管理员) 或 终端 (管理员)
  3. 弹出”用户账户控制”窗口，点 是
  4. 在打开的窗口里输入：
1
wsl --install

按回车后会看到什么？

系统会开始下载并安装 WSL2（新版，性能更好）。屏幕会显示类似这样的内容：

1
2
正在安装...
此操作完成后，需要重新启动系统。

注意：如果看到英文提示 “The operation completed successfully”，说明已经安装过了，跳过这步。

需要重启电脑吗？

需要！ 看到安装完成的提示后，重启你的电脑。不重启的话后续步骤会报错。

第二步：重启后首次启动 Ubuntu

重启后会看到什么？

电脑重启后，会自动弹出一个黑色窗口（Ubuntu 终端），显示：

1
2
3
Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
What do you want to call this new user account?

怎么操作？

  1. 输入一个英文用户名（不能用中文、空格、特殊符号）

    • 例如：alex、john、mike、hermes

  2. 按 回车

  3. 系统会提示输入密码：

    1
    New password:

    输入你选择的密码（输入时不显示字符，是正常的）

  4. 再次输入密码确认：

    1
    Confirm password:

  5. 完成！看到类似这样的内容就成功了：

    1
    2
    3
    4
    5
    6
    Welcome to Ubuntu 22.04.3 LTS (GNU/Linux 5.15.146.0.1-microsoft-standard-WSL2 x86_64)
     * Documentation:  https://help.ubuntu.com/
     * Management:     https://landscape.casual.com/
     * Support:        https://ubuntu.com/advantage

    alex@LAPTOP-ABC123:~$

最后一行的 alex@LAPTOP-ABC123:~$ 叫命令提示符，前面是你的用户名，后面是电脑名，~ 表示当前在主目录。

第三步：更新系统（重要！）

为什么要更新？

新安装的 Ubuntu 系统里很多软件包都是旧版本，可能有安全漏洞或兼容性问题。更新后再安装其他软件会更顺利。

操作步骤

在终端（就是刚才的黑色窗口）里输入：

1
sudo apt update

按回车后会看到什么？

系统会让你输入密码验证身份。输入密码时不会显示任何字符，这是正常的，输入完按回车即可。

输入正确后会开始下载更新列表，屏幕滚动显示类似：

1
2
3
4
Hit:1 https://archive.ubuntu.com/ubuntu jammy InRelease [164 kB]
Hit:2 https://archive.ubuntu.com/ubuntu jammy-updates InRelease [164 kB]
...
Reading package lists... Done

看到 Done 说明更新完成了。

接着输入第二行命令

1
sudo apt upgrade -y

这行命令会真正更新软件包。屏幕会显示：

1
2
3
4
5
Reading state information... Done
XX packages can be upgraded.
The following packages will be upgraded:
  ...
Do you want to continue? [Y/n]

输入 Y 或直接按回车确认。

等待更新完成，大约需要 3-10 分钟，取决于网速。完成后会显示：

1
2
XX packages upgraded, YY packages newly installed, ZZ packages removed.
Setting up...

第四步：安装 Python

为什么要安装 Python？

Hermes Agent 是用 Python 写的，没有 Python 就无法运行。大部分新版 Ubuntu 已经预装了 Python，但最好确认一下。

检查是否已安装

在终端输入：

1
python3 --version

会看到什么？

如果已安装，显示类似：

1
Python 3.10.12

如果显示 command not found，说明没装，继续下一步。

安装 Python

1
sudo apt install python3 python3-pip -y

按回车后等待安装完成，看到 Setting up... 就成功了。

验证安装

再次输入：

1
python3 --version

应该显示版本号了。

第五步：安装 Hermes Agent

操作步骤

在终端输入：

1
pip3 install hermes-agent

按回车后会看到什么？

屏幕会显示正在下载和安装：

1
2
3
4
5
Collecting hermes-agent
  Downloading hermes_agent-1.2.3-py3-none-any.whl (XX kB)
Collecting ...
Installing collected packages: hermes-agent, xxx, xxx
Successfully installed hermes-agent-1.2.3 xxx-1.0.0

看到 Successfully installed 就说明安装成功了！

验证安装

1
hermes --version

应该显示版本号。

第六步：配置 API Key

什么是 API Key？

API Key 就像是一个密码，用于连接 AI 服务。没有有效的 API Key，Hermes Agent 无法连接到 AI 模型，也就无法回答问题。

获取 API Key 的方法：联系你的 AI 服务提供商（如河南移动的 Coding Plan、MiniMax 等），按指引获取。

操作步骤

1. 创建配置目录

1
mkdir -p ~/.hermes

这行命令会在主目录（~）下创建一个名为 .hermes 的文件夹。. 开头表示隐藏文件夹。

2. 创建配置文件

1
nano ~/.hermes/config.yaml

nano 是一个简单的文本编辑器，Windows 上类似记事本。

按回车后会看到什么？

编辑器界面，底部有一行快捷键提示。按键盘向下箭头移动到空白处。

3. 粘贴配置内容

把下面的内容复制粘贴进去（把 你的API密钥 换成你真正的密钥）：

1
2
3
4
5
model:
  default: minimax-m2.5
  provider: custom
  base_url: https://zhenze-huhehaote.cmecloud.cn/api/coding/v1
  api_key: 你的API密钥

注意：把 你的API密钥 那几个字替换成你获取到的真实密钥，不要留中文！

4. 保存并退出

按键盘：

  1. Ctrl + O （保存）
  2. 按 回车 确认文件名
  3. Ctrl + X （退出）

回到命令提示符就对了。

第七步：启动 Hermes Agent

操作步骤

在终端输入：

1
hermes

按回车后会看到什么？

第一次启动可能会：

  1. 显示一些初始化信息
  2. 尝试连接 AI 服务
  3. 连接成功后显示对话界面

类似：

1
2
3
4
5
6
Hermes Agent v1.2.3
Loading configuration...
Connecting to AI service...
Connected! (Model: minimax-m2.5)

You:

看到 You: 就说明成功了！可以在后面输入你的问题。

如果显示错误？

常见错误及解决方法：

错误信息 原因 解决方法
API key is invalid API Key 错误 检查 config.yaml 里的 api_key 是否正确
Connection timed out 网络超时 检查网络，或配置代理（见下文）
command not found 没安装成功 重新运行 pip3 install hermes-agent

第八步：配置代理（如果需要）

为什么要配置代理？

中国大陆直接访问部分 AI 服务可能会被拦截或速度很慢。如果遇到连接问题，需要配置代理。

操作步骤

1
nano ~/.bashrc

在文件最末尾添加一行（按 Ctrl + End 跳到末尾）：

1
export all_proxy="socks5://127.0.0.1:10808"

这里的 127.0.0.1:10808 是代理地址，你需要改成你实际的代理地址。

保存退出（Ctrl + O，回车，Ctrl + X）。

然后让配置生效：

1
source ~/.bashrc

常见问题汇总

Q1: 每次使用都要重新打开 WSL 吗？

是的。关闭终端后 WSL 会停止，下次使用再打开 Ubuntu 即可。

Q2: 怎么打开 WSL/Ubuntu？

方法一：在开始菜单搜索 “Ubuntu”
方法二：打开 PowerShell，输入 wsl 直接进入

Q3: 输入密码时看不到字符正常吗？

正常，为了安全设计的。输入完按回车即可。

Q4: 安装太慢怎么办？

换清华源（步骤见上文”第四步”部分）

Q5: 想卸载 WSL 怎么办？

在 PowerShell 中运行：

1
wsl --unregister Ubuntu

Q6: 可以同时开多个终端吗？

可以，开多少个都行，互不影响。

完整操作流程回顾

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 1. 以管理员打开 PowerShell
wsl --install

# 2. 重启电脑

# 3. 设置用户名密码（首次启动）

# 4. 更新系统
sudo apt update
sudo apt upgrade -y

# 5. 安装 Python（如果需要）
sudo apt install python3 python3-pip -y

# 6. 安装 Hermes Agent
pip3 install hermes-agent

# 7. 配置
mkdir -p ~/.hermes
nano ~/.hermes/config.yaml
# 粘贴配置，保存退出

# 8. 启动
hermes

祝你在 Herme Agent 的世界里玩得开心！有问题随时问我！