irobie/moby-cifs-mount

CIFS共享挂载Docker镜像

镜像概述和主要用途

本镜像用于将远程CIFS共享自动挂载到Docker主机，提供了一种简单的方式在Docker环境中访问CIFS网络共享资源，特别适用于需要在Windows Docker主机上挂载CIFS共享的场景。

核心功能和特性

• 自动将远程CIFS共享挂载到Docker主机指定目录
• 使用nsenter工具访问主机命名空间，实现主机级别的挂载操作
• 通过inotifywait监控挂载目录变化并输出日志
• 支持多种基于Moby Linux的Docker平台

使用场景和适用范围

• 需要在Docker环境中访问远程CIFS共享资源的场景
• Windows Docker主机用户需要挂载CIFS共享的场景
• 与Synology NAS等设备配合使用的Windows客户端环境
• 适用于Docker for AWS、Docker for Windows等平台（Docker for Mac未测试）

使用方法和配置说明

基本使用命令

bash
docker run -d \
    --privileged --pid=host \
    --restart=unless-stopped \
    -e SERVER=//server/cifsdir  \
    -e MOUNT=/mnt/folder \
    -e OPTIONS=username=user,password=Password,file_mode=0777,dir_mode=0777 \
    thisrepo

环境变量说明

• SERVER: 远程CIFS共享路径（例如：//server/cifsdir）
• MOUNT: 主机上用于挂载的本地目录（例如：/mnt/folder）
• OPTIONS: CIFS挂载选项（可选），格式为逗号分隔的键值对，如：username=user,password=Password,file_mode=0777,dir_mode=0777

在容器中使用挂载的共享

挂载完成后，可以通过卷挂载方式在其他容器中访问共享资源：

bash
docker run --rm -v /mnt/folder:/data alpine ls /data

支持的平台

• Docker for AWS
• Docker for Windows
• 任何基于Alpine的Docker主机
• Docker for Mac（未测试）

工作原理

1. 使用nsenter工具访问主机命名空间
2. 根据环境变量MOUNT指定的路径在主机上挂载CIFS共享
3. 通过inotifywait监控挂载目录的变化并输出日志

注意事项

本镜像基于https://github.com/vipconsult/dockerfiles/tree/master/moby-nfs-mount%E9%A1%B9%E7%9B%AE%E5%88%86%E5%8F%89%E4%BF%AE%E6%94%B9%EF%BC%8C%E6%97%A8%E5%9C%A8%E8%A7%A3%E5%86%B3Windows%E5%AE%A2%E6%88%B7%E7%AB%AF%E4%B8%8ESynology NAS配合使用的场景需求。