记一次Hexo建站过程

最近白嫖了cloudflare的warp服务，发现cloudflare真是太良心，一发不可收拾，顺便在cloudflare注册了genparticle.com，好处是有免费的SSL、防攻击、还能使用免费的cloudflare pages，下面基于Hexo记录一下建站过程。首先需要有cloudflare账号、GitHub账号，安装git、nodejs，这里就不必多说。

配置Hexo

windows安装Hexo-cli：

1	npm install hexo-cli -g

然后创建博客根目录(比如myblog)并进入根目录：

1	cd c:\website\myblog\

在myblog目录初始化hexo：

hexo init

安装主题，这里以Volantis为例子；
进入myblog/themes然后git clone：

1 2	cd themes git clone https://github.com/volantis-x/hexo-theme-volantis.git volantis

安装依赖：

1 2	npm install npm install volantis-static hexo-wordcount

配置Volantis:
修改myblog里面的_congfig.yml，”theme: landscape” $\rightarrow$ “theme: volantis.yml”
另外我在cloudflare pages构建的时候提示不能clone submodels，因此还需要在myblog目录下创建”.gitmodules”，配置如下：

1
2
3

[submodule "themes/volantis"]
    path = themes/volantis
    url = https://github.com/volantis-x/hexo-theme-volantis.git

本地编辑.md文章

然后就可以写文章了，文章一般是markdown格式在myblog\source_posts文件夹下：

1	hexo new "Hello world" # 生成文章"Hello world"

然后利用vs code编辑。
文章：

---
title: 我的第一篇文章
date: 2025-03-12 00:37:31
tags:
  - 教程
  - 建站
category:
  - 建站
plugins:
  - mathjax # 数学公式
  - katex
  - indent # 首行缩进
---

# 第一篇博客测试
## test测试
测试,
测试,test

公式测试:
$$P(k,\mu) = \sum_{\ell = 0,2,4}P_\ell(k){\cal L}(\mu)\frac{2\ell+1}{2}$$

注意这里的tags、category基于Hexo，plugins基于Volantis主题，mathjax和katex支持部分latex公式，使用之前需要初始化一下：

1 2	hexo new page tags hexo new page category

执行完这两个命令后会在myblog\source下生成两个文件tags\index.md和category、index.md，可以通过修改这两个index.md配置显示效果。下面是volantis官方建议配置：
tags\index.md

---
layout: tag
index: true
title: tags
date: 2025-03-11 23:43:36
---

category\index.md

---
layout: category
index: true
title: category
date: 2025-03-12 22:59:37
---

二者显示效果如下：

然后运行hexo命令：

1
2
3

hexo cl     # 等同 hexo clean，清理缓存
hexo g      # 等同 hexo generate，生成html静态文章
hexl s      # 等同 hexo server，启动本地服务器，预览网页

在Windows命令行里可以写为一条命令：

1	hexo cl; hexo g; hexo s

配置Github

如果是第一次配置github：

1
2
3

git config --global user.name "name"   # GitHub名字
git config --global user.emai "email"  # GitHub邮箱
ssh-keygen -t rsa -b 4096 -C "email"   # Github密

将rsa证书添加到ssh服务器，修改c:/User/用户名/.ssh/config

Host github.com
    HostName ssh.github.com        # GitHub 的 SSH 服务器地址
    User git                       # 用户名（固定为 git）
    IdentityFile ~/.ssh/gitHub_rsa # 指定私钥路径（替换为你的密钥文件）
    Port 443                       # 使用 443 端口（绕过 22 端口限制）

将rsa公钥(一般.pub结尾)添加到GitHub：
在网页GitHub：”Setting” $\rightarrow$ “SSH and GPG keys” $\rightarrow$ “SSH keys” $\rightarrow$ “New SSH key”，记事本打开rsa公钥，把内容复制进去；
链接GitHub服务器：

1	ssh git@github.com

myblog关联到Github

登录GitHub账户，创建名称为myblog的私有库，不要勾选”Add a README file”。
接着在电脑myblog目录下：

git init    # 初始化
git add .   # 添加更改
git commit -m "Initial myblog"  # 添加更改日志
git remote add origin https://github.com/username/myblog.git # 本地仓库与远程关联
git push -u origin main # 推送更新

后面更新文章只需要执行：

1
2
3

git add .
git commit -m "update"
git push -u origin main

网页布置到cloudflare pages：

找到cloudflare的”Worker和Pages”，点击”创建”，

然后一定选择”Pages”，不要错选成”Worker”，再点击”连接到Git”，

接着登录Github授权即可，选择你的myblog库，

进入”设置与部署”页面，”生产分支”选择你的分支，”模型预设” $\rightarrow$ “Next.js”，”构建命令” $\rightarrow$ “npm install -g hexo; hexo clean; hexo generate”，”构建输出目录” $\rightarrow$ “public”，然后部署即可。

部署完成后可以绑定自己的域名就可以访问了。