From f19618226146e5534e502c0d1e276edff900c4f2 Mon Sep 17 00:00:00 2001 From: Luoxingchen935 <42908923+LuoXingchen935@users.noreply.github.com> Date: Tue, 29 Sep 2026 13:34:14 +0800 Subject: [PATCH] feat(zpool-memo): add localized content and recategorize --- src/tools/zpool-memo/index.ts | 2 +- src/tools/zpool-memo/zpool-memo.vue | 31 +++- src/tools/zpool-memo/zpool.content.zh.md | 224 +++++++++++++++++++++++ 3 files changed, 254 insertions(+), 3 deletions(-) create mode 100644 src/tools/zpool-memo/zpool.content.zh.md diff --git a/src/tools/zpool-memo/index.ts b/src/tools/zpool-memo/index.ts index e3556006..16d6e7ce 100644 --- a/src/tools/zpool-memo/index.ts +++ b/src/tools/zpool-memo/index.ts @@ -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', }); diff --git a/src/tools/zpool-memo/zpool-memo.vue b/src/tools/zpool-memo/zpool-memo.vue index 6b53decf..e9595e07 100644 --- a/src/tools/zpool-memo/zpool-memo.vue +++ b/src/tools/zpool-memo/zpool-memo.vue @@ -1,13 +1,40 @@ diff --git a/src/tools/zpool-memo/zpool.content.zh.md b/src/tools/zpool-memo/zpool.content.zh.md new file mode 100644 index 00000000..7ce30845 --- /dev/null +++ b/src/tools/zpool-memo/zpool.content.zh.md @@ -0,0 +1,224 @@ +**OpenZFS** 将卷管理器与文件系统合二为一。**存储池**(`zpool`)由 **vdev** 构成,而 vdev 由磁盘构成;**数据集**(`zfs`)则是位于存储池内部的文件系统和卷。 + +> ⚠️ 冗余存在于 **vdev** 级别,而不是存储池级别。只要丢失一个 vdev,整个存储池都会丢失,无论其他 vdev 多么健康。 + +## 📦 存储池基础 + +```bash +# 用单块磁盘创建存储池(无冗余) +zpool create mypool /dev/disk/by-id/ + +# 两块磁盘组成的 mirror,4K 对齐 +zpool create -o ashift=12 mypool mirror /dev/disk/by-id/ /dev/disk/by-id/ + +# 六块磁盘组成的 raidz2 +zpool create -o ashift=12 tank raidz2 + +# 把存储池挂载到 / 之外的位置 +zpool create -m /srv/data mypool + +# 增加另一个 vdev(这只是扩容,并不会增加冗余) +zpool add mypool mirror + +# 添加热备盘、读缓存(L2ARC)和独立的意图日志 +zpool add mypool spare +zpool add mypool cache +zpool add mypool log mirror + +# 销毁存储池 —— 不可恢复 +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 + +# 把单盘变成 mirror,或拆分 mirror +zpool attach mypool +zpool detach mypool + +# 让磁盘下线 / 重新上线 +zpool offline mypool +zpool online mypool + +# 告诉 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)