一、一键安装（稳定版 v0.0.35）

# 直接 apply 官方 yaml（自动建 ns、sa、deploy、storageclass）
kubectl apply -f https://raw.githubusercontent.com/rancher/local-path-provisioner/v0.0.35/deploy/local-path-storage.yaml

• 命名空间：local-path-storage

• StorageClass：local-path（默认）

• 节点默认路径：/opt/local-path-provisioner

二、验证是否装好

1. 看 Pod 是否 Running

kubectl -n local-path-storage get pods

正常输出：

NAME                                         READY   STATUS    RESTARTS   AGE
local-path-provisioner-7f987c6b7d-2xq9s   1/1     Running   0          10s

2. 看 StorageClass

kubectl get storageclass

输出：

NAME          PROVISIONER               RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
local-path    rancher.io/local-path     Delete          WaitForFirstConsumer   false                  30s

三、（可选）修改默认存储路径

默认所有节点用 /opt/local-path-provisioner。想改全局路径：

kubectl -n local-path-storage edit configmap local-path-config

找到：

nodePathMap:
  "default": "/opt/local-path-provisioner"

改成你要的，比如 /mnt/localpv，保存后重启 Pod：

kubectl -n local-path-storage rollout restart deployment local-path-provisioner

四、创建 PVC 测试（自动绑 PV）

yaml

# local-path-pvc.yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: local-path-pvc
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: local-path
  resources:
    requests:
      storage: 1Gi

应用：

kubectl apply -f local-path-pvc.yaml

# 查看 PVC 状态（等 Pod 挂载后才会 Bound）
kubectl get pvc