Local Path Provisioner

把节点本地目录做成 PV 的最小 provisioner。K3s 默认存储类,零依赖零副本。

PVC 一来就在某个节点的本地路径下建一个目录,做成带 node affinity 的 PV。没有网络、没有副本、没有快照 ——读写就是本地磁盘速度,运维面几乎为零。K3s 默认装的存储类就是它,单节点 homelab 里这通常是**正确**的选择:副本要跨节点才有意义,单节点上的分布式存储只剩开销。

License
Apache-2.0
语言
Go
自托管
K8s 清单 · Helm Chart
上游托管版
无
分类
K8s 卷
仓库
github.com/rancher/local-path-provisioner
上游文档
文档官网

上游活跃度

2026-08-23 抓取 · 数据来自 rancher/local-path-provisioner (github)
star2,923
最近提交2026-08-21
最新版本v0.0.372026-08-05

数字由构建期抓取,非实时;star 数不同代码托管平台之间不可直接比较。

上手前注意

  • PV 绑死在一个节点上:那个节点下线,用它的 Pod 就调度不出去(不是慢,是 Pending)
  • 没有快照、没有副本 —— 备份必须在文件层另做(restic / Velero 的文件级备份),存储层不会帮你
  • 默认路径在 /var/lib/rancher/... 之类的系统盘上,容量与系统盘共命运,扩容前先确认底层是哪块盘

同类工具(K8s 卷)