迁移.NET组件至Linux容器：如何将Windows共享挂载到Kubernetes Pod？

没问题！Docker容器完全可以访问Windows共享目录，不管你是用Docker Desktop（Windows宿主环境）还是在Linux节点上的Docker，都有对应的实现方式。下面我分Docker直接使用和Kubernetes部署两个场景给你详细说明：

1. Docker Desktop（Windows宿主） #

这种场景下最简单，直接在启动容器时挂载Windows共享即可，格式上要把Windows的路径转换成//主机名/共享名或者//localhost/盘符$/目录的形式：

• 用docker run命令挂载：

docker run -v //localhost/C$/your-shared-folder:/app/shared-folder --user 1000:1000 your-dotnet-core-image

这里的--user 1000:1000是为了让容器内的用户拥有挂载目录的读写权限，你可以根据自己容器的实际用户UID/GID调整。

• 用docker-compose.yml配置：

services:
  file-processor:
    image: your-dotnet-core-image
    volumes:
      - //localhost/C$/your-shared-folder:/app/shared-folder
    user: "1000:1000"

2. Linux宿主上的Docker #

如果你的Docker跑在Linux主机上，需要先把Windows共享通过CIFS协议挂载到宿主机，再让容器挂载这个本地目录：

1. 先安装CIFS工具：

# Debian/Ubuntu
sudo apt-get install -y cifs-utils

# RHEL/CentOS
sudo yum install -y cifs-utils

2. 创建宿主机挂载目录：

sudo mkdir /mnt/win-share

3. 挂载Windows共享（替换成你的Windows主机IP、共享名、用户名密码）：

sudo mount -t cifs //192.168.1.100/your-shared-folder /mnt/win-share -o username=win-user,password=win-pass,domain=your-domain

4. 如果需要开机自动挂载，把配置加到/etc/fstab：

echo '//192.168.1.100/your-shared-folder /mnt/win-share cifs username=win-user,password=win-pass,domain=your-domain 0 0' | sudo tee -a /etc/fstab

5. 最后容器挂载这个本地目录：

docker run -v /mnt/win-share:/app/shared-folder your-dotnet-core-image

在K8s里更推荐用**PersistentVolume（PV）+ PersistentVolumeClaim（PVC）**的方式，尤其是多节点集群场景。下面是两种可行的方法：

方法1：使用CIFS CSI驱动直接挂载（推荐多节点集群） #

这种方式不需要在宿主机提前挂载，K8s会通过CSI驱动直接连接Windows共享，所有节点都能访问。

第一步：创建存储凭据的Secret #

先把Windows共享的用户名密码用Base64编码（避免明文泄露），比如：

echo -n "win-user" | base64  # 生成用户名的Base64值
echo -n "win-pass" | base64  # 生成密码的Base64值

然后创建Secret：

apiVersion: v1
kind: Secret
metadata:
  name: win-share-secret
type: Opaque
data:
  username: <BASE64_USERNAME>
  password: <BASE64_PASSWORD>

第二步：创建PersistentVolume #

apiVersion: v1
kind: PersistentVolume
metadata:
  name: win-share-pv
spec:
  capacity:
    storage: 10Gi  # 这里只是占位，CIFS不限制实际存储大小
  accessModes:
    - ReadWriteMany  # 支持多Pod同时读写
  csi:
    driver: cifs.csi.k8s.io
    volumeHandle: win-share-unique-id  # 随便填一个唯一标识即可
    nodeStageSecretRef:
      name: win-share-secret
      namespace: default
    volumeAttributes:
      source: "//192.168.1.100/your-shared-folder"
      mountOptions: "dir_mode=0777,file_mode=0777,uid=1000,gid=1000"  # 匹配容器用户的权限

第三步：创建PersistentVolumeClaim #

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: win-share-pvc
spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 10Gi
  storageClassName: ""  # 静态PV不需要StorageClass

第四步：在Deployment中使用PVC #

apiVersion: apps/v1
kind: Deployment
metadata:
  name: file-processor-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: file-processor
  template:
    metadata:
      labels:
        app: file-processor
    spec:
      containers:
      - name: file-processor
        image: your-dotnet-core-image
        volumeMounts:
        - name: win-share-volume
          mountPath: /app/shared-folder  # 容器内的挂载路径
      volumes:
      - name: win-share-volume
        persistentVolumeClaim:
          claimName: win-share-pvc

方法2：挂载宿主机已挂载的共享（适合单节点K8s） #

如果你的K8s是单节点集群（比如minikube），可以先按照前面Linux宿主挂载CIFS的方法，把Windows共享挂载到节点的/mnt/win-share，然后用hostPath挂载到Pod：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: file-processor-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: file-processor
  template:
    metadata:
      labels:
        app: file-processor
    spec:
      containers:
      - name: file-processor
        image: your-dotnet-core-image
        volumeMounts:
        - name: win-share-volume
          mountPath: /app/shared-folder
      volumes:
      - name: win-share-volume
        hostPath:
          path: /mnt/win-share
          type: Directory

关键注意事项 #

• 确保Windows主机的防火墙允许CIFS流量（默认端口445），并且K8s节点/ Docker宿主能ping通Windows主机
• 权限匹配很重要：容器内的运行用户要对挂载目录有读写权限，所以要调整mountOptions里的uid/gid，或者在Windows共享里给对应用户设置权限
• 多节点集群一定要用方法1的CSI驱动，方法2的hostPath只能在单个节点生效，Pod调度到其他节点会无法访问共享

内容的提问来源于stack exchange，提问作者Ram Kinkar Pandey