HEXO搭建静态网站

搭建准备

  1. GitHub账号,需要注册一个账号(必须
  2. Cloudflare Dashboard | Manage Your Account,需要注册一个账号
  3. 准备一个域名

软件下载/安装

  1. Git
  2. Node.js — Run JavaScript Everywhere
  3. 代码编辑:1. Visual Studio Code - Code Editing. Redefined、2.Notepad++

Git安装

软件下载完成–>一直点默认进行安装,(根据自己电脑情况,选择安装位置

安装完成开始菜单可以查看到如下三个程序:Git CMDGit BashGit GUI

  • Git CMD 是windows 命令行的指令风格
  • Git GUI是图形化界面
  • Git Bash 是linux系统的指令风格(常用

Node安装

软件下载完成–>一直点默认进行安装,(根据自己电脑情况,选择安装位置

cmd命令测试是否安装完成,命令执行之后,出现相关的版本信息说明安装成功了。

1
node -v

修改npm源,配置成华为云镜像源,加速下载。

1
npm config set registry https://mirrors.huaweicloud.com/repository/npm/

配置Git ssh密钥并连接Github

打开 Git Bash 程序,输入如下命令

1
2
git config --global user.name "github的用户名"  
git config --global user.email "github的注册邮箱"

检查是否配置成功

1
git config -l

命令如下显示,说明配置成功了

1
2
3
.....
user.name="github的用户名"
user.email="github的注册邮箱"

生成ssh的公/私钥

输入命令,一直点回车(也是可以设置密码

1
ssh-keygen -t rsa -C "github的注册邮箱"

密钥生成的位置:C:\Users\用户名\.ssh\

  • id_rsa私钥
  • id_rsa.pub公钥

连接github

  1. id_rsa.pub公钥的文件内容复制一下。
  2. 访问github网站,点击右上角头像–>设置(settings)–>在左侧边, SSH and GPG keys –>在SSH keys选项中,点击NEW SSH KEY按钮
  3. Title的内容自定义–>在 Key 的输入框中,粘贴复制的公钥文件内容 –>最后点击 ADD SSH KEY 的按钮。

连接测试

1
ssh -T git@github.com

第一次连接,会出现Are you sure you want to continue connecting (yes/no/[fingerprint])?的提示,输入yes就可以了。
如果,你设置了密码还会在有Enter passphrase for key '/c/Users/用户名/.ssh/id_rsa':的提示,输入你设置的密码即可。

创建GitHub.io仓库

项目命名要求<用户名>.github.io

Git BASH输入如下命令安装 Hexo

1
npm install -g hexo-cli && hexo -v

验证是否安装成功。

1
hexo -v

初始化

1
2
3
hexo init skills-demo
cd skills-demo
npm i

文件描述:

  • node_modules:依赖包
  • scaffolds:生成文章的一些模板
  • themes:主题
  • source:用来存放你的文章
  • .npmignore:发布时忽略的文件(可忽略)
  • _config.landscape.yml:主题的配置文件
  • _config.yml:博客的配置文件
  • package.json:项目名称、描述、版本、运行和开发等信

启动项目

1
hexo cl && hexo s

静态博客挂载到 GitHub Pages

安装 hexo-deployer-git

1
npm install hexo-deployer-git --save

修改 _config.yml 文件
修改最后一行的配置,将repository修改为你自己的github项目地址即可,还有分支要改为main代表主分支(注意缩进)。

1
2
3
4
deploy:  
type: git
repository: git@github.com:skilladd-demo/skilladd-demo.github.io.git
branch: main
1
2
3
4
hexo clean && hexo generate && hexo deploy    


hexo cl; hexo g; hexo d
  • hexo clean:删除之前生成的文件,可以用hexo cl缩写。
  • hexo generate:生成静态文章,可以用hexo g缩写
  • hexo deploy:部署文章,可以用hexo d缩写

如果出现Deploy done,则说明部署成功了。

静态博客挂载到 Cloudflare Pages

在 Workers 和 Pages 中选择 Pages 的 连接到 Git

  1. 点击连接github的按钮,然后登录你仓库对应的GitHub帐号
  2. 点击install & Authorize
  3. 选择你要存储的库,<用户名>.github.io
  4. 点击开始设置
  5. 点击保存并部署后,等待项目部署完成即可。

将仓库设置私用

返回刚才部署的github仓库

  1. 点击设置settings)
  2. 往下拉,找到Danger Zone,点击 Change visibility
  3. 点击 Change to private,弹出的窗体,一直点击即可设置仓库私用

hexo如何使用

可以查看文档 | Hexo官网
语法:

1
hexo new [layout] <title>
1
hexo new 测试

运行

1
hexo cl; hexo s

上传到github项目

1
hexo cl; hexo g; hexo d

参考文档

Hexo
GitHub - hexojs/hexo: A fast, simple & powerful blog framework, powered by Node.js.


HEXO搭建静态网站
https://skilladd.org/2025/04/03/2.hexo网站搭建/
Author
skilladd
Posted on
April 3, 2025
Licensed under