dperson/samba

Samba Docker镜像

!https://raw.githubusercontent.com/dperson/samba/master/logo.jpg

镜像概述和主要用途

Samba是一款自1992年起提供SMB/CIFS协议文件和打印服务的开源软件，支持DOS、Windows、OS/2、Linux等多种客户端。本Docker镜像封装了Samba服务，可快速部署安全、稳定的文件共享服务，适用于家庭网络、办公环境等场景下的跨平台文件共享需求。

核心功能和特性

• 跨平台兼容：支持所有使用SMB/CIFS协议的客户端
• 灵活配置：可自定义共享目录、用户权限、工作组等
• 安全可靠：提供用户认证、读写权限控制
• 便捷部署：通过Docker命令或环境变量快速配置
• 功能扩展：支持字符映射、符号链接访问、回收站等高级功能

使用场景和适用范围

• 家庭网络中Windows与Linux系统间的文件共享
• 办公环境多用户协作的文件存储与访问
• 嵌入式设备或服务器的文件服务部署
• 需要快速搭建临时共享服务的场景

使用方法和配置说明

基本部署

默认无共享配置，需手动添加。

简单启动Samba实例

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

挂载本地存储启动

bash
sudo docker run -it --name samba -p 139:139 -p 445:445 \
            -v /path/to/directory:/mount \
            -d dperson/samba -p

配置选项

通过命令行参数或环境变量进行配置，可执行以下命令查看帮助：

bash
sudo docker run -it --rm dperson/samba -h

命令行选项

环境变量

注意：若启用nmbd（通过-n或NMBD环境变量），需额外暴露UDP端口：-p 137:137/udp -p 138:138/udp。有报告称nmbd仅在容器使用主机网络栈时正常工作。

使用示例

设置时区

bash
sudo docker run -it -e TZ=EST5EDT -p 139:139 -p 445:445 -d dperson/samba -p

创建用户和共享

bash
sudo docker run -it -p 139:139 -p 445:445 -d dperson/samba -p \
            -u "example1;badpass" \
            -u "example2;badpass" \
            -s "public;/share" \
            -s "users;/srv;no;no;no;example1,example2" \
            -s "example1 private share;/example1;no;no;no;example1" \
            -s "example2 private share;/example2;no;no;no;example2"

故障排除

常见问题解决

1. 客户端提示"Access is denied"或日志显示"change_to_user_internal: chdir_current_service() failed!"
   在容器选项末尾添加-p或设置PERMISSIONS环境变量：

   bash
   sudo docker run -it --name samba -p 139:139 -p 445:445 \
               -v /path/to/directory:/mount \
               -d dperson/samba -p
   

   若无法修改文件权限，可设置USERID和GROUPID环境变量为文件所有者的UID和GID。

2. Samba进程内存占用过高
   通过-m 512m限制容器内存：

   bash
   sudo docker run -it --name samba -m 512m -p 139:139 -p 445:445 \
               -v /path/to/directory:/mount \
               -d dperson/samba -p
   

3. 使用smbclient连接失败
   容器默认使用SMB2，需指定SMB3版本：

   bash
   smbclient -m SMB3 //server/share
   

问题反馈

如有任何问题或疑问，请通过https://github.com/dperson/samba/issues%E8%81%94%E7%B3%BB%E3%80%82