Docker Desktop环境下K8s挂载NFS类型PersistentVolume超时失败

故障根因 #

Docker Desktop 内置 Kubernetes 运行在轻量虚拟化层中，节点默认未预装 NFS 客户端依赖组件，kubelet 执行 NFS 卷挂载操作时缺少依赖导致超时，是该环境独有的问题，和提供的 YAML 配置无关。

排查&解决步骤 #

1. 先确认NFS服务端状态正常

   • 执行命令查看NFS Pod运行状态：

   kubectl get pods -n test-project -l app=nfs-server
   

   确保Pod处于Running状态无异常重启

   • 启动临时Pod验证NFS服务连通性：

   kubectl run -it --rm nfs-test --image=alpine --restart=Never -- sh -c "apk add nfs-utils && showmount -e 10.96.13.37"
   

   能正常返回导出目录说明服务端配置无问题

2. 给Docker Desktop K8s节点安装NFS客户端依赖

   • Mac/Windows版Docker Desktop：
     执行以下命令进入Docker Desktop的虚拟化层终端安装依赖：

     docker run -it --privileged --pid=host justincormack/nsenter1 /bin/sh -c "apk add nfs-utils"
     

   • Linux版Docker Desktop：
     直接在宿主机安装对应NFS客户端包即可：

     # Debian/Ubuntu 系
     sudo apt install -y nfs-common
     # RHEL/CentOS 系
     sudo yum install -y nfs-utils
     

3. 可选配置优化（规避兼容问题）
   当前PV的NFS路径配置为/，可改为NFS服务端实际导出的/exports路径，避免权限拦截问题：

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     labels:
       environment: test
     name: test-lagg-volume
   spec:
     accessModes:
     - ReadWriteMany
     capacity:
       storage: 2Gi
     nfs:
       path: /exports
       server: 10.96.13.37
   

4. 临时规避方案
   如果上述操作后仍挂载失败，可将NFS服务端Service改为NodePort类型，PV的server字段填写Docker Desktop宿主机的局域网IP，绕过ClusterIP网络栈的NFS请求拦截。

内容的提问来源于stack exchange，提问作者Ral