将 laptop ZFS ARC 预算限制为 4 GiB

infrastructure/host-memory/README.md

@@ -0,0 +1,29 @@
+# laptop 内存预算
+
+laptop 同时承载 Kubernetes、数据库和 libvirt VM。ARC 使用明确的 **4 GiB** 上限，
+为服务留下突发余量；不修改自动 ARC 下限、swap、业务内存或 VM I/O 策略。
+
+在 laptop 上执行：
+
+```bash
+ansible-playbook -i localhost, infrastructure/host-memory/laptop-arc.yml --check
+ansible-playbook -i localhost, infrastructure/host-memory/laptop-arc.yml
+```
+
+play 在线写入 `/sys/module/zfs/parameters/zfs_arc_max`，并持久化到
+`/etc/modprobe.d/homelab-zfs-arc.conf`。配置变化时以低 CPU/I/O 优先级更新所有已安装
+内核的 initramfs。不重启、不卸载 ZFS。ARC 当前使用量不保证立即降到上限以下；
+`zfs_arc_max` 也不是 ZFS 全部内存的硬上限。
+
+验证 `/proc/spl/kstat/zfs/arcstats` 的 `c_max=4294967296`，并在 Grafana 比较
+`node_zfs_arc_size`、`node_zfs_arc_c_max`、内存/I/O PSI、换页及数据库请求延迟。
+命中率下降或磁盘读压力上升时按实际负载重新评估预算，不通过重启或清缓存进行验收。
+
+回滚时先从运行中的 `arcstats` 核实原自动上限，再在线写回该非零值。
+删除本 play 的 modprobe 文件并更新 initramfs，可恢复以后启动时的自动策略。
+不要依赖运行时写入 `0` 恢复自动计算；该行为受 OpenZFS 参数实现限制。
+
+2026-09-26 故障关联：winadmin 自动更新期间虚拟磁盘写入与 ARC 增长、内存回收和
+Gitea 超时重合；限制 ARC 是内存预算措施，不代表已证明或解决全部存储延迟原因。
+排查证据与后续验收见
+[宿主机 ARC 预算](https://git.ddupan.top/panxiao81/homelab-wiki/src/branch/main/guides/laptop-arc-budget.md)。