技术杂谈 on 苏三有春的博客

Hugo 博客维护踩坑记：主题迁移、暗色模式与 SCSS 优先级

Fri, 29 May 2026 12:00:00 +0800

为什么要用 Git Submodule

最初搭建博客时，我把 Hugo Theme Stack 的所有文件直接复制、提交到了博客仓库里。主题文件成百上千，和自己的文章、配置搅在一起。这带来几个问题：

无法追踪上游更新：上游修了 bug、加了新功能，我完全不知道，知道了也没法一键合并。唯一的选择是手动下载新版本的主题，重新覆盖，然后祈祷不要把自己改过的地方冲掉。
提交历史被污染：几百个主题文件的增删改和自己的博客文章混在同一个 git log 里，一眼看去完全分不清哪些是自己的创作、哪些是第三方代码。
仓库臃肿：主题文件占了大头，真正属于我的内容反而被淹没了。

Git Submodule 是什么

Git Submodule 允许一个 Git 仓库（主仓库）引用另一个 Git 仓库（子模块）的特定 commit，而不是把它的文件复制过来。

可以这样理解：不用 submodule 时，你等于把别人的房子拆了，砖头一块块搬到自己院子里重新盖；用了 submodule，你只是在自家院子里插了一块路牌，写着「去那边那个房子」。

关键特性：

主仓库只记录一个指针（子模块的 repo URL + commit hash），不存储子模块的实际文件
git clone 主仓库后，子模块目录是空的，需要 git submodule update --init 才会把子模块拉下来
子模块有自己独立的 .git 目录、独立的 commit 历史、独立的 remote
子模块的版本是精确锁定的——它指向一个具体 commit，不会自动更新

Submodule 的实际优势

	直接嵌入主题	Git Submodule
查看改动	`git diff` 里几百个主题文件混在一起	`git diff` 只显示指针 commit 的变化
更新主题	手动下载、覆盖、手动合并	`cd themes/xxx && git pull`
上游修复	不知道、合并痛苦	`git fetch origin && git merge`
回滚	混在博客历史中难以定位	主仓库 `git checkout` 一个旧 commit 即可恢复当时引用的主题版本
定制	直接改文件	通过 Hugo 的覆盖机制（`layouts/`、`assets/`、`static/`）在不碰主题源码的前提下定制

背景

基于以上原因，我决定把主题改成 git submodule 管理。但过程并不顺利，踩了四个坑，逐一记录。

第一步：把嵌入的主题改成 submodule + fork

思路很清晰：

Fork 一份 CaiJimmy/hugo-theme-stack 到自己的 GitHub
在 fork 里改好暗色模式的颜色（背景 #000000，卡片 #121317）
博客主仓库 git rm -r themes/hugo-theme-stack
git submodule add 指向上一步的 fork

这一步还算顺利。具体改动见 commit 52b389e。

坑一：submodule 指向的是 fork 的 v4.x，和博客用的 v3.9.x 不兼容

我的 fork 克隆的是上游 main 分支（v4.x），但博客一直用的是 v3.9.x。两个版本的目录结构、CSS 变量、模板写法都不一样。

现象：切 submodule 后，暗色模式的颜色没了，整体布局也有些差异。

最初的想法：切回 fork 的 v3.9.2 tag。但 fork 是直接从上游 fork 的 main，在 GitHub 上没法直接指定 fork 时的分支。

最终方案：submodule 直接指向上游 CaiJimmy/hugo-theme-stack 的 v3.9.2 tag，不要再维护一个 fork 了。主题定制统一通过 Hugo 的覆盖机制实现，不动主题源码。

1
2
3
4


# 切换 submodule
git checkout -- .gitmodules
git submodule add --force https://github.com/CaiJimmy/hugo-theme-stack.git themes/hugo-theme-stack
cd themes/hugo-theme-stack && git checkout v3.9.2 && cd ../..

--force 是因为 .git/modules/themes/ 里还缓存着旧的 git 目录。不加 --force 会报 A git directory for 'themes/hugo-theme-stack' is found locally。

坑二：Hugo v0.152.2 废弃 API，直接编译失败

GitHub Actions 用的 Hugo 版本是 0.152.2。在这个版本中：

resources.ToCSS → 已移除，需用 css.Sass
.Site.LastChange → 已移除，需用 .Site.Lastmod

但 hugo-theme-stack v3.9.2 仍然在用这些废弃 API。Workflow 直接报错退出。

解决方案：Hugo 布局文件的优先级是「项目 layouts/ > 主题 layouts/」。因此直接照搬主题中的三个文件到项目目录，修改一行即可：

文件	修改
`layouts/partials/head/style.html`	`resources.ToCSS` → `css.Sass`
`layouts/partials/comments/provider/disqusjs.html`	`resources.ToCSS` → `css.Sass`
`layouts/partials/head/opengraph/provider/base.html`	`.Site.LastChange` → `.Site.Lastmod`

1
2


-{{ $style := $sass | resources.ToCSS | minify | resources.Fingerprint "sha256" }}
+{{ $style := $sass | css.Sass | minify | resources.Fingerprint "sha256" }}

1
2


-{{- if not .Site.LastChange.IsZero -}}
+{{- if not .Site.Lastmod.IsZero -}}

坑三：`assets/scss/custom.scss` 暗色模式覆盖不生效（重点）

编译通过了，但暗色模式还是默认的 #303030 / #424242。

排查过程：我在项目根目录创建了 assets/scss/custom.scss，写入：

1
2
3
4


[data-scheme="dark"] {
 --body-background: #000000;
 --card-background: #121317;
}

主题的 assets/scss/style.scss 末尾有 @import "custom.scss"，理论上 Hugo 应该优先加载项目的 assets/scss/custom.scss。

但实际情况是：主题的 assets/scss/ 目录下也有一个 custom.scss，虽然它只是一个空注释：

1

/* Place your custom SCSS in HUGO_SITE_FOLDER/assets/scss/custom.scss */

Hugo 的 SCSS @import 解析器在遇到 @import "custom.scss" 时，会先在当前文件所在目录查找（即主题的 assets/scss/）。它找到了主题的那个空文件，加载了它，就停了。项目里的同名文件根本没被看到。

踩坑记录：

❌ 尝试覆盖 style.scss，把 @import "custom.scss" 改成 @import "site-custom.scss"，然后创建 site-custom.scss。这个方案理论上可行，但实际操作中因为之前的编译产物一致（都是默认色），GitHub Actions 的部署环节 peaceiris/actions-gh-pages 检测到 nothing to commit，跳过了部署，导致没有生效。
❌ 尝试直接修改 submodule 内的主题文件 —— 本地能跑，但 CI 重新 clone 子模块后又还原了。
✅ 最终方案：直接覆盖 assets/scss/variables.scss。

Hugo 的资源查找（resources.Get）逻辑和 SCSS @import 解析逻辑不同。resources.Get 会优先使用项目中的文件而不是主题中的。所以只要创建一个包含暗色模式的 assets/scss/variables.scss，Hugo 就会用它代替主题的版本。

1
2
3
4
5
6


# 拷贝主题的 variables.scss 到项目
cp themes/hugo-theme-stack/assets/scss/variables.scss assets/scss/variables.scss

# 修改暗色模式部分
# --body-background: #303030 → #000000
# --card-background: #424242 → #121317

这个方案不仅解决了 @import 优先级问题，而且改动集中在一个文件里，不依赖 custom.scss 的加载顺序。

坑四：部署日志显示成功，但 `.github.io` 仓库没更新

Workflow 日志里 Deploy Web 步骤显示：

1
2
3
4


git commit -m auto deploy ...
On branch main
nothing to commit, working tree clean
[INFO] skip commit

原因：peaceiris/actions-gh-pages@v4 默认行为会在目标仓库克隆一份，git rm -r * 清空，再 cp 新的构建产物进去，然后 commit。如果新的产物和上次完全一致（文件树 hash 相同），git 会认为没有变化，跳过 commit。

这发生在上一个坑的排查中 — 我们的 style.scss 覆盖方案编译出来的结果和默认主题一样（都是 #303030 / #424242），所以部署被跳过了。

只要修复真正生效（编译出不同的 CSS），部署就会重新触发。

总结：Hugo 主题定制的优先级规则

场景	Hugo 的行为	推荐做法
布局覆盖 (layouts/)	项目的 `layouts/` 优先于主题	直接复制主题文件到项目，修改
SCSS @import	先从导入文件的目录查找	不要和主题的同名文件冲突，避免用通用的名字如 `custom.scss`
resources.Get + SCSS	项目的 `assets/` 优先于主题	覆盖 `variables.scss` 是最可靠的
静态资源 (static/)	项目的 `static/` 覆盖主题同名文件	放 `static/img/avatar.png` 等

关键教训：在 Hugo 中给主题改样式，特别是改 CSS 变量，最稳妥的方式永远是 直接在项目中放置 assets/scss/variables.scss，而不是依赖 custom.scss 的 @import 机制。

附：本次改动总览

1
2
3
4
5
6
7


ff7709a switch theme submodule to upstream v3.9.2
d25696a move particles.js to head/custom.html
54a32e0 add dark mode overrides via custom.scss ← 没生效
60fd094 fix deprecated Hugo APIs (ToCSS, LastChange)
a03c80b override style.scss → site-custom.scss ← 编译成功但部署被跳过
84e15c4 trigger rebuild ← 同上
6c366ed fix: override variables.scss directly ← 最终生效 ✅

逆向工程实战，在反汇编中发生的事

Sun, 08 Dec 2024 19:20:00 +0800

前言

今天对某外国的机器中的某个音频解码库进行反汇编，发现了一些有趣的知识，故而记录下来，以防以后重复遇到。

现笔者使用的反汇编工具为“Ghidra”。可在GitHub上下载：NationalSecurityAgency/ghidra: Ghidra is a software reverse engineering (SRE) framework

Ghidra是由美国国家安全局研究局创建和维护的软件逆向工程 (SRE) 框架。该框架包括一套功能齐全的高端软件分析工具，使用户能够在包括 Windows、macOS 和 Linux 在内的各种平台上分析编译代码。功能包括反汇编、汇编、反编译、绘图和脚本，以及数百个其他功能。

Ghidra由java编写，因此使用Ghidra前先配置java运行环境。

注：本文不介绍Ghidra的使用

adpcm_decoder1函数

C代码

笔者通过获取机器日志，发现了机器存在音频解码函数，通过grep命令查询到了，存有相应解码函数的库文件，并将库文件pull了出来，我们来看一下该库文件中相应的解码函数：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70


void adpcm_decoder1(char *param_1,undefined2 *param_2,int param_3,int *param_4)

{
 bool bVar1;
 uint uVar2;
 int iVar3;
 uint uVar4;
 int iVar5;
 int iVar6;
 int iVar7;
 uint uVar8;
 char *local_2c;
 int local_28;
 undefined2 *local_24;

 iVar3 = __divsi3(param_3,0x14);
 for (iVar6 = 0; iVar6 < iVar3; iVar6 = iVar6 + 1) {
 Decryption(0x32,param_1 + iVar6 * 0x14);
 }
 bVar1 = false;
 uVar8 = 0;
 iVar5 = param_4[1];
 iVar6 = *param_4;
 iVar3 = *(int *)(&DAT_00019c5c + iVar5 * 4);
 local_2c = param_1;
 local_24 = param_2;
 for (local_28 = param_3 << 1; 0 < local_28; local_28 = local_28 + -1) {
 uVar2 = uVar8;
 if (!bVar1) {
 uVar8 = (uint)*local_2c;
 local_2c = local_2c + 1;
 uVar2 = (int)uVar8 >> 4;
 }
 uVar4 = uVar2 & 0xf;
 bVar1 = (bool)(bVar1 ^ 1);
 iVar5 = iVar5 + (&DAT_00019dc0)[uVar4];
 if (iVar5 < 0) {
 iVar5 = 0;
 }
 else if (0x58 < iVar5) {
 iVar5 = 0x58;
 }
 iVar7 = iVar3 >> 3;
 if ((int)(uVar4 << 0x1d) < 0) {
 iVar7 = iVar7 + iVar3;
 }
 if ((int)(uVar4 << 0x1e) < 0) {
 iVar7 = iVar7 + (iVar3 >> 1);
 }
 if ((uVar2 & 1) != 0) {
 iVar7 = iVar7 + (iVar3 >> 2);
 }
 if ((uVar2 & 8) != 0) {
 iVar7 = -iVar7;
 }
 iVar6 = iVar6 + iVar7;
 if (iVar6 < -0x8000) {
 iVar6 = -0x8000;
 }
 if (0x7fff < iVar6) {
 iVar6 = 0x7fff;
 }
 iVar3 = *(int *)(&DAT_00019c5c + iVar5 * 4);
 *local_24 = (short)iVar6;
 local_24 = local_24 + 1;
 }
 *param_4 = iVar6;
 param_4[1] = iVar5;
 return;
}

以上是反汇编后的结果，Ghidra将机器语言解析成汇编语言，再自动转换成相应的C语言。

Decryption函数并非ADPCM的一部分

可以看到，这是典型的ADPCM音频解码算法，笔者已经对比过经典的开源ADPCM音频解码算法的C语言版本，确实是相差无几，但在这段代码中，多出了以下内容：

1
2
3
4


 iVar3 = __divsi3(param_3,0x14);
 for (iVar6 = 0; iVar6 < iVar3; iVar6 = iVar6 + 1) {
 Decryption(0x32,param_1 + iVar6 * 0x14);
 }

在解释这一段内容前，读者需要先了解：该机器通过蓝牙接收语音数据，每语音帧20字节。但机器处理不一定是20字节一处理，根据音频收发的速率，丢包率以及buffer的大小决定。

现在笔者来解释一下这一段的内容：

param_3除以20，将结果赋值给iVar3变量，这里计算出一共进来多少语音帧需要处理，每帧20字节
一个for循环，将每帧数据丢入Decryption函数中进行处理
Decryption函数接收两个参数，0x32,一个固定的常量值；param_1 + iVar6 * 0x14，param_1是语音数据的数组指针

Decryption函数的参数问题

这里解释一下Decryption函数接收的两个参数，实际上，Decryption函数接收三个参数，在这里，Ghidra在C中只给出了两个参数，笔者不清楚这是Ghidra的特性还是工具缺陷。对汇编不感兴趣的同学可以跳过这一部分，但推荐看看

下面会给出Decryption的函数体，在函数体中可以发现Decryption是接收三个参数的，这里我们讲解一下这一段for循环的汇编内容

C语言：
1
2
3
 for (iVar6 = 0; iVar6 < iVar3; iVar6 = iVar6 + 1) {
 Decryption(0x32,param_1 + iVar6 * 0x14);
 }
汇编：
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
 LAB_00016624
 00016624 bc 42 cmp r4,r7
 00016626 09 da bge LAB_0001663c
 00016628 14 22 movs r2,#0x14
 0001662a 62 43 muls r2,r4
 0001662c 01 9b ldr r3,[sp,#local_2c ]
 0001662e 32 20 movs r0,#0x32
 00016630 9a 18 adds r2,r3,r2
 00016632 11 1c adds r1,r2,#0x0
 00016634 ff f7 38 ff bl Decryption
 00016638 01 34 adds r4,#0x1
 0001663a f3 e7 b LAB_00016624
这是这个for循环中涉及到的汇编语言，我们尝试在这段汇编中找到Decryption的三个参数

cmp 指令表示比较，即比较r4与r7寄存器中的值，结合c代码，可以看出，r4，r7分别代表了iVar6和iVar3，但目前不清楚哪个对哪个。

bge 指令是分支指令，表示条件跳转(branch if greater or equal)，即如果大于等于，则跳转。这两个指令合起来为，如果r4≥r7，则跳转到LAB_0001663c代码段，可以看出，已经超出了这个for循环的地址，即退出了for循环。

movs 指令表示移动，将立即数0x14移动到r2寄存器中，现在r2寄存器中存储了0x14这个值。

muls 指令表示乘法，即将r2与r4寄存器中的值相乘，结合c代码可以看到，代码中仅有一个乘法，即iVar6 * 0x14，可以得出，r2 = 0x14，r4 = iVar6。

ldr 指令表示加载寄存器(load register)，语法为：ldr <寄存器>, [<基址寄存器>, <偏移量>]，从基址寄存器中取出地址，加上偏移量，将结果加载到寄存器中，这里取出的地址加载到r3中，在c代码中，只有一个涉及到取址操作，即param_1，这是一个adpcm_decoder1函数接受的传参，传入的是一个指针，即param_1其实是一个数组指针。这里是获取param_1数组的地址，放到r3中。

movs 指令表示移动，将立即数0x32移动到r0寄存器中，现在r0寄存器中存放了0x32这个值。

adds 指令表示加法，将r3与r2相加，并存放到r2寄存器中，即，param_1的地址加上一个计算的偏移量，本质上是从param_1的语音数据中获取第n个语音帧的地址。

adds 指令表示加法，将r2寄存器的值加上立即数0x00存放到r1寄存器中，这操作让r2寄存器存放的内容与r1一致。

bl 指令表示跳转，即跳转到Decryption函数的位置去，执行Decryption函数，并把下一条指令的地址存放到lr寄存器中，以方便Decryption函数执行完能回来，相当于压栈，将Decryption函数压入函数栈。

adds 指令表示加法，将r4 加上立即数0x01，并存放到r4中，即for循环的++操作。

可以看到，在调用Decryption函数前，分别给三个寄存器存放了东西，分别为r0存放了0x32，r1存放了param_1的偏移地址，r2存放与r1相同的东西。这三个寄存器就是Decryption函数用的三个参数。如果还不确定，可以跳转到Decryption函数中查看相应的param_1,param_2,param_3三个参数调用时所使用的寄存器，分别为r0，r1，r2，本文给出结论，不做赘述。

小结

总而言之，这里的音频解码，虽然使用的是ADPCM算法，但是在raw data与adpcm data之间还加入了一个加密解密过程，即，实际上的过程为：

原始音频数据raw data → adpcm压缩→ 加密算法 encryption → 蓝牙传输 → 解密算法 decryption → adpcm解压 → 原始音频数据 raw data

因此，接下来看如何用解密算法还原加密算法

decryption函数

C代码

下面是decryption函数

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37


void Decryption(byte param_1,int param_2,int param_3)

{
 int *piVar1;
 byte bVar2;
 int iVar3;
 int iVar4;
 byte local_30 [20];
 int local_1c;

 local_1c = __stack_chk_guard;
 iVar3 = 0;
 do {
 local_30[iVar3] = *(byte *)(param_2 + iVar3);
 iVar3 = iVar3 + 1;
 } while (iVar3 != 0x14);
 iVar3 = 0x13;
 do {
 iVar4 = iVar3 * 4;
 piVar1 = &DAT_00019c08 + iVar3;
 bVar2 = (byte)iVar3;
 iVar3 = iVar3 + -1;
 local_30[*(int *)(&DAT_00019c0c + iVar4)] =
 local_30[*(int *)(&DAT_00019c0c + iVar4)] + local_30[*piVar1] ^ bVar2 ^ param_1;
 } while (iVar3 != 0);
 local_30[0] = local_30[0] - 0x3e ^ param_1;
 iVar3 = 0;
 do {
 *(byte *)(param_3 + iVar3) = local_30[iVar3];
 iVar3 = iVar3 + 1;
 } while (iVar3 != 0x14);
 if (local_1c != __stack_chk_guard) {
 /* WARNING: Subroutine does not return */
 __stack_chk_fail();
 }
 return;
}

笔者依次解释上面的代码

数据本地化

1
2
3
4
5
6


 iVar3 = 0;
 do {
 local_30[iVar3] = *(byte *)(param_2 + iVar3);
 iVar3 = iVar3 + 1;
 } while (iVar3 != 0x14);
 iVar3 = 0x13;

这一段代码其实很好看出是在做什么，就是将传入的数据存在函数内部的局部变量中，iVar3变量是一个很重要的变量，在后续计算中会用到，记住它。在将所有数据搬完之后（一共20个字节，一语音帧20个字节），iVar3变量来到了0x13，十进制19

第19到1的数据解码

1
2
3
4
5
6
7
8


 do {
 iVar4 = iVar3 * 4;
 piVar1 = &DAT_00019c08 + iVar3;
 bVar2 = (byte)iVar3;
 iVar3 = iVar3 + -1;
 local_30[*(int *)(&DAT_00019c0c + iVar4)] =
 local_30[*(int *)(&DAT_00019c0c + iVar4)] + local_30[*piVar1] ^ bVar2 ^ param_1;
 } while (iVar3 != 0);

这里有一个很容易混淆的地方，就是标题采用的“第19到第1”这个概念，我们只能说，从while循环，从iVar3变量的角度，是“从19到1”，而从数据的角度说并不是这样。为了强化读者这个概念，我们先介绍local_30[*(int *)(&DAT_00019c0c + iVar4)]与local_30[*piVar1]这两个变量。

local_30[(int )(&DAT_00019c0c + iVar4)]

首先，从定义上看byte local_30 [20];，local_30是一个数组的局部变量，且具有20个元素的大小，每个元素的大小为1byte，即，该数组是专门存放音频数据的。

其次，我们先看local_30[*(int *)(&DAT_00019c0c + iVar4)]，数组的内部index部分很复杂，我们来做介绍

&DAT_00019c0c是内存中的一个地址
&DAT_00019c0c + iVar4表示这个地址 + 一个偏移量，组成一个新的地址
(int *)(&DAT_00019c0c + iVar4)表示将这个地址被强制类型转换为int类型的指针
*(int *)(&DAT_00019c0c + iVar4)表示取值这个int指针，即从这个地址中取值，这个值是int类型的

然后，我们来看这个iVar4变量，iVar4 = iVar3 * 4，在每一次循环中，iVar4都会被更新一次，且更新为iVar3 * 4，iVar3在每次循环中会被做-1操作。也就是说，第一次iVar4 = 19 * 4，第二次为iVar4 = 18 * 4，以此类推。

最后，我们查查这个DAT_00019c0c，以及它对应的偏移量中究竟存了什么东西，通过Ghidra的汇编地址中可以查到：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21


 DAT_00019c0c
 00019c0c 00 ?? 00h
 00019c0d 00 ?? 00h
 00019c0e 00 ?? 00h
 00019c0f 00 ?? 00h
 00019c10 0c ?? 0Ch
 00019c11 00 ?? 00h
 00019c12 00 ?? 00h
 00019c13 00 ?? 00h
 00019c14 0d ?? 0Dh
 # 为方便阅读，此处省略部分......
 00019c4c 01 ?? 01h
 00019c4d 00 ?? 00h
 00019c4e 00 ?? 00h
 00019c4f 00 ?? 00h
 DAT_00019c50
 00019c50 02 00 00 00 undefine 00000002h
 DAT_00019c54
 00019c54 07 00 00 00 undefine 00000007h
 DAT_00019c58
 00019c58 08 00 00 00 undefine 00000008h

0x00019c0c地址存放的数据为0x00，隔4个字节后，0x00019c10地址存放的数据为0x0c……一直到19 * 4个字节，即0x00019c58存放的数据为0x08，通过查询并列出发现，其数据依次为：

0x0 0xc 0xd 0x3 0x4 0x9 0xa 0xb 0x10 0x11 0x12 0x13 0x5 0x6 0xe 0xf 0x1 0x2 0x7 0x8

刚好是0~19，即根据通过’iVar3’的依次从19到1的变化，local_30数组依次参与解码的数据为8，7，2，1，…，4，3，13，12，0，而非按顺序解码。

local_30[*piVar1]

在这里我们可以看到，该变量依然是local_30数组中的元素，只不过其index表示为*piVar1。

看piVar1 = &DAT_00019c08 + iVar3; 一些敏锐的同学可能注意到，在我们介绍的前一个变量中，地址都是四个字节一偏移，在内存地址中查询数据的分布，也是四个字节存一个数据，其它地方都是0，而按照我们的理解，piVar1 = &DAT_00019c08 + iVar3 * 4;似乎才是正确的。我们查看一下相应的汇编代码：

1
2
3


 000164da ee 59 ldr r6,[r5,r7]=>DAT_00019c58
 000164dc 04 3d subs r5,#0x4
 000164de 7d 59 ldr r5,[r7,r5]=>DAT_00019c54

这一段代码，分别是做了*(int *)(&DAT_00019c0c + iVar4)的计算以及piVar1 = &DAT_00019c08 + iVar3的计算，我们来解释一下：

ldr指令表示加载寄存器，先计算r5与r7寄存器相加的值，再传给r6寄存器，ghidra已经给出了第一次循环中指向的地址，即0x00019c58
subs指令表示减法，将r5寄存器中的值减去立即数0x04并传给寄存器r5
与第一条指令相同，且ghidra给出了第一次循环中指向的地址，即0x00019c54

这样可以看出，实际上，寄存器r5与r6都是读地址值且相差仅有4个字节。也就是说，piVar1比&DAT_00019c08 + iVar3 * 4仅仅相差了4个字节，例如：在第一次循环中，&DAT_00019c08 + iVar3 * 4中的值为0x8，piVar1中的值为0x7，在最后一次循环中，&DAT_00019c08 + iVar3 * 4的值为0xc，piVar1的值为0x0。

为什么C代码会与汇编相差如此之大呢，第一，在GCC编译C语言的过程中，本身会对代码进行优化，即调整指令顺序，甚至优化掉部分操作，以提升效率；第二，从已经编译过的二进制文件反推出C语言代码本身就是非常难的一件事情，正如数学中，求导的难度往往比求原函数的难度要低。所以有些细微的差池是可能的，因此在逆向工程中，除了要看C代码，还要检查汇编代码以及内存的走向。

解码过程

现在我们了解了那两个复杂的变量，现在我们来讲一讲解码的算法

1
2


 local_30[*(int *)(&DAT_00019c0c + iVar4)] =
 local_30[*(int *)(&DAT_00019c0c + iVar4)] + local_30[*piVar1] ^ bVar2 ^ param_1;

在这条运算中，我们可以了解到local_30[*(int *)(&DAT_00019c0c + iVar4)]表示当前解码运算的数据，local_30[*piVar1]表示下一个解码运算的数据，例如：当*(int *)(&DAT_00019c0c + iVar4)=8时，*piVar1 = 7，这样上式就变成了：

1

 local_30[8] = local_30[8] + local_30[7] ^ bVar2 ^ param_1;

依次类推，到最后一次循环时，上式变成：

1

 local_30[12] = local_30[12] + local_30[0] ^ bVar2 ^ param_1;

我们假设，存在一个table[20]

1
2
3
4
5
6


table[20] = {
 0x0,0xc,0xd,0x3,0x4,\
 0x9,0xa,0xb,0x10,0x11,\
 0x12,0x13,0x5,0x6,0xe\
 0xf,0x1,0x2,0x7,0x8
}

那么整个while循环可以改写成：

1
2
3
4
5


 do {
 local_30[table[iVar3]] =
 local_30[table[iVar3]] + local_30[table[iVar3-1]] ^ bVar2 ^ param_1;
 iVar3 = iVar3 + -1;
 } while (iVar3 != 0);

这样，读者应该可以理解，我们从iVar3的角度上来讲，是“从第19到1的解码”，但从数据实际的解码顺序来讲，其实是“8，7，2，1，15，14，6，5，19，18，17，16，11，10，9，4，3，13，12”的顺序解码，0在后面单独解码。

这19个数据，每一个解码，都依赖于前一个还未解码的数据，即当解码第8个数据的时候，需要依赖第7个数据，当解码第12个数据时，需要依赖第0个数据。

现在我们仔细讲一下式子，在该式子中， bVar2 = (byte)iVar3;即，bVar2与iVar3相同，从19到1根据循环次数递减，param_1是一个常量，为0x32，是从adpcm_decoder1中传进来的第一个参数，如果不记得可往上翻阅。

在这条式子中，既有加法，又有异或运算，那么问题来了，该怎样计算呢？或者说，先算哪个呢？

这时熟悉C语言的同学们会说，在C语言中，加减法的优先级高于异或运算的优先级，因此先计算local_30[table[iVar3]] + local_30[table[iVar3-1]]，再计算 ^ bVar2 ^ param_1，答案是没错的，在不同的语言中，异或运算与加减法的优先级可能会有所不同，因此这里的运算优先级要额外注意，但同理，在逆向工程中，不要过分相信逆向工具给你的C代码，它不一定是你想象的那样，因此我们还是来看一下它的汇编代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


 LAB_000164d6
 000164d6 1a 1c adds r2,r3,#0x0
 000164d8 9d 00 lsls r5,r3,#0x2
 000164da ee 59 ldr r6,[r5,r7]=>DAT_00019c58
 000164dc 04 3d subs r5,#0x4
 000164de 7d 59 ldr r5,[r7,r5]=>DAT_00019c54
 000164e0 42 40 eors r2,r0
 000164e2 01 92 str r2,[sp,#local_3c ]
 000164e4 4a 5d ldrb r2,[r1,r5]
 000164e6 8d 5d ldrb r5,[r1,r6]
 000164e8 01 3b subs r3,#0x1
 000164ea 94 46 mov r12 ,r2
 000164ec 01 9a ldr r2,[sp,#local_3c ]
 000164ee 65 44 add r5,r12
 000164f0 55 40 eors r5,r2
 000164f2 8d 55 strb r5,[r1,r6]
 000164f4 00 2b cmp r3,#0x0

因为式子中有一个“+”和两个“^”，因此我们只要着重看“add”指令与“eor”指令即可。

adds r2,r3,#0x0：这条指令并不是加法指令，而是将r3寄存器中的值赋值给r2寄存器，这个寄存器中实际存了什么值呢，我们看后续有一个subs r3,#0x1，因此可知，r3寄存器是在循环中递减的，这符合bVar2的特征，因此可以断定，r2寄存器存储的实际上就是bVar2。
eors r2,r0：r2寄存器与r0寄存器的值做异或运算，将结果存放到r2中，在我们之前提到，r0寄存器存储的是param_1传参，即0x32固定参数，因此这条指令实际上就是bVar2 ^ param_1。
ldrb r2,[r1,r5]：指令表示加载寄存器，r5与r6两个寄存器的内容我们上面分析过，[r1,r5]表示目标内存地址，这个地址是通过将寄存器r1与r5的值相加得来的，r1为param_2，即数据数组指针，r5为上面分析时讲到的乱序查表得到的偏移量。两者相加则索引到对应的数据。将其存放在r2中，下面ldrb r5,[r1,r6]一样。
mov r12 ,r2：该指令将r2寄存器中的值转移到r12寄存器，因此，现在r12与r2的内容一样。
add r5,r12：该指令将r12与r5相加，即式子中的两个local_30相加，并将结果存放到r5中。
eors r5,r2：将r5寄存器与r2寄存器中的值做异或运算。

通过汇编指令，我们可以推算出运算的优先级为：

$$ r1 = bVar2 \oplus param_1\\ r2 = local\_30[*(int *)(\&DAT\_00019c0c + iVar4)] + local\_30[*piVar1]\\ res = r1 \oplus r2 $$

第0个数据的解码

1
2


 local_30[0] = local_30[0] - 0x3e ^ param_1;
 iVar3 = 0;

第0个数据不依赖于任何其它的数据，仅靠自身便可完成解码

其对应的汇编代码也很简单，如果读者理解了上面的过程，那么理解这一段汇编代码也是轻而易举，在此笔者不做过多赘述

1
2
3


 000164fc 3e 38 subs r0,#0x3e
 000164fe 50 40 eors r0,r2
 00016500 08 70 strb r0,[r1,#0x0 ]=>local_30

返回数据

1
2
3
4


 do {
 *(byte *)(param_3 + iVar3) = local_30[iVar3];
 iVar3 = iVar3 + 1;
 } while (iVar3 != 0x14);

在此过程中，通过while循环将local_30中已经完成解码的数据全部放到param_3参数中，完成了数据的返回（因为param_3是一个指针，因此对指针数据做修改在函数退出时修改依然成立，而不会随着函数出栈而消失）。

总结

在这个反汇编的过程中，我们通过C代码与汇编代码的结合，还原出了解码过程的真实情况，因此，在反汇编中除了看反汇编工具提供的c语言代码，也需要看原来的汇编代码。所以，在逆向工程中，学会阅读汇编代码对你的帮助时巨大的，会避免因编译优化等问题带来的困扰，同时，笔者推荐读一读《深入理解计算机系统》，会让你对C和逆向有更深层次的理解，最后祝你变得更强！

基于Hugo构建一个属于自己的博客（二）

Wed, 20 Nov 2024 21:48:00 +0800

前言

首先，想要实现这个功能的小伙伴需要完成几个前置条件：

有一个GitHub账号
安装了git，并可以通过git推送commit到GitHub上
完成第一篇文章的博客搭建

创建仓库

在GitHub上创建一个仓库，用来存放代码

如果你不是GitHub重度使用者或高手，建议你的仓库名称就是你自己的用户名 + .github + .io。如图所示：

这是因为，如果使用这个名字的话，那么在后续使用GitHub pages生成静态网站的域名就直接是你的仓库名，而不需要加其它后缀，可能会导致未知的bug

仓库必须公有，只有公有仓库才能部署静态页面

修改配置

还记得上一篇文章提到的，配置文件中有一个参数是讲url重定向到自己的GitHub仓库的吗，现在我们在创建自己的仓库之后，可以开始填写，修改hugo.yaml的`baseurl

1

baseurl: https://Lyrical-wander.github.io # 这里是我的仓库名称，如果你按照上面的步骤走，输入：https://用户名.github.io 即可

上传代码

上传代码前，首先查看你的站点目录下有没有public目录

这个public目录是生成的静态网站的代码，还记得我们上一个文章中使用的一条命令吗
1
hugo server -D
这条命令会启动hugo程序，将源码进行“编译”（当然并不是真正意义上的编译），生成html，scss等前端代码，这些代码构成静态网站。

如果没有生成public目录，那么就使用hugo server -D命令生成一下。

值得注意的是，如果你习惯用VScode中的git插件，也许会方便很多。但第一次上传代码也需要手敲命令

但幸运的是，当你第一次创建仓库，仓库中一无所有时，会提示你如何上传代码

在站点目录下启用cmd命令，逐条输入命令：

1
2
3
4
5
6


git init # 初始化git
git add . # 通过git上传当前目录下所有的文件
git commit -m "这是我的博客第一次提交" # 这里是给这一次提交写一个记录，说明这个提交是做什么的
git branch -M main # 创建主分支
git remote add origin xxxxxxxxx # 你是什么就填什么，不做修改
git push -u origin main

如果这里出问题，push不到仓库中，不是hugo或者stack的问题，请检查git与GitHub是否正常运行，以下有几个排查的方向：

网络问题，因为GitHub是全球服务器，因此国内访问可能会有些慢，有条件的同学开个代理
git并没有权限访问GitHub，看你是如何配置GitHub的，建议采用SSH，网上有许多git生成ssh密钥，GitHub绑定密钥的教程，建议跟着走一遍，如果采用HTTPS的话，应该是要登陆的，具体流程笔者很久没用了，也是建议上网搜索，网上教程很多

启用pages功能

如果你成功上传代码，现在可以打开GitHub上自动生成静态网页的pages功能，来帮你生成静态网页，等静态网页生成后，以后通过访问你的仓库域名，即可直接打开你的博客

进入你的仓库
在仓库菜单栏中找到Settings功能
在侧边菜单栏中找到Pages
在分支Branch中选择主分支main
保存Save

做完以上操作，等待一段时间静态网站部署，可能几分钟，刷新一下出现⑥处，则说明生成成功，访问这个域名即可访问你的博客！

值得注意的是，这里我是购买了自己的域名，然后解析到我的仓库，所以我的域名是www.lyrical-wander.cn，而不是www.lyrical-wander.github.io，而如果按照上面的步骤走的话，域名应该是：www.usename.github.io

至此，你的博客已经部署好了！可以开始访问你自己的博客啦

小结

还有需要注意的是：

每一次写完博客，都需要重新使用hugo server -D命令，生成新的public目录，push上GitHub
每次生成新的public，都会有大量的文件被改动，push起来非常不方便

因此我们要通过GitHub的Action功能来实现自动化部署

自动化部署

创建仓库

同样地，按照上面的步骤，我们重新创建一个仓库，这个仓库不会生成pages，且可以设置为私有仓库，因此随意命名，比如：hugo-main

修改代码

创建.gitignore文件

我们添加一个小文件，来保持我们代码的干净整洁。

因为每一次hugo server -D都会生成新的public和resources，而这个并不是我们编写的代码，因此这个可以忽略掉。

在站点目录下增加一个新文件.gitignore

填写以下内容：

这个文件顾名思义，可以让git忽略掉它里面填写的这些文件，这些文件git不会再检查它们的修改，也不会让你提交它们。

生成token并创建yaml配置文件

首先我们先生成一个token，获取该token，以免你以后每次上传代码都需要重新登录一遍

进入Settings

移动到最下方找到Developer settings

然后选择Personal access tokens→Tokens(classic)→Generate new token→Generate new token(classic)

生成token时可以将Expiration选择No expiration，即这个token永不过期。

下面Select scopes（作用范围）选择repo与workflow

后面就生成了token~

注意！这个token只会出现一次，之后再也不会出现，在你关闭网页前先复制保存！

回到你刚刚创建的 第二个仓库 上（我们称之为hugo主仓库吧），不是username.github.io那个仓库！

在仓库中打开Settings→Secrets and Variables→New repository secret 来创建一个存储token的变量

为什么要这么做呢，因为token这个东西比较重要，如果后续我们直接将它写到文件中，如果文件被窃取，那么token就会暴露，这样你的仓库就不安全了，尤其我们的token还选择了不过期。

因此，我们将token保存在GitHub中，以变量的形式传给我们的文件，这样token的密封性就很好了

回到我们的站点目录下，创建一个.github目录，在.github目录下创建一个workflows目录，在该目录下生成一个xxxxx.yaml文件，名字随便取

在xxxx.yaml文件下写入以下代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34


name: deploy

# 代码提交到main分支时触发github action
on:
 push:
 branches:
 - main

jobs:
 deploy:
 runs-on: ubuntu-latest
 steps:
 - name: Checkout
 uses: actions/checkout@v4
 with:
 fetch-depth: 0

 - name: Setup Hugo
 uses: peaceiris/actions-hugo@v3
 with:
 hugo-version: "latest"
 extended: true

 - name: Build Web
 run: hugo -D

 - name: Deploy Web
 uses: peaceiris/actions-gh-pages@v4
 with:
 PERSONAL_TOKEN: ${{ secrets.你的token变量名 }} # 刚刚在上面创建的变量名
 EXTERNAL_REPOSITORY: 你的github名/你的仓库名 # 如果按照上面的步骤走，则是username/username.github.io第一个仓库名
 PUBLISH_BRANCH: main
 PUBLISH_DIR: ./public
 commit_message: auto deploy

上传代码

同样地，我们将站点代码再一次上传到这个仓库上，git操作一模一样，按照上面的上传代码部分来重新操作一遍即可。

1
2
3
4
5
6


git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin xxxxxxxxxxx
git push -u origin main

至此，你就实现了自动部署，现在，你撰写博文，然后直接push到第二个仓库，不需要本地生成public，就可以啦，第二个仓库会做一系列操作，并生成静态网站所需的资源和public，传到第一个仓库中，然后生成静态网站。

基于Hugo构建一个属于自己的博客（一）

Tue, 19 Nov 2024 21:47:00 +0800

前言

我想有一个地方，能够分享一些个人生活，记录一些技术知识，那么在茫茫大的网络世界中，有许多网站或者应用可以满足我的需求，比如CSDN，比如博客园，比如QQ空间（已经渐渐消失在时间的长河中了……）。但，总感觉差了些什么，它们既不能满足我的个人世界的全部想象，又不够极客主义，谁在小时候没有幻想过拥有一间完全由自己建造的，不受地皮，户型限制的房子呢？

因此，我决定开始搭建自己的个人博客，它将成为我在网络世界的一座小屋，它的风格，样式由我定义，它将随我漂流，我可以自由地为它添砖加瓦，也可以任性地删除任何我不满意的功能，也许在某天它将因为我的离开而荒废，但这里，有我在网络世界的一部分记忆，一部分独属于我的记忆……

笔者的个人博客，苏三有春的博客，采用了Hugo框架下的stack主题搭建，非常快速且简单（当然在搭建的过程当中笔者也踩了一些坑），因此写一篇博客来记录自己的搭建心得以及给有想法搭建个人博客的小伙伴们一些参考。

参考视频：

【雷】Hugo + Github免费搭建博客，并实现自动化部署_哔哩哔哩_bilibili

Hugo

Hugo是由Go语言实现的静态网站生成器。简单、易用、高效、易扩展、快速部署，可以帮助用户快速构建高性能的静态网站，方便个人搭建博客，和个人网站等。Hugo在GitHub（ The world’s fastest framework for building websites.）上拥有超过75K stars，近千名贡献者，拥有活跃的社区，保证了Hugo成为当下最流行的静态网站生成器之一，正如其标题所说：“Hugo是世界上最快的构建网站的框架”。

Hugo下载

Hugo框架的下载有一些注意事项：

Hugo根据操作系统的不同有不同的下载方式

MacOS

brew install hug

Linux

sudo snap install hugo

Windows

choco install hugo-extended

上面的下载方式是官方推荐的，笔者的主要工作环境是Windows，但并不采用上述的下载方式，因为choco是一个包管理器，本身也需要下载（笔者不喜欢因为一个功能而去下载另一个功能，导致整个环境特别臃肿），可以采用以下方法去下载：

到Hugo的GitHub仓库中，找到Tags

选择最新的版本（本文创作时最新版本是v0.138.0）

一直往下滑，可以看到一堆Assets资源，找到Windows，且带有extended版本的，本文是根据Hugo框架下的stack主题来构建的，如果你查看过stack的官方文档，可以发现，其中也强调了是以哦那个extended（拓展）版本，才能完成该主题的全部功能搭建。
下载完成后，你会得到一个Hugo静态网站生成器的exe执行文件，该执行文件可以帮助你生成一个静态网站的全部内容。此步骤可做可不做：将hugo所在的目录放在系统环境变量path中。笔者是做了这一步的，这一步的作用是，无论你在那个目录下，都能使用hugo命令。如不添加，则当你生成了一个静态网站资源，你需要将hugo.exe文件拖入静态网站资源的目录下，以便你日后在在目录内调用hugo命令。

在控制台（如果没有添加环境变量，则需要在有hugo.exe的目录下执行）使用hugo version命令测试hugo是否安装成功，如果安装成功，则输出如下

1
2
3
4


D:\HugoBlog\dev>hugo version
hugo v0.136.5-46cccb021bc6425455f4eec093f5cc4a32f1d12c+extended windows/amd64 BuildDate=2024-10-24T12:26:27Z VendorInfo=gohugoio

D:\HugoBlog\dev>

创建新的站点

在cmd中（如果没有配置全局路径，在hugo.exe目录下使用该命令）使用命令

1

hugo new site yoursitename #yoursitename 是你的站点文件夹名称， 可以使用dev或自己起个名字

上面截图显示了创建新的站点成功，并且会给你一些提示，按照提示走就可以花很少的时间搭建出一个静态网站

Hugo会在这个D:\HugoBlog目录下自动新建一个名为AHugoBlogSite的目录，如下图所示：

进入AHugoBlogSite目录

1

cd AHugoBlogSite

挑选主题

Hugo下载好后，就可以开始挑选自己喜欢的主题，可以在Hugo官网下挑选（Complete List | Hugo Themes），每个主题都可以点进去查看详细信息与下载地址，笔者这里使用了stack主题，特别适合用于搭建个人博客网站。可以通过Hugo Themes中选中stack主题，进去Download，也可以在GitHub上直接搜索CaiJimmy/hugo-theme-stack: Card-style Hugo theme designed for bloggers，仿照上面下载hugo的方法找到对应位置下载源码（source code）压缩包即可。

如果有兴趣为该主题添砖加瓦的同学，也可以给这个主题作者提交Issues！

Stack

解压主题

将stack主题的源码解压到AHugoBlogSite\themes目录下（接下来为了方便，AHugoBlogSite统称为站点目录）。

将解压的目录名称中的版本号删除，改成像我一样hugo-theme-stack

值得注意的是，如果你想换其它主题，或者你一开始便不打算下载stack主题，操作也是一样的，同样将版本号删除，并将yaml配置文件中的主题改成对应的主题目录名称即可（后面会提及）

从主题文件中复制两个重要文件

在解压的目录（hugo-theme-stack）下，有一个样例目录名为：exampleSite，里面有两个非常重要的东西，一个是content目录，一个是hugo.yaml配置文件，将这两个文件复制出来

放到站点目录下

将原本的默认配置文件hugo.toml删除，用我们复制过来的hugo.yaml做配置文件

注意：在content\post\目录下，有一个rich-content的目录==删掉==，post目录下存放的就是你的博客内容，这个rich-content博客中做了一些引用Youtube的样例操作，可能会导致你运行失败，这些国外网站可能会导致你访问超时

修改配置

打开刚才复制过来的hugo.yaml

更换主题

可以看到，这里主题选择的是hugo-theme-stack，如果你想更换其它的主题，只需下载其它主题的源码到themes\目录下，并将配置文件中的主题换掉即可

以下笔者就不截图了，以代码段形式展现笔者修改了的部分:

笔者将url的重定向到自己的GitHub仓库，下一篇讲部署到GitHub上时会提及

1

baseurl: https://Lyrical-wander.github.io

修改了著作权，当然，这个著作权是指本博客的著作权，而非hugo也非该主题

1

copyright: Lyrical Wander

将默认语言修改为中文

1

DefaultContentLanguage: zh-cn

修改以下配置，据说可以更精确的计算读文章的时长

1

hasCJKLanguage: true

这里修改的是博客左上方的标题，有中英两个版本，但笔者的博客全是中文博客，还没有做国际化的打算

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


languages:
 en:
 languageName: English
 title: LyricalWander's Blog
 weight: 1
 params:
 sidebar:
 subtitle: We have a long life,but just own death and love
 zh-cn:
 languageName: 中文
 title: 苏三有春的博客
 weight: 2
 params:
 sidebar:
 subtitle: 人生茫茫，唯死亡与爱而已

这个参数是指一页展示多少篇文章

1
2


pagination:
 pagerSize: 5

你可以在static目录下存放你博客的图标，将名称改为favicon.ico

1
2


 favicon: /favicon.ico 
 # e.g.: favicon placed in `static/favicon.ico` of your site folder, then set this field to `/favicon.ico` (`/` is necessary)

以下参数是修改你的头像以及添加emoji（头像右下角的表情），首先将图片名称改为avatar.png，并添加到assets\img\目录下，如果没有img目录可自行创建，然后将参数修改：

1
2
3
4
5
6
7


 sidebar:
 emoji: 🧐 
 subtitle: Lorem ipsum dolor sit amet, consectetur adipiscing elit.
 avatar:
 enabled: true
 local: true
 src: img/avatar.png

修改下面的参数，可以添加或修改头像下面的快捷链接小图标，笔者增加了链接进入笔者B站主页和进入笔者CSDN主页的快捷链接，图标以SVG格式存放在assets\icons\目录下，值得注意的是，下面参数icon是图标的文件名去掉.svg，比如brand-bilibili.svg去掉.svg，如下:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


 social:
 - identifier: github
 name: GitHub
 url: https://github.com/Lyrical-wander
 params:
 icon: brand-github

 - identifier: bilibili
 name: Bilibili
 url: https://space.bilibili.com/28788259
 params:
 icon: brand-bilibili

 - identifier: csdn
 name: CSDN
 url: https://blog.csdn.net/whale_cat
 params:
 icon: brand-coinbase

现在我们创建我们的博客看看

命令：

1

hugo server -D

注意：

必须是在站点目录下使用该命令。（上面我们通过cd AHugoBlogSite进入了目录）

必须是D而不是d

运行命令后会出现以下信息

可以看见，通过访问http://localhost:1313即可访问博客

开始编写文章

文章目录结构

首先看一下文章目录结构，文章都保存在content目录下：

看看对应的网站结构：

其实无论是page，categories，post，都可以看作一个一级目录，然后每一篇文章，每一个分类，亦或者每一个侧边栏的选项，都是二级目录，二级目录下才是真正的内容，比如，在categories目录下：

有这么四个二级目录，分别代表了四个我已经创建并附带说明的分类

值得注意的是，你看我的博客分类有许多，比如网络爬虫，操作系统等，都没有在categories目录下创建，但在分类中依然存在，这是因为，我将某篇文章归类为网络爬虫，但是还没有创建这个分类，因此Hugo自动地帮我创建一个默认分类，把带有网络爬虫的文章收录在一起，但是这分类没有初始图片，没有说明，如下图所示：

这个分类中没有默认图片，也没有简介，技术杂谈这个分类就有，如下图所示

如何写博文

我写博文采用的是markdown格式，这个格式我非常熟悉，写起来也特别舒服，使用Typora工具，写markdown手感特别好。

makrdown格式没什么好说的，学起来也很快，在写博文的时候需要注意的是开头携带的信息，如下图所示：

这是文章开头的内容，上面我打开了typora的源码模式。如果是普通的编写模式，则是下面这个样子的：

可以看到，Typore自动的把---这个识别成分割线，把源码中用---包起来的内容用分割线与下面内容隔开。

在这里面，你需要注意的是：

title：文章标题

description：副标题，简介

date：编写日期

image：文章最上方的图片

categories：分类

tags：标签

分类和标签的内容可以是中文，可以多个，但需要采用[“xx”,“xx”]的格式

:后需要加一个空格，再输入内容

后面的就按照正常markdown创作即可

值得注意的是：

博文采用markdown格式，命名规则为：index.语言.md，这里因为我的默认语言是中文，就不用携带语言，即：‘zh-cn’，因此只需要命名为index.md即可。

总结

至此，你已经搭建了你的个人博客，并且可以开始写文章啦，更多关于stack主题的美化或修改可以看stack文档Stack | Card-style Hugo theme designed for bloggers

同时，下面一篇文章会介绍如何将博客部署到GitHub上，可以通过GitHub的pages功能，创建一个可以在公网访问的博客网站，很感谢你读到这里，祝你变得更强！

搭建自己的Wiki知识库

Mon, 18 Nov 2024 19:31:00 +0800

前言

前段时间，笔者因工作需要，尝试搭建了一个Wiki.js，将笔者的学习经历以及踩坑过程通过这篇文章分享给各位读者。

Wiki是一种允许多人共同编辑和管理内容的平台，可以让被授权过的用户在上面创建，修改和更新页面，实现协作和信息共享，广泛应用于教育，公司文档管理，项目合作等多个领域。

笔者选择采用Wiki.js，一个开源且美观的Wiki程序，在网上照猫画虎地用了docker技术下载安装在Ubuntu22.04系统中，如果你采用的配置和我一样，那么可能会遇到我遇到的这些坑。

参考文档：

Wiki.js

【实用的开源项目】使用服务器部署Wiki.js，一个美观且强大的开源Wiki程序-腾讯云开发者社区-腾讯云

华为开源镜像站_软件开发服务_华为云

Warning: apt-key is deprecated. Manage keyring files in trusted.gpg.d instead (see apt-key(8))-CSDN博客

docker pull 报错Get “https://registry-1.docker.io/v2/“: net/http: request canceled while waiting for c-CSDN博客

首先，笔者在本地虚拟机以及阿里云服务器（免费试用的）都尝试过部署Wiki.js。本地部署于云服务器部署都相同

请注意，接下来的内容中，如果是笔者强调注意的地方（笔者踩过坑的地方），都会以下方式呈现，注意：

这里是笔者踩过的坑：……

安装Docker

如果你需要在云服务器上部署，那么第一步是选择并购买服务器，现在在市面上的服务器有很多，笔者不做推荐。笔者使用的是阿里云的服务器，2核4G，Ubuntu22.04系统，预装LNMP应用。但是笔者看的看的笔记是腾讯云的，【实用的开源项目】使用服务器部署Wiki.js，一个美观且强大的开源Wiki程序-腾讯云开发者社区-腾讯云，但感觉大部分内容大差不差，在阿里云上业跑起来了，只不过没有做反向代理的那一步，因为自己使用，直接用IP:端口访问。

1.更新apt-get

因为笔者采用的是阿里云的云服务器，系统没有预装docker，所以我们要自己下载并安装docker。

首先更新一下包管理器，并安装必要的软件包curl

1
2


apt-get -y update
apt-get -y install curl

2.下载安装Docker-ce

接下来注意了：

笔者曾在这里踩过坑：根据上面腾讯云的内容，笔者是无法直接安装并docker的，笔者怀疑是镜像源的问题，现在许多国内镜像源在pull的时候都会出现报错，因此，笔者做了以下修改：华为开源镜像站_软件开发服务_华为云

笔者按照这篇文章下载的docker-ce

==但是！！！！！！！！！！！==

注意，笔者在服务器上下载完了几天后，开始写文章时重复操作，发现无法下载了！

发现没有，在华为云的文章中，使用了apt-key命令来添加GPG密钥，但现在，apt-key命令被弃用了！！

无法通过该命令来添加GPG密钥，因此笔者又上网冲浪了许久，在茫茫多的文章中终于找到了可以解决困境的办法

Docker：如何解决安装 docker 时 ubuntu 中的公钥错误 - Stack Overflow

【docker安装】由于没有公钥，无法验证下列签名： NO_PUBKEY 7EA0A9C3F273FCD8-CSDN博客

以上文章笔者实测，是可以解决添加GPG密钥时出现的apt-key is deprecated的问题。

具体命令是：
1
2
3
4
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
sudo chmod a+r /usr/share/keyrings/docker-archive-keyring.gpg
apt-get update
apt-get install docker-ce

3.启动Docker

执行以下命令启动docker

1

systemctl start docker

检查docker的运行状态

1

systemctl status docker

设置为开机自启动docker

1

systemctl enable docker

新版的docker自带了compose命令，即，你无需下载docker-compose，即可使用docker compose命令（注意中间是空格）

部署Wiki.js

1.新建目录

新建Wiki.js的存放目录，且移动到目录下

1

mkdir -p /opt/docker/wikijs && cd /opt/docker/wikijs && mkdir -p /opt/docker/docker_data/postgresql/data

这里新建了两个目录，一个是docker目录下的wikijs，一个是数据库的目录，数据库采用postgresql，具体数据库的差异笔者也需要去学习一下。

2.新建docker-compose.yaml文件

docker-compose.yaml文件是用来等会自动化下载的，按照这个文件中的配置下载Wiki.js并配好数据库。我们这使用nano命令来配置，因为在新安装的系统中，没有vim命令，如果想使用vim命令需要apt-get install vim先下载。

创建并编辑docker-compose.yaml文件

1

nano docker-compose.yaml

输入以下配置内容

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31


---
version: "3"
services:
 db:
 image: postgres:11-alpine
 environment:
 POSTGRES_DB: YourDatabaseName
 #设置一个自定义的数据库名以替换 smalljunwikijs 需与下方的 DB_NAME 一致！
 POSTGRES_PASSWORD: YourDatabasePassword
 #设置一个自定义的数据库密码以替换 wikijssmalljunpw 需与下方的 DB_PASS 一致！
 POSTGRES_USER: YourDatabaseUserName
 #设置一个自定义的数据库用户名以替换 smalljunwiki 需与下方的 DB_USER 一致！
 logging:
 driver: none
 restart: unless-stopped
 volumes:
 - /opt/docker/docker_data/postgresql/data:/var/lib/postgresql/data
 wiki:
 image: ghcr.io/requarks/wiki:2
 depends_on:
 - db
 environment:
 DB_TYPE: postgres
 DB_HOST: db
 DB_PORT: 5432
 DB_USER: YourDatabaseUserName
 DB_PASS: YourDatabasePassword
 DB_NAME: YourDatabaseName
 restart: unless-stopped
 ports:
 - 2078:3000

可以看到，这里我们需要下载两个东西，一个是db即database，一个是wiki即Wiki.js，端口开放为2078，即如果你想访问Wiki.js，则需要通过IP地址:端口号（2078）的形式访问，如果不做方向代理的话

编写完成后，按Ctrl + x退出，按y确认保存，按enter回车键退出

3.更改镜像源

原本到这里，按照文章的内容应该是开始运行命令下载

1

docker compose up -d

但是，因为没有使用国内镜像源，因此在下载的时候会：

笔者踩过的坑：

如果没有镜像源下载，那么将会出现：Get “https://registry-1.docker.io/v2/“: net/http: request canceled while waiting for c

网上大多数的镜像源都无法解决这个问题，以下两篇文章是笔者实践过可以的

彻底解决docker：docker: Get https://registry-1.docker.io/v2/: net/http: request canceled 报错-CSDN博客

docker pull 报错Get “https://registry-1.docker.io/v2/“: net/http: request canceled while waiting for c-CSDN博客

笔者综合了一下他们的镜像源，以下是笔者采用的镜像源，实践可以下载：

1
2
3
4
5
6
7
8
9


{
 "registry-mirrors": [
 "https://docker.1panel.live",
 "https://0dj0t5fb.mirror.aliyuncs.com",
 "https://docker.mirrors.ustc.edu.cn",
 "https://6kx4zyno.mirror.aliyuncs.com",
 "https://registry.docker-cn.com"
 ]
}

https://docker.1panel.live是第二篇文章博主提供的，这个镜像源可以让我成功地下载yaml配置中的db，即下载数据库，后面的镜像源采用的是第一篇博主的。它无法正常下载db，会报出上面的错误，但是可以下载wiki。

下载时间较长，根据笔者多次失败经历以及更换镜像源的经历，在下载过程中60s内没有爆出上述错误，且db于wiki的下载项都出现，即开始正常下载

什么叫“db于wiki的下载项都出现呢”，当你运行docker compose up -d命令后，会先出现 db与wiki两项在转圈圈，但是这两项下有许多文件需要下载，需要全部文件都展示出并显示等待下载，才算是开始正常下载。

访问Wiki.js

通过浏览器访问IP地址:2078即可访问你自己的Wiki.js。

在访问过程中，笔者也遇到了一些坑，首先介绍一下笔者的环境：

一台台式机，开着虚拟机运行Ubuntu环境下载了Wiki.js，想通过另一台计算机（笔记本）访问这个Wiki.js

笔者在网上查阅了大量文章，发现很多文章都是用的是NAT模式，然后通过与虚拟机与宿主机协同暴露指定端口供外接访问，因为虚拟机与宿主机是同一IP地址，因此必须要两者配合，但是宿主机又是Windows系统，因此协调起来比较麻烦，所以笔者采用了桥接模式，虚拟机拥有自己的IP地址，虚拟机可以直接访问外部网络。

获取IP地址

首先使用以下命令查看虚拟机的IP地址

1

ip addr show

或者使用

1

ifconfig

查看防火墙状态

使用以下命令查看防火墙状态，确保防火墙关闭

如果使用的是ufw

查看防火墙状态：

1

ufw status

关闭防火墙

1

ufw disable

小结

值得注意的是：

笔者踩过的坑：

通过这样的方式访问，需要虚拟机与访问虚拟机的机器在同一局域网下，否则的话是无法访问的，因为虚拟机并没有暴露在公网中

总结

在本次搭建的过程中，笔者也学到了很多东西：

安装Docker时出现大大小小各种错误，包括镜像源不行，下载过慢，GPG无法使用，apt-key命令被弃用等
在部署Wiki.js时，遇到的最重要的问题就是镜像源问题，虽然在最后笔者采用的镜像源帮助了笔者完整下载，但是在这之前，笔者浏览了许多文章（大多数都相似，使用阿里云的镜像源），都无法正常下载，真的很崩溃。
在最后写这篇文章时，笔者打算重新找回那些资料，发现自己浏览记录过多，许多资料和网站已经找不到了！这也是缺失之一，以后在解决某项问题的时候，希望保持良好习惯，点赞收藏，并及时开始写博客。

VSCode无法使用右键“用VScode打开文件夹”解决办法

Mon, 04 Nov 2024 09:45:00 +0800

前言

作者的编程环境为VScode，工作时常使用VScode打开整个工程文件夹。如果先打开VScode再从VScode中选择文件夹打开效率太慢，作者一般使用的方式是右键文件夹，直接选择"通过code打开文件夹"，但某天，作者同往常一样工作时发现快捷键不起效，桌面的快捷方式也变成了无法使用的状态。

通过设置索引回快捷方式的目标和起始位置，发现找不到对应的code.exe文件。这说明可能有以下几种情况：

VScode在我不知情的情况下被卸载了
VScode中code.exe执行文件被删了
VScode出于某种情况（可能是更新），将执行文件改了名字或移动了位置

更新VScode快捷方式

通过查找VScode的目录，发现code.exe文件从原本的Microsoft VS Code目录下移动到Microsoft VS Code\_目录下，多了一级目录，暂不清楚什么原因，因此桌面快捷方式不起作用，只需要将快捷方式的目标和起始位置做一下修改，桌面的快捷方式就可以重新使用了。

右键使用VScode打开文件夹

重装软件

重装软件确实是一个简单且有效的方法，如果你的VScode比较干净的话。但如果你安装了许多插件且配置了多个Python的虚拟环境（那可是一个大工程），那么放弃现在的VScode对你来说可能是一个噩梦。如果你是此类人，我推荐你使用下面的方法。

修改注册表

使用win + R打开运行，输入regedit打开注册表。

配置：右键使用vscode打开文件

你可以直接在左侧目录树下找到HKEY_CLASSES_ROOT\*\shell，也可以在上方地址栏中输入，索引到相应的目录中

在此目录下，shell目录下，执行以下操作：

右键目录新建VisualCode项（根据知乎大神的操作，但是我看原本VScode自动配置时是生成VSCode项，名字似乎无关紧要，重点是其中的数据。如果你本身就有VSCode项，可以尝试直接对VSCode项做修改，而不新建VisualCode项）
配置操作描述：VisualCode项中有一个名称为(默认)的数据，双击进去填写数值数据用VScode打开这个数据是你右键文件时出现的操作描述

这个描述可自定义，你改成用用全世界最好用的VScode打开也可以
配置图标：右键刚才新建的VisualCode项，在VisualCode中新建一个可扩充字符串值，双击该数据，将数值名称改为Icon，将数值数据修改为：Code.exe执行文件的地址，如我的地址为：

C:\Users\86153\AppData\Local\Programs\Microsoft VS Code_\Code.exe
配置命令：右键刚才新建的VisualCode项，在VisualCode项中新建一个项，命名为command，这个项中也会有一个默认值，双击默认，修改数值数据为："your\path\Code.exe" "%1"，注意：要有""引号，%1为要打开的文件参数

配置：右键使用vscode打开文件夹

找到HKEY_CLASSES_ROOT\Directory\shell目录。
除了更改目录，其它操作与上面的完全一样

配置：右键空白处使用vscode打开文件夹

找到HKEY_CLASSES_ROOT\Directory\Background\shell目录。
把command中的数值数据中的%1改成%V
其它操作与上面完全一样

效果

现在，你就可以使用右键文件夹，使用vscode打开该文件夹

参考文章：右键菜单加入用VSCode打开文件和文件夹 - 知乎

技术杂谈 on 苏三有春的博客

Hugo 博客维护踩坑记：主题迁移、暗色模式与 SCSS 优先级

为什么要用 Git Submodule

Git Submodule 是什么

Submodule 的实际优势

背景

第一步：把嵌入的主题改成 submodule + fork

坑一：submodule 指向的是 fork 的 v4.x，和博客用的 v3.9.x 不兼容

坑二：Hugo v0.152.2 废弃 API，直接编译失败

坑三：assets/scss/custom.scss 暗色模式覆盖不生效（重点）

坑四：部署日志显示成功，但 .github.io 仓库没更新

总结：Hugo 主题定制的优先级规则

附：本次改动总览

逆向工程实战，在反汇编中发生的事

前言

adpcm_decoder1函数

C代码

Decryption函数并非ADPCM的一部分

Decryption函数的参数问题

小结

decryption函数

C代码

数据本地化

第19到1的数据解码

local_30[*(int *)(&DAT_00019c0c + iVar4)]

local_30[*piVar1]

解码过程

第0个数据的解码

返回数据

总结

基于Hugo构建一个属于自己的博客（二）

前言

创建仓库

修改配置

上传代码

启用pages功能

小结

自动化部署

创建仓库

修改代码

创建.gitignore文件

生成token并创建yaml配置文件

上传代码

基于Hugo构建一个属于自己的博客（一）

前言

Hugo

Hugo下载

创建新的站点

挑选主题

Stack

解压主题

从主题文件中复制两个重要文件

放到站点目录下

修改配置

更换主题

开始编写文章

文章目录结构

如何写博文

总结

搭建自己的Wiki知识库

前言

安装Docker

1.更新apt-get

2.下载安装Docker-ce

3.启动Docker

部署Wiki.js

1.新建目录

2.新建docker-compose.yaml文件

3.更改镜像源

访问Wiki.js

获取IP地址

查看防火墙状态

小结

总结

VSCode无法使用右键“用VScode打开文件夹”解决办法

前言

更新VScode快捷方式

右键使用VScode打开文件夹

重装软件

修改注册表

坑三：`assets/scss/custom.scss` 暗色模式覆盖不生效（重点）

坑四：部署日志显示成功，但 `.github.io` 仓库没更新

local_30[(int )(&DAT_00019c0c + iVar4)]