Linux Docker容器中PhysicalFileProvider访问Windows共享的路径配置问题

你遇到的报错本质是两个核心原因：

1. Linux系统原生不支持Windows的UNC路径格式（\\myshare\files这种），必须先把Windows共享挂载为Linux本地可访问的目录
2. Docker容器默认隔离宿主机文件系统，就算宿主机挂载了共享，容器未做挂载映射也无法访问

步骤1：Linux宿主机挂载Windows共享 #

首先在运行Docker的Linux宿主机上执行操作：

• 先安装cifs工具包，不同发行版安装命令不同：
  Debian/Ubuntu系：sudo apt install cifs-utils
  CentOS/RHEL系：sudo yum install cifs-utils
• 新建本地挂载目录：sudo mkdir -p /mnt/win_share/files
• 临时挂载测试：
  执行命令：sudo mount -t cifs //myshare/files /mnt/win_share/files -o username=共享访问用户名,password=共享访问密码,vers=3.0
  注意Windows的UNC路径\\myshare\files在Linux中需要写成//myshare/files的格式
• 如需开机自动挂载，将以下配置添加到/etc/fstab文件中：

  //myshare/files /mnt/win_share/files cifs username=共享用户名,password=共享密码,vers=3.0 0 0
  

  添加完成后执行sudo mount -a验证配置是否正常，无报错即为挂载成功。

步骤2：Docker容器挂载宿主机的共享目录 #

需要把宿主机的共享挂载目录映射到容器内部，根据启动方式选择对应配置：

• 如果使用docker run命令启动：
  新增参数-v /mnt/win_share/files:/app/myshare_files，含义是将宿主机的/mnt/win_share/files目录映射到容器内的/app/myshare_files路径
• 如果使用docker-compose编排：
  在对应服务的配置下新增volumes节点：

  services:
    your-file-watcher-service:
      # 其余原有配置保持不变
      volumes:
        - /mnt/win_share/files:/app/myshare_files
  

步骤3：修改appsettings配置 #

将SourceFolder的路径改为容器内的映射路径即可：

"SourceFolder": "/app/myshare_files"

额外注意事项 #

• 要确保容器内运行服务的用户对/app/myshare_files目录有读取权限，必要时可在启动容器时指定用户，或给挂载目录开放读权限
• 如果挂载时提示协议版本错误，可将挂载参数中的vers=3.0替换为vers=2.0或vers=1.0尝试适配

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