m4rc77/samba

Samba Docker镜像

镜像概述

Samba是一款开源软件，自1992年起为所有使用SMB/CIFS协议的客户端（如DOS、Windows、OS/2、Linux等）提供安全、稳定且快速的文件和打印服务。本Docker镜像封装了Samba服务，方便用户快速部署和配置跨平台文件共享。

核心功能

• 支持SMB/CIFS协议，实现跨操作系统的文件共享
• 灵活的用户管理（添加用户、设置密码与ID）
• 精细化共享配置（可浏览性、读写权限、访客访问、允许用户列表等）
• 高级功能：字符映射、全局配置、符号链接访问、时区设置等
• 支持命令行参数与环境变量两种配置方式

使用场景

• 企业内部Windows与Linux系统间的文件交换
• 家庭网络中多设备（PC、NAS、智能设备）的文件共享
• 开发环境中容器与主机或容器间的文件传递
• 临时团队协作的文件共享服务搭建

配置说明

快速部署示例

基础启动

bash
sudo docker run -it -p 139:139 -p 445:445 -d m4rc77/samba -p

挂载本地目录

bash
sudo docker run -it --name samba -p 139:139 -p 445:445 \
    -v /本地目录路径:/容器内挂载路径 \
    -d m4rc77/samba -p

创建用户与共享

bash
sudo docker run -it -p 139:139 -p 445:445 -d m4rc77/samba -p \
    -u "user1;pass1" \
    -u "user2;pass2" \
    -s "public;/share" \
    -s "private;/srv;no;no;no;user1,user2"

关键参数说明

• -u "<用户名;密码>[;ID;组;GID]": 添加用户（如-u "admin;123456;1000;admin;1000"）
• -s "<名称;/路径>[;可浏览;只读;访客;允许用户;管理员;可写列表;描述]": 配置共享（如-s "docs;/data;yes;no;no;user1"）
• -w "<工作组>": 设置工作组（默认通常为WORKGROUP）
• -p: 自动设置共享目录的所有权和权限
• -n: 启动nmbd守护进程（需额外暴露UDP端口137、138）

环境变量说明

• TZ: 设置时区（如EST5EDT或Asia/Shanghai）
• USERID/GROUPID: 调整默认用户的UID/GID以匹配本地文件权限
• SHARE/SHARE2...: 通过环境变量配置共享（格式同-s参数）
• USER/USER2...: 通过环境变量添加用户（格式同-u参数）

常见问题解决

• 访问被拒绝: 添加-p参数或设置PERMISSIONS环境变量，或调整USERID/GROUPID与本地文件所有者一致
• 高内存占用: 启动容器时添加-m 512m限制内存使用
• smbclient连接失败: 使用smbclient -m SMB3指定SMB3协议连接
• 共享不显示: 添加-n参数并暴露UDP端口137、138（建议使用主机网络模式）

若需更多帮助，请通过https://github.com/m4rc77/samba/issues%E5%8F%8D%E9%A6%88%E9%97%AE%E9%A2%98%E3%80%82