Hexo 备忘

我的配置

Hexo 版本: hexo-cli: 4.3.2, hexo: 7.3.0(当前最新)
Node.js 版本: 22.16.0
Git 版本: 2.47.0.sindows.2
PNPM 版本: 10.12.4
Windows 版本: 11

安装 Node.js

在官网安装 LTS 版本，电脑一般来说内存足够直接在 C 盘即可，当然，换路径也可以，我反正正常下载换路径，没什么问题。
安装完成后，检查是否安装成功。在键盘按下 win + R 键，输入 CMD，然后回车，打开 CMD 窗口，执行 node -v 命令，看到版本信息，则说明安装成功。

安装 Git

在官网安装最新版本的 64-bit Git for Windows Setup 安装包。

安装完成后，在命令行输入 git --version，如果显示版本号，则说明安装成功。

常用命令

bash

git config -l  //查看所有配置
git config --system --list //查看系统配置
git config --global --list //查看用户（全局）配置

配置 Git 用户名和邮箱

bash

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

安装包管理器

安装 npm 为一切的基石，一般来说，你安装了 node，也相当于你安装了 npm，通过一下命令来验证：

bash

npm -v
node -v

修改 npm 源。npm 下载各种模块，默认是从国外服务器下载，速度较慢，建议配置成淘宝镜像。打开 CMD 窗口，运行如下命令:

bash

npm config set registry https://registry.npm.taobao.org

安装 pnpm

pnpm 是一个快速、节省磁盘空间的包管理器，类似于 npm 和 yarn。安装 pnpm 可以通过以下命令：

bash

npm install -g pnpm

为什么选择 pnpm？因为它的安装速度快，依赖管理更高效，且相对于 npm，我使用 npm 容易失败且慢，pnpm 给我的体验更好。

Github配置

上述操作是前提，接下来是配置 Github。

创建仓库

登录 GitHub，点击右上角的 + 号，选择 New repository。
填写仓库名称，建议使用 <username>.github.io 格式（例如：yourusername.github.io），这样可以直接作为个人主页。

这里我不准备直接使用常规的 hexo deploy 命令来部署到 GitHub Pages，因为当你的文章一多，生成时间就会繁琐，这里的建议是使用 Github Actions 来自动部署。

这一部分的教程是源于店长的文章，但是有点老旧了，于是我做了点更改（这里的图片来源于安知鱼）：

首先要创建一个放置源码的私有仓库，以下称之为 hexo-source，
然后要生成一个 Github 密钥：

访问 Github-> 头像（右上角）-> Settings-> Developer Settings-> Personal access tokens-> generate new token, 创建的 Token 名称随意，但必须勾选 repo 项和 workflows 项。

点击链接前往生成

提醒

!!! token 只会显示这一次，之后将无法查看，所以务必保证你已经记录下了 Token。之后如果忘记了就只能重新生成重新配置了。

在 hexo-source 仓库中的设置里点击设置 -> action -> General -> 工作流程权限
- 勾选 Read and write permissions，并且勾选 Allow <span style="background:#FF0000;"></span>all actions and reusable workflows。
在设置里 -> Secrets and variables -> Actions -> New repository secret 添加

GITHUBTOKEN：放置你刚才生成的 Token。

上述是前置条件，接下来要先部署 hexo，你才好继续下一步。

初始化 Hexo

在本地新建一个文件夹，例如 hexo-solitude。
这里我是用的是 vscode 打开该文件夹，然后在终端输入以下命令来初始化 Hexo：

bash

hexo init (项目名称)

我一般都不填，直接在文件下下就可以开始，如果你添加了项目名称，那么下一步就是：

bash

cd (项目名称)

安装依赖包：

bash

pnpm install

然后就是选择你想要的主题，这里我使用的是Solitude，具体的配置不细讲，我只讲一部分：

首先就是基本的安装，这里还是选择git clone没有别的原因，主要还是会改点源码，不想改的直接pnpm下载即可：

git

// git安装
git clone -b dev https://github.com/everfu/hexo-theme-solitude.git themes/solitude

// pnpm 安装
pnpm i hexo-theme-solitude

然后在_config.yml里修改成：

yml

theme: solitude

使用该插件之前，需要先安装 cheerio，cheerio 是一个轻量级的库，用于在服务器端快速、灵活地实现 jQuery 核心功能。在 hexo-safego 插件中，cheerio 被用来解析和操作生成的静态 HTML 内容，类似于在浏览器中使用 jQuery 处理 DOM 元素。这使得插件能够在生成静态页面时，处理和替换外部链接，增强博客的安全性，而不需要在客户端引入 jQuery。Hexo 一般都有这个插件，可以在 node_modules 查看，如果没有，请先执行：

bash

pnpm i cheerio --save

然后即可安装该插件：

bash

pnpm i hexo-safego --save

在hexo根目录的_config.yml文件中添加以下配置：

yml

# hexo-safego安全跳转插件
# see https://blog.liushen.fun/posts/1dfd1f41/
hexo_safego:
  # 基本功能设置
  general:
    enable: true                # 启用插件
    enable_base64_encode: true  # 使用 Base64 编码
    enable_target_blank: true   # 打开新窗口
  # 安全设置
  security:
    url_param_name: 'u'         # URL 参数名
    html_file_name: 'go.html'   # 重定向页面的文件名
    ignore_attrs:               # 忽略处理的 HTML 属性
      - 'data-fancybox'
  # 容器与页面设置
  scope:
    apply_containers:           # 应用的容器选择器
      - '#article-container'
    apply_pages:                # 应用的页面路径
      - "/posts/"
      - "/devices/"
    exclude_pages:              # 排除的页面路径
  # 域名白名单
  whitelist:
    domain_whitelist:           # 允许的白名单域名
      - "qyliu.top"
      - "liushen.fun"
  # 页面外观设置
  appearance:
    avatar: /info/avatar.ico    # 头像路径
    title: "清羽飞扬"            # 页面标题
    subtitle: "安全中心"         # 页面副标题
    darkmode: true              # 是否启用深色模式
    countdowntime: -1           # 倒计时秒数
  # 调试设置
  debug:
    enable: false               # 启用调试模式

hexo的追番页面：hexo-bilibili-bangumi

bash

pnpm i hexo-bilibili-bangumi --save

在_config.yml配置：

yml

bangumi: # 追番设置
  enable: true           # 是否启用
  source: bili          # 数据源
  path: bangumis/index.html  # 页面路径
  vmid:                 # 用户ID
  title: '追番列表'      # 页面标题
  quote: '生命不息，追番不止！' # 页面引言
  show: 1              # 初始显示页面: 0=想看, 1=在看, 2=看过
  lazyload: true       # 是否启用图片懒加载
  metaColor:           # meta 信息字体颜色
  color:               # 简介字体颜色
  webp: true          # 是否使用 webp 格式图片
  progress: true      # 是否显示进度条
  ...
cinema: # 追剧设置
  enable: true           # 是否启用
  source: bili
  ...
game: # 游戏设置，仅支持source: bgmv0
  enable: true           # 是否启用
  source: bgmv0
  ...

还在更新中。。。

Github action配置

承接段落的继续吧，未来会在出水一期。

接下来就是创建一个私有仓库，根据大佬的文章，是为了保护Token，见仁见智。

这个私有仓库的建立是存储Hexo博客代码，如果你要使用Qexo

，这也是必不可少的！

创建完成后，需要把博客的源码 push 到这里。首先获取远程仓库地址，此处虽然 SSH 和 HTTPS 均可。SSH 在绑定过 ssh key 的设备上无需再输入密码，HTTPS 则需要输入密码，但是 SSH 偶尔会遇到端口占用的情况。请自主选择。

警告

这里之所以是私有仓库，是因为在接下来的配置中会用到 Token，如果 Token 被盗用，别人可以肆意操作你的 github 仓库内容，为了避免这一风险，才选择的博客源码闭源。

配置 Github Action

在[Blogroot]新建.github文件夹,注意开头是有个.的。然后在.github 内新建 workflows 文件夹，再在 workflows 文件夹内新建 autodeploy.yml,在[Blogroot]/.github/workflows/autodeploy.yml 里面输入

yml

# 当有改动推送到 main 分支时，启动 Action
name: 自动部署

on:
  push:
    branches:
      - main # 自选分支

  release:
    types:
      - published

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: 检查分支
        uses: actions/checkout@v4
        with:
          ref: main # 自选分支

      - name: 安装 Node
        uses: actions/setup-node@v4
        with:
          node-version: "22.x" # node版本

      - name: 安装 Hexo
        run: |
          export TZ='Asia/Shanghai'
          npm install hexo-cli -g
          npm install yamljs --save

      - name: 缓存 Hexo
        uses: actions/cache@v4
        id: cache
        with:
          path: node_modules
          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}

      - name: 安装依赖
        if: steps.cache.outputs.cache-hit != 'true'
        run: |
          npm install --save
          npm install hexo-algoliasearch --save
          npm install hexo-bilibili-bangumi --save

      - name: 生成静态文件
        run: |
          node ./link.js
          hexo clean
          hexo generate
          hexo bangumi -u
          hexo algolia

      - name: 部署
        run: |
          cd ./public
          git init -b main
          git config --global user.name '${{ secrets.GITHUBUSERNAME }}'
          git config --global user.email '${{ secrets.GITHUBEMAIL }}'
          git add .
          git commit -m "${{ github.event.head_commit.message }} $(date +"%Z %Y-%m-%d %A %H:%M:%S") Updated by GitHub Actions"
          git push --force --quiet "https://${{ secrets.GITHUBUSERNAME }}:${{ secrets.GITHUBTOKEN }}@github.com/${{ secrets.GITHUBUSERNAME }}/${{ secrets.GITHUBUSERNAME }}.github.io.git" main

上述代码是来自店长的修改自用，为什么不用安知鱼的？

首先把Token直接放在仓库的文件里还是不太好。
像我这种在本地搞的，推不到仓库里，因为这里的token不能直接上传，我尝试过把token: 改成token: ${{ servets.GH_token }}，但是依旧有各种问题，相反使用了店长的代码后，就大差不差，询问AI后就得到目前的代码，也就可以正式上传了。（无拉踩的意思）
之后需要自己到仓库的 Settings->Secrets->actions 下添加环境变量，变量名参考脚本中出现的，依次添加。

重新设置远程仓库和分支

删除或者先把[Blogroot]/themes/solitude/.git移动到非博客文件夹目录下,原因是主题文件夹下的.git文件夹的存在会导致其被识别成子项目，从而无法被上传到源码仓库。
在博客根目录[Blogroot]路径下运行指令:

bash

git init #初始化
git remote add origin git@github.com:[GithubUsername]/[SourceRepo].git #[SourceRepo]为存放源码的github私有仓库
git checkout -b master # 切换到master分支，
#2020年10月后github新建仓库默认分支改为main，注意更改
# 如果不是，后面的所有设置的分支记得保持一致

添加屏蔽项

bash

.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/
.deploy_git*/
.idea
themes/solitude/.git

如果不是solitude主题，记得替换最后一行内容为你自己当前使用的主题。 4. 之后再运行 git 提交指令，将博客源码提交到 github 上。

bash

git add .
git commit -m "github action update"
git push origin master
#2020年10月后github新建仓库默认分支改为main，注意更改

此时你的主题文件夹若已经被正常上传，并且你也添加了主题文件夹下的.git 文件夹的屏蔽项。那你可以考虑把第二步移走或删除的.git放回来，用作以后升级。（不禁怀疑真的有人会去用这个方式来升级吗）

挖坑

大致写到这，未来或许会有~~下一章~~挖坑？但是目前通用的就到这，然后后续会写Qexo的简单使用方法、solitude的一些配置更改和我踩坑经历吧。

Hexo-备忘

Hexo 备忘

我的配置

安装 Node.js

安装 Git

常用命令

配置 Git 用户名和邮箱

安装包管理器

安装 pnpm

安装 Hexo

Github配置

创建仓库

上述是前置条件，接下来要先部署 hexo，你才好继续下一步。

初始化 Hexo

配置

插件

Github action配置

配置 Github Action

重新设置远程仓库和分支

挖坑

评论区