769 字
4 分钟
博客搭建: 使用Hexo框架搭建博客并托管至Github Pages

本教程适用于 Linux 用户 Windows和Mac用户安装可参考 Hexo官方文档

本教程参考内容 crystal的帖子

环境配置#

Tips: 如果你发现安装速度太慢或无法安装 请切换网络

  1. 安装Git

如果你是 Ubuntu 或者 Debian 发行版 在终端设备中输入以下内容

Terminal window
sudo apt-get install git-core

如果你是 CentOS 发行版 在终端设备中输入以下内容

Terminal window
sudo yum install git-core
  1. 安装Node.js

首先在终端输入以下内容 安装nvm

Terminal window
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

接着你可以选择重启终端或加载nvm

Terminal window
\. "$HOME/.nvm/nvm.sh"

然后用 nvm 命令安装 Node.js 这里安装的是LTS 你也可以换成其它版本

Terminal window
nvm install --lts

最后验证是否安装成功 如果输出你安装的版本号即为成功

Terminal window
npm --v

安装Hexo#

输入以下内容安装Hexo

Terminal window
npm install -g hexo-cli

然后新建一个文件夹 并切换到这个文件夹目录

输入以下内容完成 Hexo 初始化

Terminal window
hexo init
npm install

此时你会发现你创建的文件夹内多了许多文件 代表你成功了

让我们来预览一下

输入以下内容开启本地预览

Terminal window
hexo cl
hexo g
hexo s

浏览器访问 http://localhost:4000 进行本地预览

最后 Ctrl+C 关闭本地服务

托管至Github Pages#

登录 Github 账号 创建一个新仓库 仓库名称为你的用户名.github.io

打开终端 输入以下内容

Terminal window
git config --global user.name "你GitHub的用户名"
git config --global user.email "你注册GitHub的邮箱"

接着创建公钥

Terminal window
ssh-keygen -t rsa -C "你注册GitHub的邮箱"

然后一路回车 不要设置密码 否则后续更新代码会频繁让你输入密码

打开你 home 文件夹下的 .ssh 文件夹 找到 id_rsa.pub 文件并复制里面的内容

回到Github 点击你的头像 打开 Settings 页面 找到SSH and GPG keys 点击New SSH key

名称随便起一个你喜欢的 key内容粘贴你复制的公钥

点击 Add SSH key 保存

接着回到终端输入以下内容连接Github

Terminal window
ssh -T git@github.com

输入yes 弹出 Hi xxx! … 就成功了

回到终端 输入以下内容 安装 Hexo 插件

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

然后到你创建的文件夹目录下找到 _config.yml 在末尾处修改 deploy

deploy:
type: git
repository: git@github.com:用户名/用户名.github.io.git
branch: main

接着在终端输入

Terminal window
hexo d

现在你可以通过访问 https://用户名.github.io 来访问你的博客了

绑定域名(可选)#

在你的域名解析商里设置CNAME解析到 用户名.github.io 或添加A记录为

185.199.109.153
185.199.110.153
185.199.111.153
185.199.108.153

找到你创建的 Github 仓库 点击齿轮打开仓库设置(不是点击你的头像的那个设置) 找到Pages 在 Custom domain 里输入你的域名

最后在你博客文件夹下的 source 文件夹里添加一个 CNAME 文件 里面输入你的域名

到此你完成了搭建博客并托管至Github Pages 感谢观看

博客搭建: 使用Hexo框架搭建博客并托管至Github Pages
https://blog.goshujin.top/posts/hexo/
作者
垂叶叶叶
发布于
2025-08-09
许可协议
CC BY-NC-SA 4.0

部分信息可能已经过时