mumiehub/smb-mount Docker Image Overview

mumiehub/smb-mount

自动构建

mumiehub

基于Alpine的轻量级SMB挂载容器，集成cifs-utils工具，用于在Docker环境中便捷挂载SMB/CIFS共享目录，支持自定义挂载选项和权限配置。

12 次收藏下载次数: 0状态：自动构建维护者：mumiehub仓库类型：镜像最近更新：1 年前

使用轩辕镜像，把时间还给真正重要的事。点击查看

中文简介版本下载

使用轩辕镜像，把时间还给真正重要的事。点击查看

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 选项允许其他容器访问此挂载点

环境变量配置

环境变量	描述	默认值
`AccessFolder`	访问测试目录	`/mnt`
`SERVERPATH`	SMB服务器路径（格式：`//服务器地址/共享目录`）	`//192.168.1.1/example`
`MOUNTPOINT`	容器内挂载点路径（需与卷映射中的容器路径一致）	`/mnt/smb`
`MOUNTOPTIONS`	SMB挂载选项（包含认证信息和权限配置）	`vers=3.1.1,uid=1000,gid=1000,rw,username=user,password=example`
`UMOUNTOPTIONS`	卸载选项	`-a -t cifs -l`

设置文件夹权限示例

通过 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"