ghcr.io/viz-software/static-path-provisioner:latest

static-path-provisioner 是由 viz-software 团队开发的一款 Kubernetes 存储供应工具，以 Docker 镜像形式托管在 GitHub Container Registry（ghcr.io）。作为轻量级存储插件，它主要用于为 Kubernetes 集群提供静态路径存储方案，核心功能是将宿主机的指定目录作为持久化存储源，供 Pod 通过 PVC（持久化卷声明）挂载使用。

该工具的核心特性在于“静态路径”配置：用户可预先指定宿主机的具体目录（如 /data/static），通过简单参数定义存储路径、容量限制和访问模式（如 ReadWriteOnce、ReadOnlyMany），无需依赖动态存储创建逻辑。这种设计使其特别适合两类场景：一是开发测试环境，能快速为应用提供持久化存储，省去复杂的存储服务部署步骤；二是需要固定路径挂载的应用，例如日志收集服务（需挂载宿主机日志目录）、静态资源服务器（需挂载本地静态文件目录）等对存储性能要求不高的场景。

使用时，需通过 Kubernetes 的 StorageClass 资源定义存储策略，指定 provisioner 为 viz-software/static-path-provisioner，并配置宿主机路径、存储容量等参数。之后，应用通过 PVC 申请存储，该工具会自动将指定的宿主机目录挂载到 Pod 中，实现数据持久化。相比动态存储供应工具，它的优势在于轻量无依赖（无需外部存储服务如 NFS、Ceph）、配置简单（仅需几行 YAML 定义），尤其适合边缘集群或资源有限的小型环境。

不过使用时需注意两点：一是宿主机路径必须预先创建并设置正确权限（如 chmod 777 或匹配 Pod 的运行用户 UID），否则会导致挂载失败；二是跨节点部署时，需确保各节点的指定路径一致（或使用共享存储），避免 Pod 调度到不同节点后因路径不存在而无法访问数据。此外，由于不支持动态路径创建，宿主机目录的增删需手动管理，适合对存储自动化要求不高的场景。