第四章 Hexo + GitHub Pages 从零配置自动部署（SSH 版）

Penry2025-04-112025-04-11

💻 Hexo + GitHub Pages 从零配置自动部署（SSH 版）

本文将手把手带你完成：创建 GitHub 仓库 → 初始化 Git → 配置 SSH 密钥 → 安装 Hexo → 配置 SSH 自动部署。适合初学者！

🧰 一、前置条件

在开始之前，请确保你已具备以下环境：

工具	说明
Node.js	建议使用 LTS 版本，可前往 https://nodejs.org 下载
Git	用于版本控制和推送代码，可前往 https://git-scm.com 下载
GitHub 账号	作为 Hexo 博客托管平台
VS Code 或终端	作为操作工具

🏗️ 二、创建 GitHub 博客仓库

2.1 登录 GitHub，创建新仓库

前往 https://github.com 新建仓库
仓库名建议为 你的用户名.github.io，如 penry.github.io
设为公开仓库（Public）
其余设置保持默认即可

✅ 此仓库将作为你博客的最终访问地址，例如：https://penry.github.io

🌱 三、初始化本地 Git 仓库

3.1 创建博客目录

1	mkdir myblog && cd myblog

3.2 初始化 Git

git init

你会看到生成了 .git 文件夹。

🔐 四、配置 SSH 密钥（用于免密推送）

4.1 生成 SSH 密钥

1	ssh-keygen -t ed25519 -C "你的GitHub邮箱"

按提示一路回车，默认生成位置为 ~/.ssh/id_ed25519

4.2 添加公钥到 GitHub

执行命令查看公钥：
1
cat ~/.ssh/id_ed25519.pub
复制全部内容后，登录 GitHub → Settings → SSH and GPG keys → New SSH Key
粘贴后保存，Title 随便取名，如“Hexo部署密钥”

4.3 测试是否成功

1	ssh -T [email protected]

成功会提示：

1	Hi username! You've successfully authenticated...

⚙️ 五、安装 Hexo 博客

5.1 安装 Hexo CLI

1	npm install -g hexo-cli

5.2 初始化博客项目

1 2	hexo init . npm install

执行后会生成基本目录结构：

.
├── _config.yml
├── scaffolds
├── source
├── themes
└── package.json

🚀 六、配置 GitHub Pages 自动部署

6.1 安装部署插件

1	npm install hexo-deployer-git --save

6.2 修改根目录 `_config.yml` 末尾添加：

deploy:
  type: git
  repo: [email protected]:你的用户名/你的用户名.github.io.git
  branch: main

⚠️ 注意事项：

一定使用 SSH 地址（以 [email protected]: 开头）
branch 根据你仓库默认分支设置，通常为 main，也可能是 master

✏️ 七、写一篇测试博文

1	hexo new "Hello Hexo"

文章会出现在 source/_posts/Hello-Hexo.md，你可以写点内容测试一下。

📦 八、生成 & 部署博客

8.1 生成静态文件

1	hexo clean && hexo generate

8.2 部署到 GitHub

1	hexo deploy

如果 SSH 配置正确，将自动推送到你的 GitHub 仓库。

🌐 九、访问你的博客

打开浏览器，输入地址：

1	https://你的用户名.github.io

🎉 你的博客已经成功上线！

🧩 十、遇到问题怎么办？

问题	原因 & 解决方法
Permission denied	检查 repo 使用了 HTTPS，改为 SSH
无法部署，提示 `not found deployer`	没有安装 `hexo-deployer-git`，请重新安装
每次都要输入密钥密码	可配置 `ssh-agent` 缓存密码或使用无密码密钥

💡 十一、小技巧：添加快捷别名

如果你每次都要输入三条命令，可以设置一个 shell 别名：

1	alias deploy="hexo clean && hexo g && hexo d"

在终端输入 deploy 即可一键部署。

🎯 十二、总结

本文带你完整体验了从零开始配置 Hexo 博客，并通过 SSH 自动部署到 GitHub Pages 的全过程，回顾一下：

✅ 创建 GitHub 仓库
✅ 初始化 Git 仓库
✅ 配置 SSH 密钥
✅ 安装 Hexo
✅ 写博客 → 生成 → 自动部署

如果你觉得有用，欢迎分享本文，或来我的博客逛逛！

✍️ 博主：Penry
🌍 地址：https://penry.asia