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 盘即可，当然，换路径也可以，我反正正常下载换路径，没什么问题。
安装完成后，检查是否安装成功。在键盘按下 <kbd> win </kbd> + <kbd> R </kbd> 键，输入 CMD，然后回车，打开 CMD 窗口，执行 node -v 命令，看到版本信息，则说明安装成功。

安装 Git#

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

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

常用命令#

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

配置 Git 用户名和邮箱#

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

安装包管理器#

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

1
npm -v
2
node -v

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

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

安装 pnpm#

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

1
npm install -g pnpm

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

安装 Hexo#

在 Git BASH 输入如下命令安装 Hexo：

1
pnpm install -g hexo-cli

安装完后输入 hexo -v 验证是否安装成功。

`<a id="github-config"></a>`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 项。

点击链接前往生成

note

!!! 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：

1
hexo init (项目名称)

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

1
cd (项目名称)

安装依赖包：

1
pnpm install

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

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

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

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

然后在 _config.yml里修改成：

1
theme: solitude

配置#

下列代码是我的备忘：

1
# Hexo Configuration
2
## Docs: https://hexo.io/docs/configuration.html
3
## Source: https://github.com/hexojs/hexo/
4

5
# Site
6
title: 喵落阁
7
subtitle: '克喵的博客'
8
description: '愿你看清一切真相后，依旧热爱你的家人和朋友。'
9
keywords: 克喵,kemiao,博客
10
author: 克喵爱吃卤面
11
language: zh-CN
12
timezone: 'Asia/Shanghai'
13

14
# URL
15
## Set your site url here. For example, if you use GitHub Page, set url as 'https://username.github.io/project'
16
url: # 填网站地址
17
permalink: posts/:abbrlink.html
18
permalink_defaults:
19
pretty_urls:
20
  trailing_index: true # Set to false to remove trailing 'index.html' from permalinks
21
  trailing_html: true # Set to false to remove trailing '.html' from permalinks
22

23
# Directory
24
source_dir: source
25
public_dir: public
26
tag_dir: tags
27
archive_dir: archives
28
category_dir: categories
29
code_dir: downloads/code
30
i18n_dir: :lang
31
skip_render:
32

33
# Writing
34
new_post_name: :title.md # File name of new posts
35
default_layout: post
36
titlecase: false # Transform title into titlecase
37
external_link:
38
  enable: true # Open external links in new tab
39
  field: site # Apply to the whole site
40
  exclude: ''
41
filename_case: 0
42
render_drafts: false
43
post_asset_folder: false
44
relative_link: false
45
future: true
46
syntax_highlighter: highlight.js
47
highlight:
48
  line_number: false
49
  auto_detect: false
50
  tab_replace: ''
51
  wrap: true
52
  hljs: false
53
prismjs:
54
  preprocess: true
55
  line_number: true
56
  tab_replace: ''
57

58
# Home page setting
59
# path: Root path for your blogs index page. (default = '')
60
# per_page: Posts displayed per page. (0 = disable pagination)
61
# order_by: Posts order. (Order by date descending by default)
62
index_generator:
63
  path: ''
64
  per_page: 10
65
  order_by: -date
66

67
# Category & Tag
68
default_category: uncategorized
69
category_map:
70
tag_map:
71

72
# Metadata elements
73
## https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta
74
meta_generator: true
75

76
# Date / Time format
77
## Hexo uses Moment.js to parse and display date
78
## You can customize the date format as defined in
79
## http://momentjs.com/docs/#/displaying/format/
80
date_format: YYYY-MM-DD
81
time_format: HH:mm:ss
82
## updated_option supports 'mtime', 'date', 'empty'
83
updated_option: 'mtime'
84

85
# Pagination
86
## Set per_page to 0 to disable pagination
87
per_page: 10
88
pagination_dir: page
89

90
# Include / Exclude file(s)
91
## include:/exclude: options only apply to the 'source/' folder
92
include: []
93
exclude: []
94
ignore: []
95

96
# Extensions
97
## Plugins: https://hexo.io/plugins/
98
## Themes: https://hexo.io/themes/
99
theme: solitude
100

101
# Deployment
102
## Docs: https://hexo.io/docs/one-command-deployment
103
deploy:
104
  type: git
105
  repo: git@github.com-xx:kemiaofxjun/kemiaofxjun.github.io.git
106
  branch: main
107

108
# RSS Feed 配置
109
feed:
110
  type: atom # 生成 atom.xml
111
  path: atom.xml # 输出文件名
112
  limit: 20 # 最多显示文章数 (0=全部)
113
  hub: # PubSubHubbub 中心 (可选)
114
  content: true # 是否包含全文内容 (true=是, false=仅摘要)
115
  content_limit: 140 # 摘要长度（当 content=false 时生效）
116
  content_limit_delim: ' ' # 截断分隔符
117
  order_by: -date # 按日期倒序排列
118
  autodiscovery: true # 在 HTML 头部添加自动发现标签
119

120
# 数学公式渲染配置
121
markdown:
122
  preset: 'default' # 使用的 MD 语法，默认使用的 GFM
123
  render:
124
    html: true # 渲染 html
125
    xhtmlOut: false
126
    langPrefix: 'language-' # 在代码块的类名中添加前缀（指定语言时）。
127
    breaks: true
128
    linkify: true # 如果你写了一个链接而不是 [name](link) 方式，会自动识别为链接并渲染。
129
    typographer: true # 将替换常见的印刷元素。
130
    quotes: '“”‘’' # 替换文章张的 "" '' 号
131
  enable_rules:
132
  disable_rules:
133
  plugins: # 使用插件
134
  anchors:
135
    level: 2 # 渲染标题的级别（h1,h2,h3）
136
    collisionSuffix: ''
137
    permalink: true
138
    permalinkClass: 'headerlink'
139
    permalinkSide: 'left'
140
    permalinkSymbol: ''
141
    case: 0
142
    separator: '-'
143
  images: # 图片的一些编译
144
    lazyload: true # 是否需要渲染 lazyload
145
    prepend_root: false
146
    post_asset: false
147
  inline: false
148

149
swpp:
150
  # 是否启用插件
151
  enable: true
152
  # 是否在发布前自动执行脚本
153
  auto_exec: true
154
  gen_dom: true
155

156
# 文章链接转数字或字母：https://github.com/rozbo/hexo-abbrlink
157
abbrlink:
158
  alg: crc16 #算法： crc16(default) and crc32
159
  rep: hex #进制： dec(default) and hex: dec #输出进制：十进制和十六进制，默认为10进制。丨dec为十进制，hex
160

161
# https://github.com/hexojs/hexo-generator-sitemap
162
sitemap:
163
  path: sitemap.xml
164
  rel: false
165
  tags: true
166
  categories: true
167

168
algolia:
169
  appId: ''
170
  apiKey: ''
171
  adminApiKey: ''
172
  chunkSize: 5000
173
  indexName: 'index-name'
174
  fields:
175
    - content:strip:truncate,0,500
176
    - excerpt:strip
177
    - gallery
178
    - permalink
179
    - photos
180
    - slug
181
    - tags
182
    - title
183

184
# hexo-safego安全跳转插件
185
# see https://blog.liushen.fun/posts/1dfd1f41/
186
hexo_safego:
187
  # 基本功能设置
188
  general:
189
    enable: true # 启用插件
190
    enable_base64_encode: true # 使用 Base64 编码
191
    enable_target_blank: true # 从新窗口打开跳转页面
192

193
  # 安全设置
194
  security:
195
    url_param_name: 'u' # URL 参数名
196
    html_file_name: 'go.html' # 重定向页面的文件名
197
    ignore_attrs: # 忽略处理的 HTML 结构
198
      - 'data-fancybox'
199

200
  # 容器与页面设置
201
  scope:
202
    apply_containers: # 应用的容器选择器
203
      - '#article-container'
204
    apply_pages: # 应用的页面路径
205
      - '/posts/'
206
      - '/devices/'
207
    exclude_pages: # 排除的页面路径
208

209
  # 域名白名单
210
  whitelist:
211
    domain_whitelist: # 允许的白名单域名，通过字符串匹配实现
212
      - 'kemeow.top'
213
      - 'kemiaosw.top'
214
      - '050815.xyz'
215
      - '314926.xyz'
216
      - '051531.xyz'
217

218
  # 页面外观设置
219
  appearance:
220
    avatar: https://img.314926.xyz/images/2025/08/13/no-background-kemiaofxjun.webp # 跳转页面头像路径
221
    title: '喵洛阁' # 跳转页面标题
222
    subtitle: '安全中心' # 跳转页面副标题
223
    darkmode: auto # 是否启用深色模式
224
    countdowntime: 4 # 跳转页面倒计时秒数，如果设置为负数则为不自动跳转
225

226
  # 调试设置
227
  debug:
228
    enable: false # 启用调试模式
229

230
# 追番插件
231
# https://github.com/HCLonely/hexo-bilibili-bangumi
232
bangumi: # 追番设置
233
  enable: true
234
  source: bili
235
  path:
236
  vmid: 3546643173477234
237
  title: '追番列表'
238
  quote: '生命不息，追番不止！'
239
  show: 1
240
  lazyload: false
241
  loading:
242
  showMyComment: true
243
  pagination: false
244
  extra_options:
245
    top_img: false
246
    lazyload:
247
      enable: false

博客的其他修改基本就是来自教程和一些博主的网站。

插件#

基础依赖 hexo-renderer-pug

1
pnpm i hexo-renderer-pug

字数统计 hexo-wordcount

1
pnpm i hexo-wordcount

配置里修改：

1
# --------------------------- start ---------------------------
2
# Word count
3
# 字数统计
4
# warning: Please install the hexo-wordcount plugin first.
5
# 警告: 请先安装 hexo-wordcount 插件。
6
wordcount: false
7
# --------------------------- end ---------------------------

数学公式 卸载 hexo-render-marked

1
npm un hexo-renderer-marked

安装 hexo-renderer-markdown-it katex @renbaoshuo/markdown-it-katex

1
pnpm i hexo-renderer-markdown-it katex @renbaoshuo/markdown-it-katex

配置里修改

1
# --------------------------- start ---------------------------
2
# Katex
3
# Latex formula support
4
# Latex 公式支持
5
katex:
6
  enable: false
7
  # Whether to load on each page
8
  # 是否在每个页面加载
9
  per_page: false
10
  # Whether to enable copy formula
11
  # 是否启用复制公式
12
  copytex: false
13
# --------------------------- end ---------------------------

添加以下内容到 _config.yml

1
markdown:
2
  preset: 'default'
3
  render:
4
    html: true
5
    xhtmlOut: false
6
    langPrefix: 'language-'
7
    breaks: true
8
    linkify: true
9
    typographer: true
10
    quotes: '“”‘’'
11
  enable_rules:
12
  disable_rules:
13
  plugins:
14
    - '@renbaoshuo/markdown-it-katex'
15
  anchors:
16
    level: 2
17
    collisionSuffix: ''
18
    permalink: false
19
    permalinkClass: 'header-anchor'
20
    permalinkSide: 'left'
21
    permalinkSymbol: '¶'
22
    case: 0
23
    separator: '-'
24
  images:
25
    lazyload: false
26
    prepend_root: false
27
    post_asset: false
28
  inline: false # https://markdown-it.github.io/markdown-it/#MarkdownIt.renderInline

开启配置项

1
# --------------------------- start ---------------------------
2
# Katex
3
# Latex formula support
4
# Latex 公式支持
5
katex:
6
  enable: true
7
  # Whether to load on each page
8
  # 是否在每个页面加载
9
  per_page: true
10
  # Whether to enable copy formula
11
  # 是否启用复制公式
12
  copytex: false
13
# --------------------------- end ---------------------------

PWA 安装 hexo-swpp 和 swpp-backends 插件

在博客根目录执行

1
pnpm i hexo-swpp
2

3
pnpm i swpp-backends

开启配置

1
# 大约在773行
2
# --------------------------- start ---------------------------
3
# PWA
4
# Progressive Web App
5
pwa:
6
  enable: true
7
  manifest: /manifest.json # manifest.json
8
  theme_color: '#006a73' # Theme color
9
  mask_icon: /img/pwa/favicon.png # Mask icon
10
  apple_touch_icon: /img/pwa/favicon.png # Apple touch icon
11
  bookmark_icon: /img/pwa/favicon.png # Bookmark icon
12
  favicon_32_32: /img/pwa/favicon_32.png # 32x32 icon
13
  favicon_16_16: /img/pwa/favicon_16.png # 16x16 icon
14
# --------------------------- end ---------------------------

在 _config.yml里添加swpp配置

1
swpp:
2
  # 是否启用插件
3
  enable: true
4
  # 是否在发布前自动执行脚本
5
  auto_exec: true
6
  gen_dom: true

在 source 目录中创建 manifest.json 文件

1
{
2
  "name": "网站名称",
3
  "short_name": "网站名称缩写",
4
  "theme_color": "#006a73",
5
  "background_color": "#006a73",
6
  "display": "fullscreen",
7
  "scope": "/",
8
  "start_url": "/",
9
  "id": "/",
10
  "icons": [
11
    {
12
      "src": "/img/pwa/favicon_16.png",
13
      "sizes": "16x16",
14
      "type": "image/png",
15
      "purpose": "any"
16
    },
17
    {
18
      "src": "/img/pwa/favicon_16.png",
19
      "sizes": "16x16",
20
      "type": "image/png",
21
      "purpose": "maskable"
22
    },
23
    {
24
      "src": "/img/pwa/favicon_32.png",
25
      "sizes": "32x32",
26
      "type": "image/png",
27
      "purpose": "any"
28
    },
29
    {
30
      "src": "/img/pwa/favicon_32.png",
31
      "sizes": "32x32",
32
      "type": "image/png",
33
      "purpose": "maskable"
34
    },
35
    {
36
      "src": "/img/pwa/favicon.png",
37
      "sizes": "180x180",
38
      "type": "image/png",
39
      "purpose": "any"
40
    },
41
    {
42
      "src": "/img/pwa/favicon.png",
43
      "sizes": "180x180",
44
      "type": "image/png",
45
      "purpose": "maskable"
46
    }
47
  ],
48
  "splash_pages": null
49
}

在博客根目录创建一个 sw-rules.js 文件

1
module.exports.config = {
2
  /** @type {?ServiceWorkerConfig|boolean} */
3
  serviceWorker: {
4
    escape: 1,
5
    cacheName: 'SolitudeCache',
6
    debug: false,
7
  },
8
  register: {
9
    onsuccess: undefined,
10
    onerror: () => console.error('Service Worker 注册失败！可能是由于您的浏览器不支持该功能！'),
11
    builder: (root, framework, pluginConfig) => {
12
      const { onerror, onsuccess } = pluginConfig.register;
13
      return `
14
            <script>
15
                (() => {
16
                    const sw = navigator.serviceWorker;
17
                    const error = ${onerror && onerror.toString()};
18
                    if (!sw?.register('${new URL(root).pathname}sw.js')
19
                        ${onsuccess ? `?.then(${onsuccess.toString()})` : ''}
20
                        ?.catch(error)
21
                    ) error()
22
                })()
23
            </script>`;
24
    },
25
  },
26
  /** @type {?DomConfig|boolean} */
27
  dom: {
28
    /** @type {?VoidFunction} */
29
    onsuccess: () => {
30
      caches
31
        .match('https://id.v3/')
32
        .then((res) => {
33
          if (res)
34
            res.json().then((json) => {
35
              utils &&
36
                utils.snackbarShow(
37
                  `已刷新缓存，更新为${
38
                    json.escape + '.' + json.global + '.' + json.local
39
                  }版本最新内容`,
40
                  false,
41
                  2500
42
                );
43
            });
44
          else console.info('未找到缓存');
45
        })
46
        .catch((error) => console.error('缓存匹配出错', error));
47
    },
48
  },
49
  /** @type {?VersionJsonConfig|boolean} */
50
  json: {
51
    /** @type {number} */
52
    maxHtml: 15,
53
    /** @type {number} */
54
    charLimit: 1024,
55
    /** @type {string[]} */
56
    merge: [],
57
    exclude: {
58
      /** @type {RegExp[]} */
59
      localhost: [],
60
      /** @type {RegExp[]} */
61
      other: [],
62
    },
63
  },
64
  /** @type {?ExternalMonitorConfig|boolean} */
65
  external: {
66
    /** @type {number} */
67
    timeout: 5000,
68
    /** 拉取文件时地并发限制 */
69
    concurrencyLimit: 100,
70
    /** @type {({head: string, tail: string}|function(string):string[])[]} */
71
    js: [],
72
    /** @type {RegExp[]} */
73
    stable: [
74
      /^https:\/\/npm\.elemecdn\.com\/[^/@]+\@[^/@]+\/[^/]+\/[^/]+$/,
75
      /^https:\/\/cdn\.cbd\.int\/[^/@]+\@[^/@]+\/[^/]+\/[^/]+$/,
76
      /^https:\/\/cdn\.jsdelivr\.net\/npm\/[^/@]+\@[^/@]+\/[^/]+\/[^/]+$/,
77
    ],
78
    replacer: (srcUrl) => {
79
      if (srcUrl.startsWith('https://cdn.jsdelivr.net/npm/')) {
80
        const pathname = new URL(srcUrl).pathname;
81
        return [
82
          srcUrl,
83
          `https://cdn.cbd.int/${pathname}`,
84
          `https://npm.elemecdn.com/${pathname}`,
85
          `https://fastly.jsdelivr.net/npm/${pathname}`,
86
        ];
87
      } else {
88
        return srcUrl;
89
      }
90
    },
91
  },
92
};
93

94
module.exports.cacheRules = {
95
  simple: {
96
    clean: true,
97
    search: false,
98
    match: (url, $eject) => url.host === $eject.domain && ['/404.html'].includes(url.pathname),
99
  },
100
  cdn: {
101
    clean: true,
102
    match: (url) =>
103
      [
104
        'cdn.cbd.int',
105
        'lf26-cdn-tos.bytecdntp.com',
106
        'lf6-cdn-tos.bytecdntp.com',
107
        'lf3-cdn-tos.bytecdntp.com',
108
        'lf9-cdn-tos.bytecdntp.com',
109
        'cdn.staticfile.org',
110
        'npm.elemecdn.com',
111
      ].includes(url.host) && url.pathname.match(/\.(js|css|woff2|woff|ttf|cur)$/),
112
  },
113
};
114

115
module.exports.getSpareUrls = (srcUrl) => {
116
  if (srcUrl.startsWith('https://npm.elemecdn.com')) {
117
    return {
118
      timeout: 3000,
119
      list: [srcUrl, `https://fastly.jsdelivr.net/${new URL(srcUrl).pathname}`],
120
    };
121
  }
122
};
123

124
module.exports.ejectValues = (hexo, rules) => {
125
  return {
126
    domain: {
127
      prefix: 'const',
128
      value: new URL(hexo.config.url).host,
129
    },
130
  };
131
};
132

133
module.exports.skipRequest = (request) =>
134
  request.url.startsWith('https://i0.hdslb.com') ||
135
  request.url.startsWith('https://meting.qjqq.cn') ||
136
  request.url.startsWith('https://api.i-meto.com');

hexo-deploy-git 提交到git的插件

1
pnpm i hexo-deploy-git --save

hexo-generator-feed hexo的rss插件

1
pnpm i hexo-generator-feed --save

hexo 的短链接: hexo-abbrlink

1
pnpm i hexo-abbrlink --save

在 _config.yml里修改：

1
permalink: posts/:abbrlink/
2
# or
3
permalink: posts/:abbrlink.html

添加:

1
# abbrlink config
2
abbrlink:
3
  alg: crc32 # Algorithm used to calc abbrlink. Support crc16(default) and crc32
4
  rep: hex # Representation of abbrlink in URLs. Support dec(default) and hex
5
  drafts: false # Whether to generate abbrlink for drafts. (false in default)
6
  force: false # Enable force mode. In this mode, the plugin will ignore the cache, and calc the abbrlink for every post even it already had an abbrlink. (false in default)
7
  writeback: true # Whether to write changes to front-matters back to the actual markdown files. (true in default)

博客的sitemap : hexo-generator-sitemap

1
pnpm i hexo-generator-sitemap --save

在 _config.yml里添加配置：

1
sitemap:
2
  path:
3
    - sitemap.xml
4
    - sitemap.txt
5
  template: ./sitemap_template.xml
6
  template_txt: ./sitemap_template.txt
7
  rel: false
8
  tags: true
9
  categories: true

使用algolia搜索 : hexo-algoliasearch

注册algolia：

注册地址：dashboard.algolia.com/users/sign_up

创建应用：

注册成功后创建应用：dashboard.algolia.com/account/plan/create?from=dashboard

search -> configure -> index添加index_name即可

在博客执行命令：

1
pnpm i hexo-algoliasearch --save

_config.yml里添加

1
algolia:
2
  appId: 'Z7A3XW4R2I'
3
  apiKey: '12db1ad54372045549ef465881c17e743'
4
  adminApiKey: '40321c7c207e7f73b63a19aa24c4761b'
5
  chunkSize: 5000
6
  indexName: 'my-hexo-blog'
7
  fields:
8
    - content:strip:truncate,0,500
9
    - excerpt:strip
10
    - gallery
11
    - permalink
12
    - photos
13
    - slug
14
    - tags
15
    - title

note

!!!配置完成后记得运行 hexo clean

在 hexo g 后实行下列代码：

1
hexo algolia

**hexo-safego**安全跳转插件

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

1
pnpm i cheerio --save

然后即可安装该插件：

1
pnpm i hexo-safego --save

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

1
# hexo-safego安全跳转插件
2
# see https://blog.liushen.fun/posts/1dfd1f41/
3
hexo_safego:
4
  # 基本功能设置
5
  general:
6
    enable: true # 启用插件
7
    enable_base64_encode: true # 使用 Base64 编码
8
    enable_target_blank: true # 打开新窗口
9
  # 安全设置
10
  security:
11
    url_param_name: 'u' # URL 参数名
12
    html_file_name: 'go.html' # 重定向页面的文件名
13
    ignore_attrs: # 忽略处理的 HTML 属性
14
      - 'data-fancybox'
15
  # 容器与页面设置
16
  scope:
17
    apply_containers: # 应用的容器选择器
18
      - '#article-container'
19
    apply_pages: # 应用的页面路径
20
      - '/posts/'
21
      - '/devices/'
22
    exclude_pages: # 排除的页面路径
23
  # 域名白名单
24
  whitelist:
25
    domain_whitelist: # 允许的白名单域名
26
      - 'qyliu.top'
27
      - 'liushen.fun'
28
  # 页面外观设置
29
  appearance:
30
    avatar: /info/avatar.ico # 头像路径
31
    title: '清羽飞扬' # 页面标题
32
    subtitle: '安全中心' # 页面副标题
33
    darkmode: true # 是否启用深色模式
34
    countdowntime: -1 # 倒计时秒数
35
  # 调试设置
36
  debug:
37
    enable: false # 启用调试模式

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

1
pnpm i hexo-bilibili-bangumi --save

在 _config.yml配置：

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

15
cinema: # 追剧设置
16
  enable: true # 是否启用
17
  source: bili
18

19
game: # 游戏设置，仅支持source: bgmv0
20
  enable: true # 是否启用
21
  source: bgmv0

还在更新中。。。

Github action配置#

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

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

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

，这也是必不可少的！

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

tip

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

配置 Github Action#

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

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

4
on:
5
  push:
6
    branches:
7
      - main # 自选分支
8

9
  release:
10
    types:
11
      - published
12

13
jobs:
14
  deploy:
15
    runs-on: ubuntu-latest
16
    steps:
17
      - name: 检查分支
18
        uses: actions/checkout@v4
19
        with:
20
          ref: main # 自选分支
21

22
      - name: 安装 Node
23
        uses: actions/setup-node@v4
24
        with:
25
          node-version: '22.x' # node版本
26

27
      - name: 安装 Hexo
28
        run: |
29
          export TZ='Asia/Shanghai'
30
          npm install hexo-cli -g
31
          npm install yamljs --save
32

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

40
      - name: 安装依赖
41
        if: steps.cache.outputs.cache-hit != 'true'
42
        run: |
43
          npm install --save
44
          npm install hexo-algoliasearch --save
45
          npm install hexo-bilibili-bangumi --save
46

47
      - name: 生成静态文件
48
        run: |
49
          node ./link.js
50
          hexo clean
51
          hexo generate
52
          hexo bangumi -u
53
          hexo algolia
54

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

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

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

重新设置远程仓库和分支#

🍼第一次使用git管理博客源码

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

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

添加屏蔽项

1
.DS_Store
2
Thumbs.db
3
db.json
4
*.log
5
node_modules/
6
public/
7
.deploy*/
8
.deploy_git*/
9
.idea
10
themes/solitude/.git

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

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

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

🍾曾经做过git管理源码的操作

添加屏蔽项

因为能够使用指令进行安装的内容不包括在需要提交的源码内，所有我们需要将这些内容添加到屏蔽项，表示不上传到 github 上。这样可以显著减少需要提交的文件量和加快提交速度。打开 [Blogroot]/.gitignore,输入以下内容：

1
.DS_Store
2
Thumbs.db
3
db.json
4
*.log
5
node_modules/
6
public/
7
.deploy*/
8
.deploy_git*/
9
.idea
10
themes/solitude/.git

如果不是 solitude主题，记得替换最后一行内容为你自己当前使用的主题。

提交源码到私有仓库 [SourceRepo] 在博客根目录 [Blogroot]下启动终端，使用 git 指令重设仓库地址。这样在新建仓库，我们仍旧可以保留珍贵的 commit history，便于版本回滚。

1
git remote rm origin # 删除原有仓库链接
2
git remote add origin git@github.com:[GithubUsername]/[SourceRepo].git #[SourceRepo]为新的存放源码的github私有仓库
3
git checkout -b master # 切换到master分支，
4
#2020年10月后github新建仓库默认分支改为main，注意更改
5
# 如果不是，后面的所有设置的分支记得保持一致
6
git add .
7
git commit -m "github action update"
8
git push origin master
9
#2020年10月后github新建仓库默认分支改为main，注意更改

可能遇到的 bug 因为 solitude 主题文件夹下的.git 文件夹的存在，那么主题文件夹会被识别子项目。从而无法被上传到源码仓库。若是遇到添加屏蔽项，但是还是无法正常上传主题文件夹的情况。请先将本地源码中的 themes 文件夹移动到别的目录下。然后 commit 一次。接着将 themes 文件夹移动回来，再 commit 一次。

important

要是还不行，那就删了 solitude 主题文件夹下的.git 文件夹，然后再重复上述的 commit 操作。

挖坑#

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