feat(zpool-memo): add localized content and recategorize

This commit is contained in:
Luoxingchen935 authored and sharevb committed 2026-10-03 12:45:21 +02:00
1 parent cba443dc39
commit f196182261
3 files changed
+254 -3

No files matched your search

+1 -1
View File
@@ -9,5 +9,5 @@ export const tool = defineTool({
component: () => import('./zpool-memo.vue'),
icon: defineAsyncComponent(() => import('@vicons/tabler/es/DeviceDesktop')),
createdAt: new Date('2025-08-15'),
category: 'Network',
category: 'Cheatsheets',
});
+29 -2
View File
@@ -1,13 +1,40 @@
<script setup lang="ts">
import { ref, watch } from 'vue';
import { useI18n } from 'vue-i18n';
import { useThemeVars } from 'naive-ui';
import Memo from './zpool.content.md';
import type { Component } from 'vue';
const themeVars = useThemeVars();
const { locale } = useI18n();
const memoImports = import.meta.glob('./zpool.content*.md');
const memoComponent = ref<Component | null>(null);
async function loadMemo(currentLocale = locale.value) {
const memoKey = `./zpool.content.${currentLocale}.md`;
const loader = memoImports[memoKey] ?? memoImports['./zpool.content.md'];
if (!loader) {
memoComponent.value = null;
return;
}
const module = (await loader()) as { default?: Component };
memoComponent.value = module.default ?? module;
}
watch(
locale,
() => {
loadMemo();
},
{ immediate: true },
);
</script>
<template>
<div>
<Memo />
<component :is="memoComponent" style="overflow-x: auto" />
</div>
</template>
+224
View File
@@ -0,0 +1,224 @@
**OpenZFS** 将卷管理器与文件系统合二为一。**存储池**(`zpool`)由 **vdev** 构成,而 vdev 由磁盘构成;**数据集**(`zfs`)则是位于存储池内部的文件系统和卷。
> ⚠️ 冗余存在于 **vdev** 级别,而不是存储池级别。只要丢失一个 vdev,整个存储池都会丢失,无论其他 vdev 多么健康。
## 📦 存储池基础
```bash
# 用单块磁盘创建存储池(无冗余)
zpool create mypool /dev/disk/by-id/<disk>
# 两块磁盘组成的 mirror,4K 对齐
zpool create -o ashift=12 mypool mirror /dev/disk/by-id/<disk1> /dev/disk/by-id/<disk2>
# 六块磁盘组成的 raidz2
zpool create -o ashift=12 tank raidz2 <disk1> <disk2> <disk3> <disk4> <disk5> <disk6>
# 把存储池挂载到 /<poolname> 之外的位置
zpool create -m /srv/data mypool <disk>
# 增加另一个 vdev(这只是扩容,并不会增加冗余)
zpool add mypool mirror <disk3> <disk4>
# 添加热备盘、读缓存(L2ARC)和独立的意图日志
zpool add mypool spare <disk>
zpool add mypool cache <ssd>
zpool add mypool log mirror <ssd1> <ssd2>
# 销毁存储池 —— 不可恢复
zpool destroy mypool
```
## 🔍 查看状态
```bash
# 查看存储池、容量与健康状态
zpool list
# 按 vdev 拆分显示
zpool list -v
# 查看布局、错误以及正在进行的 scrub 或 resilver
zpool status mypool
# 只显示需要关注的存储池
zpool status -x
# 实时吞吐量,每 5 秒刷新一次
zpool iostat -v 5
# 存储池的全部属性
zpool get all mypool
# 该存储池上执行过的所有操作
zpool history mypool
```
## 🛠 Vdev 类型
| Vdev 类型 | 描述 | RAID 对应级别 | 最少磁盘数 | 可容忍故障 |
| --------- | ---------------------------- | ---------------- | ---------- | ---------------------- |
| `stripe` | 数据条带分布,无校验 | RAID 0 | 1 | 无法容忍任何故障 |
| `mirror` | 每块磁盘都有一份完整副本 | RAID 1 | 2 | 除一块盘外的所有磁盘 |
| `raidz1` | 单重校验 | RAID 5 | 3 | 1 块磁盘 |
| `raidz2` | 双重校验 | RAID 6 | 4 | 2 块磁盘 |
| `raidz3` | 三重校验 | —(无常见级别) | 5 | 3 块磁盘 |
| `dRAID` | 分布式校验,并预留热备空间 | — | 6+ | 按配置而定,重建更快 |
辅助 vdev:`cache`(L2ARC 读缓存)、`log`(SLOG,用于同步写入)、`special`(元数据与小块数据)、`spare`(热备盘)。
## 🩺 健康与维护
```bash
# 按校验和校验每一个数据块
zpool scrub mypool
# 停止或暂停正在进行的 scrub
zpool scrub -s mypool
zpool scrub -p mypool
# 清除已处理过的错误记录
zpool clear mypool
# 用新盘替换故障盘
zpool replace mypool <old-disk> <new-disk>
# 把单盘变成 mirror,或拆分 mirror
zpool attach mypool <existing-disk> <new-disk>
zpool detach mypool <disk>
# 让磁盘下线 / 重新上线
zpool offline mypool <disk>
zpool online mypool <disk>
# 告诉 SSD 哪些数据块已空闲
zpool trim mypool
# 启用更新版 OpenZFS 的磁盘特性
zpool upgrade mypool
```
> 💡 消费级磁盘建议每月 scrub 一次,重要数据可每周一次。`zpool status` 会报告上次 scrub 的结果。
## 📤 导入与导出
```bash
# 释放存储池,以便迁移到另一台机器
zpool export mypool
# 列出可导入的存储池
zpool import
# 按名称导入,优先使用稳定的设备名
zpool import -d /dev/disk/by-id mypool
# 导入它能找到的所有存储池
zpool import -a
# 强制导入未正常导出的存储池
zpool import -f mypool
# 以其他名称导入,或挂载到备用根目录
zpool import mypool newname
zpool import -R /mnt mypool
```
## ⚙️ 存储池属性
```bash
# 数据块释放后自动 trim
zpool set autotrim=on mypool
# 底层磁盘扩容时自动扩展存储池
zpool set autoexpand=on mypool
# 用热备盘自动替换故障盘
zpool set autoreplace=on mypool
# 存储池故障时的行为:wait | continue | panic
zpool set failmode=continue mypool
# 读取单个属性
zpool get health,capacity,fragmentation mypool
```
## 📁 数据集与文件系统
```bash
# 创建数据集
zfs create mypool/data
# 创建嵌套数据集,按需自动创建父级
zfs create -p mypool/data/projects/web
# 创建块设备(zvol),用于虚拟机或 iSCSI 目标
zfs create -V 50G mypool/vm-disk
# 列出数据集、快照和卷
zfs list
zfs list -t all -r mypool
# 常用属性
zfs set compression=lz4 mypool/data
zfs set quota=100G mypool/data
zfs set reservation=10G mypool/data
zfs set atime=off mypool/data
zfs set recordsize=1M mypool/media
# 读取属性,包括其继承来源
zfs get -r compression mypool
zfs get all mypool/data
# 挂载、卸载与销毁
zfs mount mypool/data
zfs unmount mypool/data
zfs destroy -r mypool/data
```
## 📸 快照与复制
```bash
# 创建快照(瞬间完成,且在数据发生变更之前不占空间)
zfs snapshot mypool/data@2026-08-22
# 对数据集及其所有子数据集递归创建快照
zfs snapshot -r mypool/data@nightly
# 列出快照及其占用空间
zfs list -t snapshot -o name,used,refer
# 回滚 —— 会丢弃此后的所有写入
zfs rollback mypool/data@2026-08-22
# 只从快照中读取单个文件
ls /mypool/data/.zfs/snapshot/2026-08-22/
# 基于快照创建可写副本
zfs clone mypool/data@2026-08-22 mypool/data-copy
# 将完整快照发送到另一台机器
zfs send mypool/data@snap1 | ssh user@host zfs receive backup/data
# 只发送自上一个快照以来的增量
zfs send -i mypool/data@snap1 mypool/data@snap2 | ssh user@host zfs receive backup/data
# 删除快照
zfs destroy mypool/data@snap1
```
## 🧠 技巧与最佳实践
- 一律使用 `/dev/disk/by-id/...` 来指定磁盘,不要用 `/dev/sdX` —— 内核设备名在重启后可能变化。
- 对任何现代硬盘,创建时都设置 `ashift=12`;该值之后无法更改。
- 把整块磁盘交给 ZFS,而不是分区,这样它才能自行管理写入缓存。
- 存储池使用率保持在 80% 以下 —— 超过后性能会急剧下降,且碎片化不可逆。
- 尽可能使用 ECC 内存:ZFS 完全信任内存中的数据。
- 不要在同一个存储池中混用不同类型的 vdev 或不同的宽度;存储池的可靠性取决于最弱的那个 vdev。
- 快照不等于备份 —— 请用 `zfs send` 把它复制到别处。
## 📚 参考资源
- [OpenZFS 文档](https://openzfs.github.io/openzfs-docs/)
- [`zpool` 手册页](https://openzfs.github.io/openzfs-docs/man/master/8/zpool.8.html)
- [`zfs` 手册页](https://openzfs.github.io/openzfs-docs/man/master/8/zfs.8.html)
- [工作负载调优指南](https://openzfs.github.io/openzfs-docs/Performance%20and%20Tuning/Workload%20Tuning.html)