stuckj/samba

Samba Docker镜像

镜像概述

该镜像基于https://hub.docker.com/r/dperson/samba构建，仅添加了允许用户不强制为smbuser的选项。Samba自1992年起为所有使用SMB/CIFS协议的客户端（如Windows、Linux、OS/2等）提供安全、稳定、快速的文件和打印服务。

核心功能

• 支持SMB/CIFS协议，兼容多平台客户端
• 灵活配置共享目录（名称、路径、可浏览性、读写权限、访客访问等）
• 添加用户并设置密码、ID、组及GID
• 配置工作组（域）、字符映射、全局选项
• 支持导入smbpassword文件、启用nmbd服务、设置时区等
• 可禁用SMB2最低版本、允许宽符号链接访问

使用场景

• 局域网内跨平台文件共享（Windows与Linux之间的文件交换）
• 团队协作中的文件存储与访问
• 小型办公环境的打印服务共享

配置说明

命令行选项

通过docker run命令可传递以下关键选项：

• -p：设置共享目录的所有权和权限
• -u "<username;password>[;ID;group;GID]"：添加用户
• -s "<name;/path>[;browse;readonly;guest;users;admins;writelist;comment]"：配置共享目录
• -w "<workgroup>"：设置工作组
• -n：启动nmbd服务以广播共享（需暴露137/udp、138/udp端口）
• -f：不强制用户为smbuser

环境变量

支持通过环境变量配置，如TZ（设置时区）、USER（添加用户）、SHARE（配置共享）、WORKGROUP（工作组）等，也支持SHARE2、USER3等扩展变量。

部署示例

基础运行

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

挂载本地存储

bash
sudo docker run -it --name samba -p 139:139 -p 445:445 \
    -v /path/to/local/dir:/mount \
    -d stuckj/samba -p

设置时区并创建用户和共享

bash
sudo docker run -it -e TZ=Asia/Shanghai -p 139:139 -p 445:445 -d stuckj/samba -p \
    -u "user1;pass123" \
    -u "user2;pass456" \
    -s "public;/share;yes;yes;yes;all" \
    -s "private;/private;no;no;no;user1"

注意事项

• 启用nmbd服务时需暴露137/udp和138/udp端口
• 若遇到高内存占用问题，可通过-m 512m限制容器内存
• 使用smbclient连接时建议指定SMB3版本：smbclient -m SMB3 //ip/share

用户反馈

若遇到问题，可通过https://github.com/stuckj/samba/issues提交反馈。