Linux Docker容器中FileSystemWatcher监听Windows文件共享的路径配置方法

问题解决逻辑 #

Linux系统无法直接识别Windows的UNC路径格式，你此前尝试的file://前缀加UNC路径的方案完全不可行。必须先将Windows SMB共享挂载到Linux容器的本地文件系统路径，再给FileSystemWatcher传递这个本地路径即可，原有C#代码无需做任何修改。

操作步骤 #

1. 给Docker镜像添加SMB挂载依赖 #

你的容器镜像需要预装cifs-utils包来支持SMB协议挂载，如果你的镜像是基于Debian/Ubuntu构建的，在Dockerfile中添加以下指令：

RUN apt update && apt install -y cifs-utils

2. 启动容器时挂载Windows共享 #

用docker run命令启动的示例：

docker run -d \
  --cap-add SYS_ADMIN \
  --cap-add DAC_READ_SEARCH \
  --mount type=cifs,source=//fileshare/files,destination=/app/mounted_share,username=共享访问账号,password=共享访问密码,vers=3.0 \
  你的镜像名称

用docker-compose启动的配置示例：

version: '3'
services:
  dotnet-service:
    image: 你的镜像名称
    cap_add:
      - SYS_ADMIN
      - DAC_READ_SEARCH
    volumes:
      - type: cifs
        source: //fileshare/files
        target: /app/mounted_share
        volume_opt:
          username: 共享访问账号
          password: 共享访问密码
          vers: 3.0

配置说明：

• 必须添加SYS_ADMIN、DAC_READ_SEARCH权限，否则会出现挂载权限报错
• vers参数对应你的SMB服务版本：Windows Server 2012及以上版本一般填3.0，老版本系统可尝试2.0或1.0
• 生产环境不要明文写共享密码，可通过Docker secrets、环境变量传递敏感信息

3. 修改appsettings.json配置 #

直接将监听路径改为容器内的挂载路径即可：

{
  "SharedFolderPath": "/app/mounted_share"
}

直接把上述配置值传入你代码里的folder变量，FileSystemWatcher就可以正常监听文件变动。

常见问题排查 #

• 监听无响应时先进入容器，执行ls /app/mounted_share确认共享挂载正常、文件可访问
• 挂载失败优先排查SMB版本参数、账号权限是否正确
• 不要给路径加file://前缀，FileSystemWatcher仅识别标准本地文件路径格式

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