Posts on Ceba's Blog

新博客，新起点：Hugo + Stack

Fri, 19 Sep 2025 02:00:00 +0800

从 2018 年创建至今，这个博客已经陪伴了我 8 个年头，在这里我记录了不少折腾的过程和点滴感悟。随着时间的推移，当初选择的 Hexo 和 Material 主题已经渐渐显得过时了。于是，我想着能否换个新的模板和生成器，顺便调整一下网站部署，给这个博客寻找个新的起点。

选择 Stack 主题和 Hugo

正如前面所提到的，hexo 和 hexo-theme-material 已经渐渐过时：

hexo-theme-material 的最后一个发行版 1.5.6 发布于在 2018 年，彼时 Google 的 Material 还能让人眼前一亮，到了今天就已经略显陈旧了
Hexo 本身版本演进速度十分缓慢，构建速度和扩展性也不尽人意，更何况 material 主题把 hexo 锁到了一个较早的版本上

但是，找一个或者造一个美观好用的模板也不是那么容易的。打开各大生成器的主题列表，一眼望去全是些个人自用的、略显简陋的主题，大多缺乏活跃的用户群体和维护支持。我不是前端专家，对现代前端技术一窍不通，让我自己糊一个主题实在是强人所难。在经过一番筛选和对比后，我最终找到了 Jimmy Cai 为 Hugo 编写的 Stack 主题，这个主题的设计风格非常对我的胃口，简洁而又现代，功能上也能满足我的大多数要求，就它了。

值得一提的是，Stack 主题对图片的支持非常强大，具备自动生成缩略图、响应式图片、懒加载等功能，还集成了 PhotoSwipe 插件，相比之前方便了不少。

至于 Hugo，说实话我对网站生成器倒没有那么在意，是选择 Stack 导向了选择 Hugo。不过 Hugo 一直在积极开发中，速度快、功能强，也确实非常令人满意。

适配和改造 Stack

选定主题和生成器之后，就该把文章迁移过来了，还需要对 Stack 进行一些适配和改造。我是从 Stack 官方提供的 Starter 模板开始的，下面都是基于此的改造。

文章目录迁移

Hugo 和 Hexo 的目录结构有一些差异，需要手动做一些处理。

之前的 hexo 采用以下的格式：

1
2
3
4
5
6
7


├── source
│ └── _posts
│ ├── 2018
│ │ ├── The-Way-to-Go
│ │ │ │── bg.jpg
│ │ │ └── pic.png
│ │ ├── The-Way-to-Go.md

文章存放在 source/_posts/ 文件夹内，并且按年份分目录存放文章，如 source/_posts/2018/
每个文章 article.md 都有一个同名的 article/ 文件夹，用来存放文章引用的图片等资源

讲道理，hexo 资源文件夹挺抽象的。在 Markdown 文件中引用图片时，要使用相对于资源文件夹的路径，而不是相对于 Markdown 文件的路径，这让人和 VSCode 都很难受。

Hugo 和 Stack 采用以下的格式：

1
2
3
4
5
6
7


├── content
│ └── post
│ ├── 2018
│ │ ├── The-Way-to-Go
│ │ │ ├── bg.jpg
│ │ │ ├── pic.png
│ │ │ └── index.md

文章存放在 content/post/ 文件夹内，可以按年份分目录存放文章，如 content/post/2018/
使用页面包（Page Bundles）格式，将文章内容 index.md 和资源放在同一个文件夹内

Hugo 的目录结构似乎很自由，顶层节（Top-level Sections）和页面包之间的目录似乎可以随意田间，于是我直接沿用了之前按年份分组文章的结构。

文章元数据迁移

Hugo 和 Hexo 的 Markdown 元数据格式是非常相似的，无非都是些 title、tag、categories、date之类的，只有个别需要稍微调整一下格式即可。

需要特别调整的主要是 Material 和 Stack 支持的文章头图功能，Material 用 thumbnail，Stack 用 image，而且相对路径格式略有不同，需要手动调整一下。另外，Stack 还支持一个 description 字段，用来给文章加上副标题/描述。

配置站点和主题

在 Stack Starter 模板的基础上调整一些 Hugo 的配置，以便适应使用习惯。Stack Starter 模板的配置用 TOML 格式编写，都放置在 config/_default/ 文件夹下。

首先要调整的是文章永久链接的格式，需要想办法和原博客保持一致。在 permalinks.toml文件（即 [permalinks]）中设置如下的配置项。其中，post 指顶层节，:slugorcontentbasename 是元数据中的 slug 和 basename（文章所在文件夹的名字）二选一。

1

post = "/:year/:month/:slugorcontentbasename/"

另外，Hugo 默认会把所有 URL 调整为小写，然而老博客中有不少文章是大小写混写的。在 params.toml 文件（即 [params]）中设置如下的配置项，关闭自动小写的功能。

1

DisablePathToLower = true

之前博客的评论使用的是 Gitalk，用 Github Issue 来充当评论区。这次切换到了 gitcus，改用 Github Disscussion 来充当评论区。通过 gitcus 的交互式工具获取参数，然后将参数填到对应的配置项即可。

以及，调整一下语言、CJK 支持等配置，修改一下网站标题、头像、版权等信息，在页脚加入备案号等等。这些都相对比较简单，就不在赘述了。

有一说一，TOML 格式真有点不是太习惯呢，各种嵌套关系让人眼花缭乱。Hugo 本身是支持 YAML、TOML、JSON 的，回头可能还是改回 YAML 吧。

更换前端 CDN 资源

Stack 使用的外部 CDN 资源大多来自 JSDelivr，然而这玩意儿在国内的访问性实在是不怎么好，十分有必要换个靠谱的 CDN。

我参考了这篇文章，添加了 data/external.yaml文件，通过 Hugo 的主题文件覆盖功能来修改调用的 CDN 资源。完整文件如下：

 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


Vibrant:
 - src: https://cdnjs.cloudflare.com/ajax/libs/node-vibrant/3.1.6/vibrant.min.js
 integrity: sha256-awcR2jno4kI5X0zL8ex0vi2z+KMkF24hUW8WePSA9HM=
 type: script

PhotoSwipe:
 - src: https://cdnjs.cloudflare.com/ajax/libs/photoswipe/4.1.3/photoswipe.min.js
 integrity: sha256-ePwmChbbvXbsO02lbM3HoHbSHTHFAeChekF1xKJdleo=
 type: script
 defer: true

 - src: https://cdnjs.cloudflare.com/ajax/libs/photoswipe/4.1.3/photoswipe-ui-default.min.js
 integrity: sha256-UKkzOn/w1mBxRmLLGrSeyB4e1xbrp4xylgAWb3M42pU=
 type: script
 defer: true

 - src: https://cdnjs.cloudflare.com/ajax/libs/photoswipe/4.1.3/default-skin/default-skin.min.css
 type: style

 - src: https://cdnjs.cloudflare.com/ajax/libs/photoswipe/4.1.3/photoswipe.min.css
 type: style

KaTeX:
 - src: https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/katex.min.css
 integrity: sha384-n8MVd4RsNIU0tAv4ct0nTaAbDJwPJzDEaqSD1odI+WdtXRGWt2kTvGFasHpSy3SV
 type: style

 - src: https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/katex.min.js
 integrity: sha384-XjKyOOlGwcjNTAIQHIpgOno0Hl1YQqzUOEleOLALmuqehneUG+vnGctmUb0ZY0l8
 type: script
 defer: true

 - src: https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.9/contrib/auto-render.min.js
 integrity: sha384-+VBxd3r6XgURycqtZ117nYw44OOcIax56Z4dCRWbxyPt0Koah1uHoK0o4+/RRE05
 type: script
 defer: true

Cactus:
 - src: https://latest.cactus.chat/cactus.js
 integrity:
 type: script
 - src: https://latest.cactus.chat/style.css
 integrity:
 type: style

现阶段，国内几乎没有靠谱的公共前端 CDN 库了，要么是因为被灰产滥用而被迫关闭，要么是之前出现过供应链投毒的事件。参考文章用的是 baomitu，然而它的主页已经被关闭很久了，看起来也不是很稳定。在多方考虑后，我最终选择了 cdnjs，由大慈善家 Cloudflare 托管，速度和可靠性都让人放心。

此外，我并没有按照参考文章去掉用于校验文件完整性的 integrity 字段。毕竟，供应链投毒是真发生过，而且 cdnjs 也支持这个特性。

调整页面样式

说是调整页面样式，实际上我只调整了一下背景颜色。Stack 原始的背景色是 #f5f5fa，灰偏蓝，看起来有一些粉，我调整成了正灰色 #f5f5f5。在文件 assets/scss/custom.scss 中添加

1
2
3


:root {
 --body-background: #f5f5f5;
}

部署到腾讯云 EdgeOne Pages

因为我的网站已经做了备案，加上需要考虑国内访问的可用性，那就必须得考虑使用国内的云服务了。

我的网站最初是用国内代码托管网站 Coding.net 提供的 Pages 服务，体验与 Github Pages 相差不大。但后来 Coding.net 被腾讯云收购，Pages 服务也经过几轮调整，最终被自动迁移到了腾讯云的 OSS 对象存储 + CDN 内容分发网络。

一开始，腾讯云 OSS + CDN 的整体还是挺好的，代码推送到 coding.net 能自动部署到 OSS，一个月也就几毛钱的费用。后来某一天自动部署消失了，更新博客得手动上传 OSS。去年还出现了一个山西 PCDN 狂刷下载的事情，一个月给干掉了一百多块钱，CDN 本身没啥靠谱的拦截机制。这些麻烦事儿还是让人很是不爽。

腾讯云推出了下一代内容分发网络 EdgeOne，功能上与 Cloudflare 十分相似。除了更好的 CDN 加速和更好的 DDoS 防护外，EdgeOne 还提供了一个 Pages 的功能。EdgeOne 有免费版，不限时间、不限流量，但需要通过兑换码才行。我当时是买 50 块钱的海外服务器就可以领 EdgeOne 免费版兑换券，现在似乎改成了每周抽选。总之，经过一番试用，我决定将博客部署到 EdgeOne Pages 上。

现在博客的源码放在了 GitHub 的私有仓库里，用 GitHub Action 进行构建，构建结果推送到 gh-pages 分支。EdgeOne Pages 可以授权访问 GitHub 的仓库，并在 gh-pages 分支变化时自动部署。

其实 EdgeOne Pages 是自带构建功能的，但我不是很想在腾讯云上折腾 Hugo 依赖的安装，于是就在 GitHub 上直接构建了。

新的写作计划与展望

有了新的博客，自然也要多写点东西。写作这件事，往往是越写越顺，越不写就越难下笔。接下来还是争取每个月至少写一篇文章，锻炼一下自己的写作能力。目前我已经有两篇准备写的文章了，加油吧）

参考

使用 AMT + PXE + Alpine 抢救一台远程 Proxmox VE 服务器

Fri, 21 Feb 2025 11:05:19 +0000

试图给一台远程的非空的 Proxmox VE 主机改名，改完名重启。然而 Proxmox VE 的配置文件目录是跟主机名强绑定的，于是不出意料的炸了。现在是 web 页面访问不了，ssh 连不上去（提示密钥错误），非常崩溃。

这个问题修起来也不是很容易。Proxmox VE 已经不能正常启动了，得想办法用其他启动盘启动，然后挂载主机硬盘把主机名改回去。可惜机器在 1000 公里外的家里，没法自己去操作，也很难让家里人帮忙操作……

好消息是，家里另外一台机器我还能连上，挂掉的这台机器开启了 Intel AMT 主动管理功能。那么，如果我通过 AMT 连接到挂掉的这台机器上，让她以网络启动，那么是不是就能救活她了？

远程救援的理论基础

在开始实操救援之前，先让我们理一理救援的理想过程，看看都需要配置哪些服务、解决哪些问题。

使用 Intel AMT 将被救援主机重启到网络引导（PXE）模式
PXE 程序发送 DHCP 请求，获得 IP 地址、下一步服务器地址next-server、引导程序文件名filename
PXE 程序使用 TFTP 协议从 next-server 下载 filename 指定的引导程序（iPXE），然后运行 iPXE
iPXE 通过 TFTP 协议从 next-server 下载 autoexec.ipxe 脚本，根据脚本通过 HTTP 下载 Alpine 的 Linux 内核、initramfs，启动内核并传递指定的内核参数
Alpine 根据内核参数配置 ssh 密钥、软件包仓库镜像地址，并下载并加载 modloop（打包好的额外的内核模块），最终完成初始化进入登录界面
通过 Intel AMT Serial over LAN 或者 SSH 连入 Alpine
安装 zfs 工具，导入 Proxmox VE 的启动池，挂载相关数据集，修改罪魁祸首 /etc/hosts
卸载数据集，导出池，关机，重启后 Proxmox VE 恢复正常。

使用 Intel AMT 连接到被救援服务器

之前部署这台服务器的时候，专门进 BIOS 里打开了 AMT 功能，现在想来真是有先见之明。这里简要介绍下 AMT 的启用流程：

在启动菜单中，选择进入 BIOS 设置（Computer Setup），找到 Advanced、Remote Management Options，确保 Active Management（AMT）被打开
在启动菜单中，选择进入 Intel Management Engine 设置
- 默认密码是 admin，登录后修改密码，要求必须是带有数字、字母、符号的强密码
- 启用需要的功能，应该不需要改太多

首先我们尝试用 AMT 连接到服务器。可以直接用浏览器访问服务器的 16992 端口外，还可以使用使用开源的 Intel AMT 客户端 MeshCommander。我们后续都使用后者。输入服务器 IP 和密码，顺利连上。

坏消息是，我的这台 HP 机器上没有 KVM（键盘、视频、鼠标）的选项，远程管理仅能用 Serial over LAN（SoL）远程串口功能。我在互联网上翻了一圈，大概是因为这台机器原装是 i3 处理器，不具备 Intel vPro 功能，于是 HP 直接在主板 BIOS 里干掉了 KVM 功能，后面再换 i5、i7 处理器也用不了 KVM 了。这个可以通过修改 BIOS 芯片数据来实现（参考1，参考2），只不过当时没时间搞了……

对 SoL 进行了一系列探索，发现 Reset to BIOS 时能够让 SoL 有正常输出，可惜是乱码。盲操修改了语言，这下能看到正常的启动菜单了。

启动菜单可以选择 Network (PXE) Boot，也可以在电源操作里选择 Reset to PXE 。

配置 dnsmasq（DHCP 和 TFTP）

我们已经能够用 AMT 让服务器从 PXE 引导，接下来配置 PXE 启动所需的 DHCP 和 TFTP 服务。在 PXE 启动中，DHCP 用于下发 next-server、filename 等启动参数，TFTP 用于传输引导文件。

这里的 DHCP 就是那个自动分配 IP 地址的 DHCP，那么就有个问题：在家庭网络环境中，路由器往往仅提供了基础 DHCP 服务，无法扩展 PXE 所需的配置项；若禁用路由器的 DHCP 功能、部署独立的 DHCP 服务器，则可能有网络全面断联的风险。为解决这一问题，我们使用 Proxy DHCP 技术：当客户端发出 DHCP 请求时，原有 DHCP 服务器仍下发 IP 地址，Proxy DHCP 服务器补充下发 PXE 所需的附加参数，两者协同工作。现代 PXE 网卡应该都支持 Proxy DHCP。

我准备了一台全新的 Ubuntu 24.04 虚拟机用来提供网络启动所需的一切服务，使用 dnsmasq 来同时提供 DHCP 和 TFTP 服务。

1
2
3
4


# 安装 dnsmasq
apt-get install dnsmasq
# 查看 dnsmasq 服务状态
systemctl status dnsmasq

配置 dnsmasq，以启用 proxy DHCP 和 TFTP。将下面的配置文件保存到 /etc/dnsmasq.d/pxe.conf。

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


# Disable DNS Server
port=0

# Enable TFTP server, setup root path
enable-tftp
tftp-root=/var/ftpd

# Enable DHCP logs
log-dhcp

# Enable Proxy DHCP Server
# proxy enables Proxy DHCP mode
# 192.168.230.0 and 255.255.255.0 are my subnet and mask
dhcp-range=192.168.230.0,proxy,255.255.255.0

# setup pxe for x86-64 EFI, load ipxe.efi from TFTP server
pxe-service=X86-64_EFI,"Network Boot UEFI x86_64",ipxe.efi

这里我只为 UEFI 做了配置（因为我的服务器就是 UEFI 启动的）。更多配置项可以仔细阅读 /etc/dnsmasq.conf 或者 dnsmasq 的 man 页面。

接下来创建 TFTP 根目录、让 dnsmasq 检查配置文件、重启 dnsmasq 服务。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 创建 TFTP 根目录 /var/ftpd
mkdir -p /var/ftpd

# 检查 dnsmasq 配置文件
dnsmasq --test

# 重启 dnsmasq 服务
systemctl restart dnsmasq

# 再次检查 dnsmasq 服务状态
systemctl restart dnsmasq

然后就可以在虚拟机尝试进行 PXE 启动了！虚拟机的 BIOS/PXE 会抱怨找不到 ipxe.efi 文件（这个我们下一步去搞），但它已经知道了要去哪里找引导文件。也可以再去看看 dnsmasq 的日志，应该也能找到它类似的抱怨。

一定要先在虚拟机尝试 PXE 启动，确保所有组件部署完成、一切无误后再去救援实体机。

把虚拟机的磁盘、光盘设备都删光，它自然会去尝试 PXE 启动。

配置 iPXE

iPXE 是一个更高级的网络启动固件，能够直接通过 HTTP 协议下载引导文件，比 TFTP 要快许多。我们用 PXE 引导 iPXE，然后再让 iPXE 启动 Linux 内核。

除了 iPXE，还可以选择 pxelinux 来启动 Linux 内核，具体参考 Ubuntu 的网络启动指南。我选择 iPXE 单纯是我参考的博客选择了 iPXE，实际上 pxelinux 使用更广泛一点）

我们从源码构建 iPXE，并把编译好的 iPXE 放到 TFTP 根目录。

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


# 安装必要的工具
apt-get install git make binutils mtools perl libc-dev gcc

# 获取源码
git clone https://github.com/ipxe/ipxe.git
cd ipxe/src

# 为 x86-64 EFI 构建
make bin-x86_64-efi/ipxe.efi

# 把编译好的 ipxe.efi 复制到 TFTP 根目录
cp bin-x86_64-efi/ipxe.efi /var/ftpd/

接下来就又可以在虚拟机尝试启动了！你应该能看到 iPXE 的输出，并且它在抱怨找不到任何可以启动的东西。

iPXE 会尝试从 TFTP 服务器获得 autoexec.ipxe，它抱怨的就是找不到这个文件。跟前面一样，这里也可以去看看 dnsmasq 的日志。稍后我们在配置 Alpine 时会去搞这个文件。

配置 HTTP 服务器

前面我们提到 iPXE 可以通过 HTTP 服务器来下载引导文件，实际上 Alpine Linux 启动过程中也需要从 HTTP 下载文件。我们需要部署一个 HTTP 服务器，这里选择最简单的 Apache2.

1
2


# 安装 
apt-get install apache2

Ubuntu 的 Apache2 开箱即用，不需要什么配置。其默认根目录是 /var/www/html，稍后我们就会把 Alpine Linux 的各种文件丢进去。现在，打开浏览器访问服务器地址，应该能看到它的默认页。

配置 Alpine Linux

Alpine Linux 是一个新兴的 Linux 发行版，主打轻小、简单、安全，挺适合当救援系统的。

选其他发行版来搞救援也行，比如 Ubuntu。这里选 Alpine 单纯是看到了相关的博客。

获取 Netboot 文件

Alpine Linux 本身就提供了 Netboot 的版本，从它的下载页下载，直接解压到 HTTP 服务器根目录里。

1
2
3
4
5


# 下载 Alpine v3.21 netboot 版
wget https://dl-cdn.alpinelinux.org/alpine/v3.21/releases/x86_64/alpine-netboot-3.21.3-x86_64.tar.gz

# 直接解压到 HTTP 服务器根目录 /var/www/html
tar -xzf alpine-netboot-3.21.3-x86_64.tar.gz -C /var/www/html

解压后应该能得到如下文件：

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


.
└── boot
 ├── config-6.12.13-0-lts # 内核配置
 ├── config-6.12.13-0-virt
 ├── dtbs-lts # 设备树（对于 x86 没用）
 ├── dtbs-virt
 ├── initramfs-lts # 初始内存文件系统
 ├── initramfs-virt
 ├── modloop-lts # 额外的内核模块
 ├── modloop-virt
 ├── System.map-6.12.13-0-lts # 内核符号表
 ├── System.map-6.12.13-0-virt
 ├── vmlinuz-lts # 内核
 └── vmlinuz-virt

所有文件都有 lts 和 virt 结尾的两份，lts 是标准版，virt 是针对虚拟机裁剪的版本，我们后面总是使用前者。这些文件中，我们实际上只使用下面 3 个：

1
2
3


vmlinuz-lts
initramfs-lts
modloop-lts

记得检查所有文件的权限，确保它们都能通过浏览器下载。

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


ls -l
# total 275M
# -rw-r--r-- 1 ceba ceba 265K Feb 13 23:06 config-6.12.13-0-lts
# -rw-r--r-- 1 ceba ceba 146K Feb 13 23:06 config-6.12.13-0-virt
# drwxr-xr-x 2 ceba ceba 4.0K Feb 13 23:06 dtbs-lts
# drwxr-xr-x 2 ceba ceba 4.0K Feb 13 23:06 dtbs-virt
# -rw------- 1 ceba ceba 24M Feb 13 23:06 initramfs-lts <-- 权限不足
# -rw------- 1 ceba ceba 8.6M Feb 13 23:06 initramfs-virt <-- 权限不足
# -rw-r--r-- 1 ceba ceba 189M Feb 13 23:06 modloop-lts
# -rw-r--r-- 1 ceba ceba 20M Feb 13 23:06 modloop-virt
# -rw-r--r-- 1 ceba ceba 6.3M Feb 13 23:06 System.map-6.12.13-0-lts
# -rw-r--r-- 1 ceba ceba 5.7M Feb 13 23:06 System.map-6.12.13-0-virt
# -rw-r--r-- 1 ceba ceba 12M Feb 13 23:06 vmlinuz-lts
# -rw-r--r-- 1 ceba ceba 12M Feb 13 23:06 vmlinuz-virt

# 补足权限
chmod 644 initramfs-lts initramfs-virt

另外，往 HTTP 服务器根目录下丢一个公钥文件 ssh_key，用于稍后 SSH 登录。

配置 iPXE 启动脚本

创建 autoexec.ipxe 文件，放在 TFTP 根目录 /var/ftpd 下。

 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


#!ipxe

# Init networking
dhcp

# Server address
set server http://192.168.230.12
echo server is ${server}

# Set command line 
set cmdline modules=loop,squashfs quite
echo cmdline is ${cmdline}

# Kernel file
set vmlinuz ${server}/boot/vmlinuz-lts
echo vmlinuz is ${vmlinuz}

# Initramfs file
set initramfs ${server}/boot/initramfs-lts
echo initramfs is ${initramfs}

# Modloop file
set modloop ${server}/boot/modloop-lts
echo modloop is ${modloop}

# Repository for apk
set mirror http://mirrors.ustc.edu.cn/alpine
set branch v3.21
set repo ${mirror}/${branch}/main
echo repo is ${repo}

# Set SSH key
set ssh_key ${server}/ssh_key

# Uncomment this if you want to see the information before continuing
# prompt Press any key to continue

#Kernel, initrd
kernel ${vmlinuz} ${cmdline} alpine_repo=${repo} modloop=${modloop} initrd=initramfs-lts ssh_key=${ssh_key}
initrd ${initramfs}

#Boot
boot

#Pause if errors
prompt Some error occurred, press any key to continue

对于 ZFS 的额外处理

我的 Proxmox VE 是装在两块 NVME 盘组的 zfs 阵列上的，我的救援系统就必须有 zfs 支持，包括 zfs 内核模块和 zfs 工具。然而，netboot 版的 Alpine Linux 并没有自带 zfs 内核模块，我在启动后尝试用 apk 安装会报莫名其妙的错误，救援一下子陷入了僵局。

机缘巧合下，我发现 Alpine Linux 的 Extended 版带有 zfs 模块，那么把 Extended 和 Netboot 整合一下是不是就可以了？我注意到：

两者的 lts 内核完全一致（通过比较 config 和 md5sum）
两者的 initramfs 各有千秋（通过 lsinitramfs）
Extended 比 Netboot 的 modloop 多了一些模块，其中包括 zfs （通过 unsquashfs -l）

那么可以试着用 Extended 的 modloop 替换掉 Netboot 的 modloop，具体如下：

下载 Extended 的 ISO，挂载到文件系统，找到 boot/modloop-lts，替换掉原来的文件；
在 autoexec.ipxe 作以下可选修改
- command 的 modules选项修改为 modules=loop,squashfs,zfs，以自动加载 zfs 内核模块
- kernel 命令中添加 modloop_verify=no，关闭 modloop 校验

这下 Alpine 就有 zfs 模块了。

启动！

现在，可以在虚拟机上做最后的测试了。经过漫长的启动后，如果没有意外，应该能看到这样的登录画面。用户名是 root，没有密码。

Alpine 默认开启了 ssh 服务器，可以用 ssh 连接，前面添加的 ssh 公钥此时派上用场了。

到此，一切就绪，可以尝试在物理服务器上进行 PXE 启动了。

救援 ZFS

通过 ssh 连接到被救援服务器，安装相关工具，挂载 zfs 文件系统，进行必要的修改。

 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


# 安装 zfs 命令行工具
apk add zfs

# 查看 zfs 状态
zfs status

# 搜寻磁盘上的 zpool
zpool import

# 导入指定的 zpool
zpool import rpool

# 查看 zfs 文件系统信息
zfs list

# 挂载文件系统
mkdir -p /root/rpool
mount -F zfs rpool/ROOT/pve-1 /root/rpool

# 做修改
vi /root/rpoll/etc/hosts

# 卸载文件系统
umount /root/rpool/

# 导出 zpool
zpool export rpool

# 关机
poweroff

用 Intel AMT 再次启动服务器，web、ssh 全部恢复正常，救援成功！

结语

这次远程救援花了好几天时间，最终省下了 1000 块钱的车票，总是值得的。

Intel AMT 还是好用的，不过我下次回家一定得把 KVM 功能恢复了，SoL 的可用性实在堪忧啊。另外，从 MeshCommander 的网站上看到，它的开发者在 2022 年的时候被 Intel 裁掉了，真是令人唏嘘。

希望这篇文章对你有所帮助~

参考

这两篇文章是我 PXE 启动 Alpine Linux 的主要参考，感谢 apalrd。
- Setting up a Netboot (PXE) Server for Alpine Linux :: apalrd’s adventures
- Net Booting the Proxmox VDI Client (feat. Alpine Linux) :: apalrd’s adventures
- 如果你需要更复杂的无盘 Alpine Linux，可以参考第二篇。
有关 Alpine Linux 网络启动的官方文档
- Netboot Alpine Linux using iPXE - Alpine Linux
- PXE boot - Alpine Linux
有关 dnsmasq 的配置
- dhcp - dnsmasq configuration for TFTP + ProxyDHCP in Ubuntu Server 22.04.3 LTS - Ask Ubuntu
- Proxy DHCP with dnsmasq - Fog Project Documentation (FOG Docs)
有关 Alpine Linux + ZFS 的文章
有关 ZFS 操作的材料
- Finding old zfs pool on disks | The FreeBSD Forums
- Oracle Solaris 管理：ZFS 文件系统

搞台 NAS (4)：Openmediavault 通过 Docker 部署 qBittorrent

Sat, 09 Jul 2022 01:20:19 +0000

在前两篇文章中，我们安装了 Openmediavault、部署了 ZFS 文件系统，这次我们将会用 Docker 容器部署 BT/PT 下载应用——qBittorrent。NAS 下载 BT/PT 是我的核心需求，使用 Docker 部署这类应用应该算是常规操作。

OMV 部分总共分为三篇文章，这是第 3 篇：

Openmediavault 的安装与配置
Openmediavault 部署 ZFS 文件系统
Openmediavault 通过 Docker 部署 qBittorrent

安装 Docker

点击左侧“系统”、“omv-extras”、“Docker”，点击“安装”按钮，开始安装进程。安装完成后，回到同一界面，应该能看到提示状态是“已安装、运行中”，版本号应当不低于 20.10.17。

如果发现版本号低于 20.10.17，请点击“移除”按钮，移除当前版本的 Docker。使用 ssh 连接到服务器，运行下面的命令安装 Docker：

1

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

Docker Hub 镜像加速

推荐添加阿里云、中国科大的容器镜像，以加快 Docker Hub 上的镜像拉取速度。编辑 /etc/docker/daemon.json 这个文件，在其中添加如下一项：

1

"registry-mirrors": ["https://ustc-edu-cn.mirror.aliyuncs.com/"]

修改后的文件形如：

1
2
3
4


{
 "data-root": "/var/lib/docker",
 "registry-mirrors": ["https://ustc-edu-cn.mirror.aliyuncs.com/"]
}

然后重启 Docker 服务：

1

sudo service docker restart

踩到的坑与捉到的虫

这段内容可以略过:)

我当初用上面的办法安装好 Docker 之后，发现我没有办法启动任何 Docker 容器，会报如下错误：

1
2
3
4


ceba@openmediavault:~$ sudo docker start portainer
Error response from daemon: AppArmor enabled on system but the docker-default profile could not be loaded: running `apparmor_parser apparmor_parser --version` failed with output:
error: exec: "apparmor_parser": executable file not found in $PATH
Error: failed to start containers: portainer

我寻找了许多材料、尝试了许多办法来解决这个问题，包括缺少安装 apparmor，但都无济于事。后来找到了这篇帖子，发现到我通过 OMV-Extras 插件安装的是一个巨大古老的 Docker 版本（v20.10.5）。于是根据帖子提示，手动执行了安装命令，终于解决了这一问题。

但我还是很好奇为啥会装上这么古老的 Docker。我检查了 OMV-Extras 安装 Docker 时的输出，发现这个家伙竟然是从 Debian 源安装 docker.io，而不是从 Docker 源安装 docker-ce，前者已经是上古时代的东西了。

我在 OMV-extras 的仓库翻了翻，发现了下面这段代码：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


 setDockerPackages()
 {
 if [[ "${arch}" == "i386" ]] || ! grep -q 'download.docker.com' ${omvextrasList}; then
 # there is no i386 docker-ce package in the docker repos 
 # if docker repos are disabled, use debian repos as well 
 # use docker.io from Debian repo 
 dockerPackages="docker.io docker-compose ${dockerPackages}"
 else
 dockerPackages="docker-ce ${dockerPackages}"
 fi
 }

这段代码竟然直接根据源列表中是否含有 download.docker.com 这个字符串来决定 Docker 包名……我之前更换 OMV-extras 软件源的时候就修改了 Docker 的镜像仓库，清华 TUNA 源里显然并不包含 download.docker.com 这个字符串，于是 OMV-extras 就以为没有 Docker 源，选择了从 Debian 源安装。

真相大白，于是跑去写了个 Issue。很快啊，不到二十分钟，人家就修完提交了，顺带也把 Issue 关掉了。

现在大概是没有这个 bug 了。

部署 qBittorrent

我们使用 linuxserver 制作的 linuxserver/qbittorrent 镜像，使用 docker compose 部署。

通过 ssh 登入服务器，拉取 linuxserver/qbittorrent 镜像：

1

sudo docker pull linuxserver/qbittorrent:4.4.1

然后在主目录下建立 qbittorrent 文件夹，在其中建立 docker-compose.yml，内容如下：

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


---
version: "2.1"
services:
 qbittorrent:
 image: linuxserver/qbittorrent:4.4.1
 container_name: qbittorrent
 environment:
 - PUID=998  # 数据卷所有者的 id
 - PGID=100  # 数据卷所属用户组的 id
 - TZ=Asia/Shanghai  # 时区
 - WEBUI_PORT=8080  # Web 界面端口，须和下方保持一致
 volumes: # 数据卷挂载，帽号前面是宿主机，帽号后面是容器内
 - /main/test/qbittorrent-config:/config  # 配置文件目录，根据需要修改帽号前内容
 - /main/test/downloads:/downloads  # 下载文件目录，根据需要修改帽号前内容
 ports:
 - 8080:8080 # Web 界面端口，须和上方保持一致
 - 26881:26881 # BT/PT 下载用通信端口，根据需要设置
 - 26881:26881/udp  # BT/PT 下载用通信端口，根据需要设置
 restart: unless-stopped
 network_mode: host  # 网络模式，改为 host 模式

这里我们选择了 qBittorrent 的 4.4.1 版本，它是 linux 下最后一个使用 Qt5 的版本。随后的版本使用了 Qt 6.3.0，但这个版本的 Qt6 存在 bug 导致 RSS 订阅功能不可用。最新的 qBittorrent 4.4.3 尚未更换 Qt 版本，只能先用这个较老的版本凑活凑活了。

PUID、PGID 是用于解决挂载数据卷权限问题的两个环境变量，PUID 设为数据卷所有者的 id，PGID 设为数据卷所属用户组的 id。在这里，数据卷所有者之前已改为 admin，id 是 998；用户组是 users，id 是 100。可以通过 id user 命令来查看。

数据卷理论上可以挂载到任意位置，但通常都是会放在文件系统之中的，相对更加安全一些。这里就放在了 test 数据集下面的两个目录里。

网络模式强烈改为 host 模式，这样就会直接使用主机网卡，好处多多：可以直接使用 IPv6 地址，不用再碰 Docker 糟糕的 IPv6 支持；少过一层虚拟网卡，性能更好，连接性更优。PS：我当初找了一堆资料研究 Docker 怎么开 IPv6，后来发现用 host 模式直接解决了。

准备好 docker-compose.yml 文件后，在它所在的目录下（即 qbittorrent）运行下面的指令，启动编组：

1

sudo docker compose up -d

然后就可以打开浏览器，访问 <your_nas_ip>:8080 来看看能否打开 qBittorrent 的界面啦。默认的登陆用户是 admin，密码是 adminadmin。

登录进去之后就可以随便玩耍了，随便塞个新番的 BT 种子试试看。

修改 Hosts

考虑到网络环境，有必要给一些 BT、PT 网站手动设置 Hosts。/etc/hosts 这个文件是由 OMV 自动管理的，需要稍稍绕点弯路。

首先新建 /etc/hosts2 文件，里面填好需要设置的 Hosts 内容。然后再新建文件 /srv/salt/omv/deploy/hosts/20myentries.sls，内容如下：

1
2
3
4


append_custom_hosts:
 file.append:
 - name: "/etc/hosts"
 - source: "/etc/hosts2"

随后运行 sudo omv-salt deploy run hosts 命令，即可使上面的设置生效。可以再次查看 /etc/hosts 文件，hosts2 的内容应该已经填充到其中了。

结语

在完成 qBittorrent 的部署之后，openmediavault 的折腾之旅算是告一段落了。本来还应该折腾折腾虚拟化，但实在使不想搞了。希望这几篇文章能给想要使用 OMV 的同学一些帮助，让大家少踩一些坑。

溜了溜了，这就去换 TrueNAS。

参考资料

Can’t run docker containers after upgrade to v6. AppArmor missing". Openmediavault Forum.
Something went wrong trying to pull and start portainer on OMV 6. Openmediavault Forum.
Can’t get any dockers to run without privileged mode on ProxMox kernel, please help. Openmediavault Forum.
Docker images can’t network when using Proxmox kernel. Openmediavault Forum.
Request: OMV only partially rewrite /etc/hosts. Openmediavault Forum.
linuxserver/qbittorrent. Docker Hub.
Kavindu Narathota. Let’s install qBittorrent on Docker. medium.com.
Elsa Granger. Docker IPv6. www.elsagranger.com.
曾大仁. docker 容器开启ipv6. 知乎.
Enable IPv6 support. Docker Document.
ungleich virtualisation team. How to enable IPv6 in docker. ungleich.ch.
咕咕鸽. 【有用的小知识】Docker-qBittorrent 开启IPv6 笔记. blog.laoda.de.
咕咕鸽. 【好玩的Docker项目】10分钟搭建你专属的下载神器——qbittorrent. blog.laoda.de.
geniusjoe. omv 家用 nas 搭建[2]， qbitttorrent 部署. 知乎.
RSS feeds do not work with qt6. Github repo qbittorrent/qBittorrent Issue.
The way to determine Docker packages when install Docker. Github repo OpenMediaVault-Plugin-Developers/openmediavault-omvextrasorg Issue.

搞台 NAS (3)：Openmediavault 部署 ZFS 文件系统

Fri, 08 Jul 2022 21:45:50 +0000

在上一篇文章，我们装好了 Openmediavault，完成了基本的配置，安装了 Openmediavault 插件，这次我们就可以开始尝试部署 ZFS 文件系统了。在 OMV 上使用软 RAID 加 ext4 或者 btrfs 是完全够用的，我这纯粹是听了群友的鬼话非要折腾 ZFS。ext4、btrfs 等其他文件系统的使用方法，可以参照参考资料中的介绍。

OMV 部分总共分为三篇文章，这是第 2 篇：

替换 Proxmox 内核

Proxmox 内核（即 pve 内核）对 ZFS 文件系统的支持要更好。要使用 ZFS 文件系统，首先需要将 Debian 内核替换为 Proxmox 内核。

PS：踩的坑之一，不换 Proxmox 内核，ZFS 跑不起来……

安装 openmediavault-kernel 插件

安装完成后，按下 Ctrl + Shift + R 或者 Ctrl + F5 强制刷新页面缓存，然后可以在左侧“系统”菜单下看到“内核”项。

安装 Proxmox 内核

点击左侧“系统”、“内核”，点击右侧“Proxmox”图标，选择“安装 Proxmox 内核”一项，开始安装进程。

安装完成后，刷新页面，可以看到 pve 内核已是默认。

点击右上角电源图标，重启系统。如果能够正常进入系统，就可以移除常规内核了。

清理其他内核

点击左侧“系统”、“内核”，点击右侧“Proxmox”图标，选择“移除非 Proxmox 内核”一项，开始清理其他内核。

刷新页面后，可看到只有 pve 内核了。这里可以考虑再重启系统一次。

安装 ZFS 文件系统支持

禁用 backports 源

PS：踩的坑之二，不禁用 backports 源，ZFS 装不上……

点击左侧“系统”、“omv-extras”、“设置”，取消勾选“Backports”选项，点击保存，二次确认应用。

安装 openmediavault-zfs 插件

点击左侧“系统”、“插件“，在右侧搜索“zfs”即可找到 openmediavault-zfs 插件。选中 openmediavault-zfs，点击“安装”按钮，确认安装。

安装完成后，按下 Ctrl + Shift + R 或者 Ctrl + F5 强制刷新页面缓存，然后可以在左侧“存储器”菜单下看到“zfs”项。

创建 ZFS 存储池、数据集

ZFS 文件系统中，有存储池、数据集、卷等概念。存储池是一组磁盘构成的逻辑卷，多个磁盘组成软 RAID 阵列；数据集则相当于存储池的一个子文件夹，可更改的选项会比存储池更多，通常用它来存储数据。

擦除硬盘

创建存储池前需要先将磁盘擦除。登录 OMV 的 Web 管理界面，点击左侧“存储器”、“磁盘”，选中需要擦除的硬盘，点击“擦除”图标，二次确认擦除，选择“快速”模式即可。

重复上述步骤，将所有要放入 ZFS 存储池的磁盘都擦除。

创建存储池

点击左侧“存储器”、“zfs”、“池”，点击加号图标，选择“添加池”一项，进入创建存储池页面。

在创建存储池页面：

名称：存储池的名称，根据个人喜好，我这里叫 main；
池类型：RAID 类型，通常根据磁盘数量选择，磁盘应当是同品牌、同型号、同大小的。我这里只有 2 块盘，所以选择“镜像”；
设备：勾选上一步中擦除过的设备；
挂载点：可以留空，系统会自动设置，也可以根据习惯自行设置；
设备别名：“以 ID”，不要改；
强制创建：磁盘大小不同时才需要，这里不勾选；
设置ashift：注释都说了不要改；
压缩：可以勾上，压缩类型选默认的“zf4”就好，不会占用太多资源。

点击“保存”按钮创建存储池，二次确认应用设置。可以看到存储池已经在列表中了，挂载点是 /main，可以用命令行访问这个目录看看。

创建数据集

OMV 里面，ZFS 的数据集被称作“文件系统”。点击左侧“存储器”、“zfs”、“池”，勾选刚刚创建的存储池，点击加号图标，选择“添加文件系统快照卷”选项。

PS：这里的“添加文件系统快照卷”指的是“添加文件系统、快照、卷”，并不存在某个东西叫“文件系统快照卷”……

在弹出的对话框里：

类型：选择“文件系统”，即数据集；
前缀：存储池的名称，不需要修改；
名称：根据需要起名，我这里叫 test；
挂载点：同样可以留空。

点击“保存”按钮创建数据集，二次确认应用设置。可以看到数据卷已经在列表中了，挂载点是 /main/test，可以用命令行访问这个目录看看。

设置共享

设置好共享后，就可以在局域网内访问 NAS 上的存储空间了。我的主力机器是 Windows 的，这里主要介绍 SMB 协议的共享。

调整存储池 ACL 设置

ZFS 插件默认禁用了 ACL 权限控制，这会对之后共享文件夹的设置产生一定的影响，需要手动开启。

点击左侧“存储器”、“zfs”、“池”，选中之前创建的存储池，点击“特性”图标，进入特性页面。修改以下几个参数：

aclmode：改为 groupmask；
aclinherit：确认为 restricted；
acltype：改为 posix。

上面这些修改都需要先选中修改项，再到上方点击“编辑”按钮，然后再手动输入值，保存。

新建用户

为了访问共享文件，我们需要创建一个新用户。点击左侧“用户”、“用户”，点击“新建|导入”图标，选择“创建”项。填入以下信息：

用户名：自己选择一个用户名，这里使用 asdf；
密码：自己选择一个密码；
用户组：留空即可，系统会自动加入 users 用户组。

点击保存，二次确认应用，即可看到新建的用户出现在列表之中。

设置共享文件夹和权限

点击左侧“存储器”、“共享文件夹”，点击“创建”图标。

在打开的页面中，设置如下参数：

名称：共享文件夹的名称，可以和数据集保持一致；
文件系统：选择之前创建的数据集；
相对路径：选择共享文件夹本身，显示出来应当是 /；
权限：默认即可，或根据自己需要修改；

点击保存，二次确认应用，即可看到创建的共享文件夹出现于列表之中。

选中刚刚创建的共享文件夹，点击“访问控制列表”按钮，在进入的页面中：

找到刚刚创建的 asdf 用户，将之权限改为“读/写”；
将下方的所有者从 root 改为 admin；
- OMV 其他文件系统默认的所有者即是 admin，推荐手动调整一下；
将用户组的权限改为“读/写/执行”；
勾选下方的“取代”和“递归”选项。

点击保存即可。

设置 SMB 共享

点击左侧“服务”、“SMB”、“设置”，勾选“已启动”项。点击下方保存，二次确认应用，即可打开 SMB 服务。

点击左侧“服务”、“SMB”、“共享”，点击“创建”按钮，设置如下项：

共享文件夹：选择刚才创建的共享文件夹；
公开：选择“否”或者“允许访客”均可；
勾选“继承ACL”、“继承权限”。

点击保存，二次确认应用，SMB 设置就 OK 了。

连接和测试

在本地机器上，打开 Windows 资源管理器，通过以下两种方法之一访问：

打开“网络”文件夹，找到“OPENMEDIAVAULT”（安装时设置的主机名）项目，双击进入；
在地址栏中输入 \\<your_nas_ip>（两个反斜杠 + IP地址），按回车进入。

随后会弹出窗口请求用户名和密码，输入此前创建的用户即可登录。

尝试复制文件到 NAS，或者从 NAS 复制文件，速度能够基本跑满千兆以太网。

结语

到这一步，NAS 算是达到一个可用的状态了，同样是非常麻烦。部署 ZFS 文件系统踩了巨大多的坑。

参考资料

Dannyda. How to Fix OpenMediaVault ZFS pool ACL/Privileges Error (Failed to execute command ‘export…Operation not supported). dannyda.com.
ACL Property Modes. Solaris ZFS Administration Guide.
Filesystems. openmediavault 6.x documentation.
OMV6.0 Kernel Regular Vs Proxmox for ZFS. Openmediavault Forum.
raulfg3. HOWTO Instal ZFS-Plugin & use ZFS on OMV. Openmediavault Forum.
OMV 6: Error when installing openmediavault-zfs 6.0.5. Openmediavault Forum.
OMV6: Unable to install openmediavault-zfs 6.0.9. Openmediavault Forum.
latest update fails compiling zfs module (kernel 5.18). Openmediavault Forum.
司波图. 【教程】OMV5下实现Freenas及unRAID相同的文件系统（司波图）——OMV系列教程02，SnapRaid，联合文件系统，ZFS. Bilibili.

搞台 NAS (2)：Openmediavault 的安装与配置

Fri, 08 Jul 2022 03:20:26 +0000

在准备好硬件之后，就该选择一个合适的 NAS 系统了。原先选择的是群友推荐的 TrueNAS SCALE，安装之后发现它 Docker 功能限制很大，于是换成了 Openmediavault（简称 omv）。在折腾了好几天踩了无数坑之后，发现 TrueNAS 的不少限制完全可以绕开，又打算换回 TrueNAS 了。

OMV 部分总共分为三篇文章，这是第 1 篇：

获取系统镜像、制作启动 U 盘

目前，Openmediavault 有基于 Debian 10 的 5.X 和基于 Debian 11 的 6.X 两个现役的大版本，我们这里选择较新的后者。打开 OMV 官方网站的下载页，下载 Stable 版本的 ISO 镜像，完成后用 SHA265 校验一下文件的完整性。我这里镜像的版本是 6.0.24。

使用 rufus 或者类似工具，将 ISO 文件烧入 U 盘。我这里使用 UEFI 启动，分区类型选择 GPT；烧录时会提示选择 ISO 还是 DD 模式，推荐选择速度更快的 DD 模式。

安装系统

将服务器插上网线和电源，插入烧好镜像的 U 盘，开机选择 U 盘启动。随后会出现 OMV 的 LOGO 和启动选择项，选择 Install 回车进入安装程序：

选择语言：选择中文即可；
选择区域：中国；
选择键盘映射：汉语；
选择网络接口：选择插网线对应的接口；
主机名：默认即可；
域名：默认即可；
root 用户密码和确认：推荐留空以禁用，不建议直接使用 root 用户；
设置初始用户全名和用户名：自定义，我这里取 ceba；
设置初始用户密码和确认：自己设置；
提示多个磁盘驱动器：回车继续；
选择磁盘：选择用于安装系统的磁盘；
分区方案：选“是”，需要自己移动光标；
配置软件包管理器：不要选择“中国”，选择“手动输入信息”；
Debian 仓库镜像主机名：这里推荐清华大学 TUNA，地址是 mirrors.tuna.tsinghua.edu.cn；
Debian 仓库镜像目录：对于清华大学 TUNA 源，默认即可；
HTTP 代理信息：这里不需要，留空；
结束安装进程：回车选择继续，结束。

系统会自动重新启动，默认启动项应该会被自动修改为 Openmediavault。启动后会进入 Debian 的登陆界面，上面有提示当前服务器 IP 地址，可以用来访问 Web 管理界面。

PS：安装系统的时候需要外接显示器，但我手头并没有 DP 接口的显示器，只好找了条 DP 转 Type-C 的视频线接到便携屏上。另外，没得采集卡，所以没图。

初始化配置

打开浏览器，输入机器登陆界面看到的 IP，打开 Web 管理界面的登陆页面。这里也可以尝试输入 openmediavault.local（即之前设置的主机名+域名），如果网络环境合适也可以打开 Web 管理界面。

Web 管理界面的用户名是 admin，初始密码是 openmediavault，‘‘‘不是’‘‘此前设置的 Debian 用户名和密码。输入用户密码后即可进入系统。

修改管理界面密码

点击右上角设置图标、“更改密码”，输入新的密码后点击保存。

修改网络配置

根据我家的网络环境，我需要把 IPv4 地址改为静态地址，并且启用 IPv6。点击左侧“网络”、“接口”，在右侧选中需要修改的接口。

然后点击编辑按钮，进入编辑界面：

IPv4：方式改为“静态”，地址、子网掩码、网关根据需要填写；
IPv6：方式改为“自动”。
DNS：根据需要填写，我这里填写网关地址。

填写完成后滑倒最下方，点击“保存”。随后页面上方会弹出黄色框，提示需要应用设置，点击右侧对勾图标，勾选“确认”后点击“是”按钮。随后网络配置会立即应用，大概率会卡在“正在应用”界面，需要重新输入地址进入 Web 管理界面。

PS：OMV 的几乎所有配置都需要二次确认应用。请在操作后稍等一会儿，看看会不会弹出黄色提示框。

设置时区

点击左侧“系统”、“时间和日期”，在“时区”一栏选择 Asia/Shanghai。点击保存，二次确认应用。

设置自动登出时间

OMV 默认的自动登出时间是 5 分钟，可以调长一些。点击左侧“系统”、“工作台”，在“自动登出”一栏选择希望的时间，例如 60 分钟。点击保存，二次确认应用。

进阶配置

之后不少工作需要 ssh 到服务器进行，请准备一个 ssh 客户端。我这里使用 Windows Terminal 通过 Powershell 或者 WSL 登录。

配置 ssh 用户

要通过 ssh 连接到服务器，需要将用户放入 ssh 用户组才可使用 ssh 登录。

点击左侧“用户”、“用户”，选中安装时创建的初始用户，点击“编辑”图标。

点击“用户组”一行，在 ssh 处打勾，在最下方点击“保存”按钮，二次确认应用修改。

随后就可以尝试用 ssh 登陆了。

通过 ssh 登录

在终端中，输入下面的命令通过 ssh 登录服务器，其中 <your_user_name> 是初始用户名、<your_nas_ip> 是服务器 IP 地址：

1

ssh <your_user_name>@<your_nas_ip>

通过下面的命令将公钥拷贝到服务器，则可以免密码登录服务器：

1

ssh-copy-id <your_user_name>@<your_nas_ip>

调整 ssh 配置

点击左侧“服务”、“SSH”，取消“允许 root 登录”、“密码认证”，勾选“公钥认证”，以提升服务器安全性。

配置 OMV 源

清华大学 TUNA 源提供了 Openmediavault 的镜像，推荐使用它来增快下载速度。

通过 ssh 登录服务器后，执行下面的命令：

1
2
3
4
5
6
7
8
9


# 进入 root 用户
sudo su
# 设置 OMV 软件源环境变量
omv-env set OMV_APT_REPOSITORY_URL "https://mirrors.tuna.tsinghua.edu.cn/OpenMediaVault/public"
omv-env set OMV_APT_ALT_REPOSITORY_URL "https://mirrors.tuna.tsinghua.edu.cn/OpenMediaVault/packages"
omv-env set OMV_APT_KERNEL_BACKPORTS_REPOSITORY_URL "https://mirrors.tuna.tsinghua.edu.cn/debian"
omv-env set OMV_APT_SECURITY_REPOSITORY_URL "https://mirrors.tuna.tsinghua.edu.cn/debian-security"
# 使环境变量生效
omv-salt stage run all

使环境变量生效一步可能会耗费较长的时间（约 2 分钟），请耐心等待。之后可以手动检查 /etc/apt/source.list.d/ 目录下的几个文件，看软件源是否成功更改。

安装更新

点击左侧“系统”、“更新管理”、“更新”，首先点击“检测是否有更新”图标（图案是搜索），然后点击“安装更新”图标（图案是下载）、确认。

当然也可以用命令行完成这些工作：

1
2


sudo apt update
sudo apt upgrade

安装 OMV-Extras.org

OMV-Extras.org 是 OMV 的增强插件，后续部署 ZFS 和 Docker 都需要它。

安装 OMV-Extras 需要管理员权限，下面的操作都需要通过 sudo su 命令，在 root 用户下进行。

配置代理

OMV-Extras 安装需要访问 Github。考虑到我这里的网络环境，需要使用 HTTP 代理来保证安装顺利。

首先，配置好代理服务器，允许局域网连接。

SSH 到服务器，在主目录下新建 proxy.sh，内容如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


export http_proxy="http://<your_proxy_ip>:<your_proxy_port>/"
export https_proxy="http://<your_proxy_ip>:<your_proxy_port>/"
export ftp_proxy="http://<your_proxy_ip>:<your_proxy_port>/"
export no_proxy="127.0.0.1,localhost"

# For curl
export HTTP_PROXY="http://<your_proxy_ip>:<your_proxy_port>/"
export HTTPS_PROXY="http://<your_proxy_ip>:<your_proxy_port>/"
export FTP_PROXY="http://<your_proxy_ip>:<your_proxy_port>/"
export NO_PROXY="127.0.0.1,localhost"

运行下面的命令，让代理生效：

1

source proxy.sh

然后测试一下代理是否能够正常连接，如果能看到正在连接代理服务器的相关输出，则说明代理正常。

1

wget https://github.co

PS：这个方法是用来临时使用代理的，退出登陆后代理设置就失效了。也可以用 OMV 的 Web 管理界面设置代理，但我折腾半天发现没这个方便。

安装

执行下面的命令：

1

wget -O - https://github.com/OpenMediaVault-Plugin-Developers/packages/raw/master/install | bash

打开 OMV 的 Web 管理界面，按下 Ctrl + Shift + R 或者 Ctrl + F5 强制刷新页面缓存。然后可以在左侧“系统”菜单下看到“omv-extras”项，说明安装成功。

PS：强制刷新 Web 管理界面是常规操作，能解决很多奇怪问题。

设置 OMV-Extras 的镜像

OMV-Extras 引入了一些新的软件源，我们同样可以将之换成清华大学 TUNA 源来加快下载速度。

通过 ssh 登录服务器后，执行下面的命令：

1
2
3
4
5
6
7
8


# 进入 root 用户
sudo su
# 设置 OMV 软件源环境变量
omv-env set OMV_EXTRAS_APT_REPOSITORY_URL "https://mirrors.tuna.tsinghua.edu.cn/OpenMediaVault/openmediavault-plugin-developers"
omv-env set OMV_DOCKER_APT_REPOSITORY_URL "https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/debian"
omv-env set OMV_PROXMOX_APT_REPOSITORY_URL "https://mirrors.tuna.tsinghua.edu.cn/proxmox/debian"
# 使环境变量生效
omv-salt stage run all

和之前相同，使环境变量生效一步可能会耗费较长的时间（约 2 分钟），请耐心等待。同样可以手动检查 /etc/apt/source.list.d/ 目录下的几个文件，看软件源是否成功更改。

结语

OK，OMV 的基本安装和配置算是告一段落了，可以说是非常麻烦。接下来，我会在 OMV 上部署 ZFS 文件系统，然后用 Docker 部署 qBittorrent，让 NAS 正式工作起来。

参考资料

Openmediavault 6 New User Guide. OMV-Extras.org.
openmediavault 6.x documentation. openmediavault.
OpenMediaVault 镜像使用帮助. 清华大学开源软件镜像站.
ryecoaaron. Solutions to common problems. Openmediavault Forum.
Josphat Mutai. How To Set System Proxy on Debian 11/10. Computing for Geeks.
司波图. 除了群晖用什么？另一个开源免费易用NAS系统——OMV. Bilibili.
司波图. 【教程】蜗牛星际安装开源NAS系统Openmediavault及初始化配置（司波图）——OMV系列教程01. Bilibili.

搞台 NAS (1)：硬件篇

Thu, 07 Jul 2022 02:29:33 +0000

最近，电脑硬盘全线飙红，笔记本内置的 512 GB 固态和外挂的 6 TB 机械硬盘都被塞满了东西。虽然还有一块 4 TB 的 3.5 寸机械硬盘、一块 2 TB 的 2.5 寸机械硬盘，但它们没法一直挂在电脑上，已经沦为冷备份盘了。是时候搞一台 NAS（Network Attached Storage，网络附接存储）了。

需求分析

我目前笔记本外接的 6 TB 机械硬盘主要是用来挂 BT 和 PT 的，主要是动画的 BDRip、BDMV 和新番，它们至少用掉了 5~6 TB 的空间。这些年攒下的杂七杂八的数据、资料、程序，手机和电脑的硬盘备份，以及家里的各种照片，也需要地方来存储。

对于我来说，NAS 必须要能够稳定运行，最好是企业级的整机，尽量不考虑灵车。

选择与折腾

一开始考虑过星际蜗牛，后来发现这是灵车，遂作罢；群晖、私有云之类的机器的可玩性不够高，也不考虑。最后在群友的推荐下发现了 HPE MicroServer Gen10，经过一番考察，选定了这个看起来还蛮好看的机器。后来才发现 Gen10 的下一代 Gen10 Plus 比 Gen10 紧凑很多，而且平台功能和性能也更强，不过看了看价格选择 Gen10 还是合理的。

机器配置方面，选择了 X3421 CPU 的高配，8G 内存，原机带有 4 块 1 TB 的希捷硬盘。本来是可以选择不要这 4 块硬盘的，不过只能便宜 400 块钱，觉得不如留下来作冷备份盘。

到手之后，感觉这机器做工蛮不错，前脸也相当好看。机箱上一大一小两个风扇，小的是电源风扇，大的给硬盘和 CPU 散热。两个千兆网口，对于我的网络环境是足够用了。显示器接口甚是豪华，有两个 DP 和 1 个 VGA 接口，不过对 NAS 来说不太会经常用它们了。安装硬盘没有专门的架子，而是在硬盘周围拧4颗螺丝，然后顺着硬盘架上的槽滑进去。两个 PCIe 接口都可以插 x16 的卡，不过带宽只有 x8 和 x1，而且不支持 PCIe 拆分，装 NVME 固态就有些水土不服。

由于原机内存只有 8 GB，对于服务器（尤其是跑 ZFS 文件系统的 TrueNAS）来说有些不够用，因此升级成了 16 GB × 2 共计 32 GB 内存。一开始下单了 2 条 32 GB 的 REG ECC 内存，到手后发现点不亮。查阅文档发现，这机器支持的是纯 ECC 内存（UDIMM）而不是 REG ECC 内存（RDIMM），只能把这两条内存退货，然后重新下单 2 条 16 GB 的纯 ECC（UDIMM）内存。REG ECC 内存比纯 ECC 内存便宜好多，两条 32 GB REG ECC 内存的价格和两条 16 GB 纯 ECC 内存几乎没差……

机械硬盘方面，选择了 2 块西部数据的 16 TB 企业级氦气盘，型号是 WUH721816ALE6L4。本来我是个希捷党，但奈何西数的 16 TB 盘价格实在是太香了。不过有点后悔没有搞 4 块，填不满 MicroServer 的 4 个硬盘槽，也不好组空间损失更小的 RAID 阵列。

固态硬盘方面，搞了一块致态 TiPlus5000 512 GB 和一块拆机三星 PM951 128 GB。致态这块用的是国内长江存储的颗粒，价格也非常合适。不过 512 GB 用作 TrueNAS 的启动盘有些大了，因此又搞了一块三星的拆机盘。其实系统盘搞个傲腾的 16 GB 小盘或者 U 盘也不是不行。搞了绿联和其他杂牌的 3 块 NVME 转 PCIe 的转接卡，它们的指示灯与机箱前面的绿色指示灯刚好构成了 RGB。

另外，MicroServer Gen10 上是有一个笔记本光驱位的。于是我就在淘宝搞了一套光驱的固定铁片，附带一个光驱位 2.5 寸硬盘架。

硬件清单

HPE ProLiant MicroServer Gen10，￥3499.00
2× 三星 16 GB 2Rx8 2400T UDIMM 内存，￥880.00
2× 西部数据 16 TB WUH721816ALE6L4 硬盘，￥￥3007.90
致态 TiPlus5000 512 GB 固态硬盘，￥339.00
三星 PM951 128 GB 固态硬盘（拆机），￥108.00
光驱位硬盘架、固定铁片、线，￥55.00
3× NVME 转 PCIe 转接卡，￥60.9

总计￥7949.80。

使用 Traefik 作为服务网关

Fri, 17 Dec 2021 02:21:43 +0000

前一阵子在折腾服务器的时候，偶然读到了苏洋老师的文章，了解了 Traefik，搞明白了该怎样用 Docker 部署服务。随后，我照猫画虎搭起来了 Traefik 和 Docker，并成功部署了 MediaWiki 和一个静态网站。

这篇文章记录一下搭建 Traefik 的过程，并部署一个简单的静态网站。

什么是 Traefik

Traefik 是一个开源的边缘路由软件，能够自动发现服务，方便地实现反向代理、负载均衡。

具体来说，它可以接收系统收到的请求，并将它们分派到合适的服务去处理。

安装配置 Traefik

我采用了裸机部署 Traefik 的方案，而没有将 Traefik 部署在 Docker 容器中。主要考虑到我是用的是单体云主机，裸机部署服务网关可以获得更好的性能。

安装

我们这里选择二进制应用文件安装的方式。在 Traefik 的 Github 仓库里找到编译好的二进制文件，下载解压之后放入 /usr/bin 文件夹中：

1
2
3


wget https://github.com/traefik/traefik/releases/download/v2.5.4/traefik_v2.5.4_linux_amd64.tar.gz
tar zxvf traefik_v2.5.4_linux_amd64.tar.gz
mv traefik /usr/bin/

然后验证系统能否找着 Traefik，并检查 Traefik 版本：

1
2


which traefik
traefik version

我这里使用的 Traefik 版本是：

1
2
3
4
5


Version: 2.5.4
Codename: livarot
Go version: go1.17.3
Built: 2021-11-08T17:41:41Z
OS/Arch: linux/amd64

配置

首先创建 Traefik 配置和值日的目录：

1

midir -p /data/basic/traefik/{logs,conf}

这一步主要是参照苏洋老师的做法，实际上将配置文件放在 /etc/traefik/、~/.config 等文件夹就可以，不一定要单独建立文件夹。

然后参照文档，编写配置文件 traefik.toml，放在 /data/basic/traefik/ 目录下：

 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


[global]
 checkNewVersion = false # 禁用检查新版本
 sendAnonymousUsage = false # 禁用发送匿名监测记录

[entryPoints]
 [entryPoints.http] # http 的默认入口
 address = ":80"
 [entryPoints.https] # https 的默认入口
 address = ":443"
 [entryPoints.http1] # 额外的 http 入口
 address = ":8088"
 [entryPoints.http2] # 额外的 http 入口
 address = ":8089"

[providers] # 后端服务提供平台
 [providers.docker] # docker
 exposedByDefault = false # 默认不暴露容器，除非其设置了 traefik.enable=true
 network = "traefik" # 连接容器使用的 Docker 网络
 [providers.file] # 配置文件
 watch = true # 监视文件变化
 directory = "/data/basic/traefik/conf"

[api]
 dashboard = true # 启用看板
 insecure = false # 禁用 8080 端口的看板入口
 debug = false

[ping] # 允许 ping

[log]
 level = "INFO"
 format = "common"
 filePath = "/data/basic/traefik/logs/traefik.log"

[accessLog]
 filePath = "/data/basic/traefik/logs/access.log"
 bufferingSize = 100

写配置文件的时候，主要还是要看原始文档。有不少配置项采用默认值就完全 OK。

启动 Traefik，验证配置：

1

traefik --configFile /data/basic/traefik/traefik.toml

访问服务器的 IP，如果看到 404 page not found，说明已经成功了。

守护进程

在容器环境中保持应用持续运行只需要一句 --restart=always，但在裸机环境下的事情会略微麻烦一些。

这里采用 supervisor 来担当守护进程，用 APT 安装：

1

sudo apt install supervisor

然后给 Traefik 编写进程守护配置文件，保存到 /etc/supervisor/conf.d/traefik.conf：

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


[program:traefik]
command=traefik --configFile /data/basic/traefik/traefik.toml
user=root
autostart=true
startsecs=3
startretries=100
autorestart=true
stderr_logfile=/data/basic/traefik/logs/supervisor-traefik-error.log
stderr_logfile_maxbytes=50MB
stderr_logfile_backups=10
stdout_logfile=/data/basic/traefik/logs/supervisor-traefik-access.log
stdout_logfile_maxbytes=50MB
stdout_logfile_backups=10

重启进程守护服务，可以看到 Traefik 已经开始运行。

1
2


service supervisor restart
ps -ef | grep traefik

此后，可以用下面的这些命令来启动、停止、重启 Traefik：

1
2
3


sudo supervisorctl start traefik
sudo supervisorctl stop traefik
sudo supervisorctl restart traefik

部署静态网站

这里采用 Apache HTTP 服务器的官方镜像 httpd 部署一个静态网站，来展示透过 Traefik 部署 Web 服务的流程。

准备工作目录

首先创建一个应用的工作目录 homepage，然后将静态网站的文件放在 www 子文件夹下：

1
2


mkdir homepage
mkdir homepage/www

编写容器编排文件

为静态网站应用编写一个 Docker compose 的编排文件：

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


version: "3"

services:
 homepage:
 image: ${HTTP_IMAGE}
 restart: always
 labels:
 - traefik.enable=true
 - traefik.http.routers.homepage.rule=Host(`${HTTP_DOMAINS}`)
 - traefik.http.routers.homepage.entrypoints=${HTTP_ENTRY}
 networks:
 - traefik
 expose:
 - 80
 volumes:
 - ./www:/usr/local/apache2/htdocs/

networks:
 traefik:
 external: true

这个文件主要做了这么几件事情：

指定服务名称和镜像，并保持持续运行；
通过 labels 属性通知 Traefik 该应用的路由规则；
暴露 80 端口，并挂载网页文件。

为了方便修改，这里参数化了部分内容，将之放到 .env 文件中：

1
2
3


HTTP_IMAGE=httpd:2.4-alpine
HTTP_DOMAINS=www.ceba.tech
HTTP_ENTRY=http, http1

然后工作目录执行命令，启动应用：

1

docker-compose up -d

如果你修改了编排文件，可以重复执行上面的命令，Docker compose 会自动更新容器配置。

在这个应用中，我们实际上只用到了一个容器，上述的编排文件完全可以转化成单条 Docker 命令。但是包含如此多参数的 Docker 命令一定又臭又长，使用结构化的编排文件反而更加方便。

关于自定义配置的补充

对于静态网站来说，使用 httpd 的默认配置应当是足够了。但如果需要，我们还可以对 apache2 做进一步的配置。

首先，执行下面的命令，获取一份配置文件：

1

docker run --rm httpd:2.4 cat /usr/local/apache2/conf/httpd.conf > my-httpd.conf

然后，修改编排文件，将自定义配置文件挂载进去：

1
2
3
4
5


services:
 homepage:
 volumes:
 - ./www:/usr/local/apache2/htdocs/
 - ./my-httpd.conf:/usr/local/apache2/conf/httpd.conf

后记

搭好服务快一个月了，这才动笔记一记搭建的过程。

之后还会写一篇文章，讲讲 MediaWiki 部署的过程和踩的坑。希望别咕。

最近可能会尝试以容器化的方式搭建一个 Cloudlog。希望别咕。

参考文献

Ubuntu 20.04 基础环境搭建

Thu, 04 Nov 2021 01:40:27 +0000

手头有台腾讯云学生机一直闲置，最近准备用起来。这篇文章记录一下 Ubuntu 20.04 系统下基础环境搭建的整个过程。

环境搭建过程

升级系统

对于一些某些安装古老系统却又不方便重装系统的机器，需要跨大版本升级：

1

sudo do-release-upgrade

配置软件源、安装更新

修改镜像源是必须的，需要根据机器地域决定。这里列出几个我常用的：

USTC：https://mirrors.ustc.edu.cn/ubuntu/
腾讯云：https://mirrors.cloud.tencent.com/ubuntu/
腾讯云内网：http://mirrors.tencentyun.com/ubuntu/
阿里云：https://mirrors.aliyun.com/ubuntu/

编辑系统源列表文件，将 archive.ubuntu.com 域名替换为上面的即可。

1

sudo vim /etc/apt/sources.list

随后更新软件列表、安装更新的软件。

1
2


sudo apt update
sudo apt upgrade -y

有些软件的更新过程可能需要还需要交互，需要注意一下。

安装常用软件和语言包

安装一些常用软件，虽然大部分可能云主机的镜像都带了。

1

sudo apt install git wget curl unzip vim -y

安装中文语言包，防止出现奇怪乱码：

1

sudo apt install language-pack-zh-hant language-pack-zh-hans -y

配置时区

配置系统时区，防止出现奇怪时间问题：

1

sudo dpkg-reconfigure tzdata

配置 SSH

将本地密钥复制到远程主机：

1

ssh-copy-id <host_address>

配置远程主机禁用密码登录、禁用 root 用户登录。

1
2
3
4
5


sudo vim /etc/ssh/sshd_config

# 添加下面的配置项
PermitRootLogin no
PasswordAuthentication no

重启 SSH 服务以应用设置。

1

sudo service ssh restart

安装 Docker

Docker 本体

注意参照官方文档：https://docs.docker.com/engine/install/ubuntu/

添加 Docker 官方 GPG 密钥：

1

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

添加 Docker 镜像源，将命令中 https://download.docker.com/linux/ubuntu 替换为国内源：

USTC：http://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu
腾讯云：https://mirrors.cloud.tencent.com/docker-ce/linux/ubuntu/
腾讯云内网：https://mirrors.tencentyun.com/docker-ce/linux/ubuntu/
阿里云：http://mirrors.aliyun.com/docker-ce/linux/ubuntu

1
2
3
4
5
6
7
8
9


# 原始命令
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 国内镜像
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] http://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

安装 Docker 本体。

1
2


sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io

安装 Docker Compose

注意参考官方文档：https://docs.docker.com/compose/install/

直接运行以下命令，由于没有镜像，可能会很慢。

1
2


sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

配置 Docker 容器镜像加速源

参照腾讯云文档：https://cloud.tencent.com/document/product/1207/45596
或阿里云文档：https://help.aliyun.com/document_detail/60750.html

编辑文件 /etc/docker/daemon.json，添加内容：

1
2
3


{
 "registry-mirrors": ["https://mirror.ccs.tencentyun.com"]
}

重启 Docker 服务

1

sudo service docker restart

验证 Docker 安装

1

sudo docker run hello-world

后记

目前准备在这个机器上搭一个 MediaWiki 和一个 CloudLog，估计还得花费一段时间研究研究 Docker 和 Docker Compose 的高级用法。

参考

Ubuntu 18.04 基础系统配置 - 苏洋博客

Python 列表、变量以及参数传递——从删除列表第一个元素说起

Fri, 18 Dec 2020 16:45:11 +0000

Python 的列表、变量以及参数传递一直都是一个挺让人头疼的问题。什么时候是值传递，什么时候是引用传递，总是傻傻搞不清。

举个例子来说，下面三段代码都希望能够删除列表第一个元素，但为什么前两个能实现功能，但第三个不行呢？

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# Example 1
def delete_head(new_list):
 del new_list[0]

old_list = [0, 1, 2, 3, 4]

delete_head(old_list)
print(old_list)

# Output: [1, 2, 3, 4]

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# Example 2
def tail(new_list):
 return new_list[1:]

old_list = [0, 1, 2, 3, 4]

old_list = tail(old_list)
print(old_list)

# Output: [1, 2, 3, 4]

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# Example 3
def bad_delete_head(new_list):
 new_list = new_list[1:]

old_list = [0, 1, 2, 3, 4]

bad_delete_head(old_list)
print(old_list)

# Output: [0, 1, 2, 3, 4]

为了解决这个问题，我们需要对 Python 的变量有一个基本的认识：

Python 中的变量都是对内存中某个对象的引用。
- 一般变量（不可更改对象）是对数据对象的引用，列表、字典（可更改对象）是对一般变量（不可更改对象）的引用。
Python 的函数参数传递总是“值传递”，或者说，传递的总是对内存中某个对象的引用关系。

基于这样的初步认识，我们再来依次分析一下上面的三段代码。

例子 1

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# Example 1
def delete_head(new_list):
 del new_list[0]

old_list = [0, 1, 2, 3, 4]

delete_head(old_list)
print(old_list)

# Output: [1, 2, 3, 4]

当第 5 行 old_list = [0, 1, 2, 3, 4] 这段代码执行过后，内存中是这样的：

当我们调用 delete_head 函数的时候，Python 解释器将我们传入的参数 old_list 复制了一份成为 new_list，像这样：

这里我们再次强调，Python 始终是“值传递”；而这里的“值”，指的是引用关系。

接下来，程序执行到第 3 行 del new_list[0]。del 表示从内存中删掉一个变量，同时删除链接到它的引用关系。我们将与 new_list[0] 指向的变量、相关的引用关系标红：

这里对于 Data 0，没有其他的变量引用到它，因此这个数据对象也会被销毁。

当完成删除后，内存中就是这样的：

很显然，这改变了 old_list 内容，符合我们的期望。

例子 2

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# Example 2
def tail(new_list):
 return new_list[1:]

old_list = [0, 1, 2, 3, 4]

old_list = tail(old_list)
print(old_list)

# Output: [1, 2, 3, 4]

列表初始化、函数调用的传参和例子 1 相似，我们得到这样的内存结构：

现在，new_list[1:] 语句会复制一份新的列表，内存会变成这样：

之后，我们通过 return，将这个列表赋值给了 old_list，如图：

于是，这个程序成功地改变了 old_list 内容，符合我们的期望。

例子 3

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# Example 3
def bad_delete_head(new_list):
 new_list = new_list[1:]

old_list = [0, 1, 2, 3, 4]

bad_delete_head(old_list)
print(old_list)

# Output: [0, 1, 2, 3, 4]

对于这个程序，直到 new_list[1:] 都与例子 2 一模一样。在 new_list[1:] 复制一份新的列表之后：

接下来，程序将复制后的列表赋值给了 new_list，然后函数结束，new_list 被释放：

在这个过程中，old_list 是始终没有被修改的，使得最后结果是错误的。

后记

今天一个同学在 QQ 上问我了这样的一个问题，于是我就跑去查了些材料、画了些图，然后给他作了解答。想着好不容易画的图不能这么轻易浪费，于是将回答整理了一下，形成了这篇文章。

当然，这篇文章只提到了列表的参数传递，并没有提到普通变量的传递，而且我也不确定内容是否完全正确……如果有什么错误或者不太恰当的地方，还请指出。

$\empty$

参考资料

ThinkVision M14 便携显示器维修记

Fri, 04 Dec 2020 16:28:11 +0000

前两天把便携屏整碎了，屏幕正中央一块击打痕迹，向四个方向扩散条纹（忘了拍照）。今年初才花一千二买的东西，这还没用到一年，直接买个新的太肉疼了，不如先看看能不能自己修好。

于是噌的一下就拿出螺丝刀，很快啊，就准备把屏拆了。上来就是左撬、右划，想去找卡扣和螺丝孔。结果发现这屏不讲武德，正面壳是双面胶贴上的麦拉片，屏幕也是双面胶贴到背板上去的。那就没有办法了，只能靠持续用力撕开胶带。本以为足够小心翼翼了，屏整个拆下之后，花的部分从十字扩展到了半个屏，彻底报废。

仔细端详这块屏幕，非常纤薄，厚度大概只有 2 mm。屏幕和背板严丝合缝，通过三条泡沫双面胶粘接。看起来背板应该是铝合金用 CNC 雕刻出来的，然后喷了一层类肤质的漆。

既然屏都拆下来了，顺带着也把主控板拆下来看看。主控部分的盖子是由螺丝固定的，藏在几个脚垫的下面。主控芯片是瑞昱（Realtek）的，具体型号忘记了，外壳上还专门给它贴了一小块导热胶。

屏幕的型号是 N140HCE-EN2，上淘宝按图索骥，找了好几家终于找到了这款屏幕，320 元，果断下单。随后又买了要用的几种规格的 3M 黑色泡沫双面胶。等快递的时候突然想起来没买贴屏线用的醋酸布胶带……试图在跳蚤市场收，然而并没有收到，于是又下单买了一卷醋酸布胶带。

等了几天之后，配件终于到齐，开工组装。装起来倒是没什么难度，线插好、胶带贴好、把屏放进背板、把麦拉片贴上……屏幕终于满血复活了。

后记

在屏幕碎掉的同时，我把原装的 Type-C 也搞丢了。买线的时候见识到了 Type-C 线的群魔乱舞，最后选择了 DELL 的拆机线。

之前我买过一个 HDMI 转 Type-C 的转接线，用来把便携屏给其他设备用。买回来发现电脑上没啥子问题，但树莓派上就是不好用，估计是 HDMI 口供电不足，带不动 HDMI 转 Type-C 的转接芯片。这回又买了一个支持供电的转接线，试了一下非常好使，树莓派啥的都可以正常使用了。

上淘宝的时候发现 ThinkVision 又出了一款新的便携屏 M14t，把之前的 M14 的痛点全补上了。十点触控、4096压感、Type-C口支持数据传输，有点心动，想买……