629 字
3 分钟
零基础部署属于自己的博客以及管理系统

准备工作#

安装必备程序#

TIP

Node.js 版本需不低于 10.13,建议使用 Node.js 12.0 及以上版本

安装 Git#

Windows系统#

打开 Git官网,点击 Install for Windows

Mac系统#

使用 Homebrew, MacPorts 或者下载 安装程序

Linux系统#

Terminal window
# Debian/Ubuntu
sudo apt-get install git-core
# RedHat/CentOS
sudo yum install git-core

安装 Node.js#

进入 Node.js官网,选择相应版本安装即可

Windows

使用 Node.js 官方安装程序时,请确保勾选 Add to PATH 选项(默认已勾选)

Mac / Linux

如果在尝试安装 Hexo 的过程中出现 EACCES 权限错误,请遵循 由 npmjs 发布的指导 修复该问题。

Linux

如果您使用 Snap 来安装 Node.js,在 初始化 博客时您可能需要手动在目标文件夹中执行 npm install

安装 Hexo#

官方提供了两种方法,一种是全局安装 hexo-cli,一种是局部安装 hexo

由于这篇文章面向新手,所以我们全局安装 hexo-cli

按住 Win + X,运行终端,输入:

Terminal window
npm install -g hexo-cli

初始化#

在文件夹中按住 Shift + 右键,点击 在终端中打开,输入:

Terminal window
hexo init <folder>
cd <folder>
npm install

说明#

配置站点#

_config.yml 中可以自定义站点信息

具体配置可以参考 Hexo配置说明

Hexo命令#

除了我们上述的 hexo init <folder> 之外,还有其他命令

更多命令可以参考 Hexo命令

主题#

打开 Hexo主题,寻找一个你喜欢的主题

然后打开其仓库或者示例网站,寻找部署教程

TIP

一般来说,你只需要将此仓库内容保存到本地,然后放置到 themes/<your-theme> 的文件夹下即可

插件#

打开 Hexo插件,寻找你需要的插件并按照指示安装即可

部署#

一键部署【官方】#

我们需要为我们的项目安装 hexo-deployer-git

Terminal window
npm install hexo-deployer-git --save

然后在 _config.yml 中找到 deploy,修改为:

deploy:
type: git
repo: <repository url> # https://github.com/xxx/xxx.git
branch: [branch] # gh-pages / main
message: [message] # 提交信息

配置完成后,我们运行:

Terminal window
hexo clean && hexo deploy

即可提交到仓库,然后部署到Github Pages即可

使用 Cloudflare Pages 【推荐】#

Cloudflare Pages的免费套餐提供了无限流量,并且还可以享受全球CDN网络,让您的站点在全球访问的速度都畅快无比

我们需要先将代码提交到Github仓库,然后再从Cloudflare Pages中选择仓库,配置:

  • 框架预设:
  • 构建命令: hexo generate
  • 构建输出目录: public

然后等待部署完毕即可

零基础部署属于自己的博客以及管理系统
https://blog.stoeaves.com/posts/hexo-blog-deployment/
作者
StoneLeaves
发布于
2026-06-12
许可协议
CC BY-NC-SA 4.0
评论加载中...