mumiehub/smb-mount

SMB Mount Container 镜像文档

镜像概述

基于 alpine:latest 构建的轻量级容器镜像，集成 cifs-utils 工具，专为在Docker环境中挂载SMB/CIFS共享目录设计。该镜像体积小巧，配置灵活，适用于需要在容器化环境中访问SMB共享资源的场景。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 完整工具链：内置 cifs-utils，支持SMB/CIFS协议挂载
• 灵活配置：通过环境变量自定义SMB服务器路径、挂载选项和权限
• 持久化挂载：支持与主机目录共享挂载点，实现数据持久化

使用场景

• Docker环境中需要访问远程SMB共享资源
• 跨平台文件共享服务（如Windows、Linux之间的文件交换）
• 需要统一权限管理的容器化应用数据存储
• 开发/测试环境中快速挂载网络共享目录

使用方法

基本部署命令

bash
docker run -d --name smb-mount \
    --restart=unless-stopped \
    --cap-add SYS_ADMIN \
    --cap-add DAC_READ_SEARCH \
    --security-opt apparmor:unconfined \
    -e SERVERPATH="//exampleserver/folder" \
    -e MOUNTOPTIONS="vers=3.1.1,uid=1000,gid=1000,rw,username=user,password=example" \
    -v /mnt/HostMountPoint:/mnt/smb:shared \
    mumiehub/smb-mount

必要参数说明

必须的容器权限

• --cap-add SYS_ADMIN：允许容器执行挂载操作
• --cap-add DAC_READ_SEARCH：提供必要的文件访问权限
• --security-opt apparmor:unconfined：禁用AppArmor限制，确保挂载功能正常

必须的卷映射

• -v /mnt/HostMountPoint:/mnt/smb:shared：将主机目录 /mnt/HostMountPoint 与容器内 /mnt/smb 挂载点共享，:shared 选项允许其他容器访问此挂载点

环境变量配置

设置文件夹权限示例

通过 MOUNTOPTIONS 可配置文件和目录权限：

bash
MOUNTOPTIONS="vers=3.1.1,uid=1000,gid=1000,file_mode=0755,dir_mode=0755,rw,username=user,password=example"

故障排除

• 强制删除容器后处理：若强制删除容器，需在主机执行 sudo umount /mnt/HostMountPoint 手动卸载共享目录
• Windows Server 2016兼容性：挂载Windows Server 2016的SMB共享时，建议使用 MOUNTOPTIONS="vers=3.02"

许可证

详见 LICENSE