upagge/samba

Samba Docker镜像

镜像概述

本仓库是https://github.com/dperson/samba项目的分支，由于原项目已长期停止更新，此版本包含适用于当前Alpine版本的最新Samba。Samba自1992年起，为所有使用SMB/CIFS协议的客户端（如DOS、Windows、OS/2、Linux等）提供安全、稳定且快速的文件和打印服务。

Samba版本说明

镜像标签对应容器中Samba的版本。如需特定版本，可使用相应标签。latest标签始终指向最新稳定版，develop标签指向开发版。当前Samba版本取决于Alpine镜像中可安装的版本，若Samba有新版本但未在此镜像中更新，通常是因为Alpine尚未更新该版本。

核心功能与特性

• 支持SMB/CIFS协议，实现跨平台文件和打印共享
• 可配置多用户及权限管理
• 支持共享目录设置，包括可浏览性、读写权限、访客访问等
• 提供字符映射、全局配置、通用配置等高级选项
• 支持导入smbpassword文件
• 可启用nmbd守护进程以广播共享
• 支持设置工作组、时区、回收站功能等

使用场景

适用于需要在局域网内实现跨平台文件共享的场景，如家庭网络文件共享、企业内部文件服务、开发环境资源共享等。

使用方法

默认无共享配置，需额外添加。

部署Samba实例

基础部署：

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

挂载本地存储：

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

配置选项

查看帮助：

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

命令行选项（[]为可选，<>为必填）：

• -h：显示帮助信息
• -c "<from:to>"：设置文件/目录名的字符映射，必填参数为用逗号分隔的"from:to"映射对
• -G "<section;parameter>"：为smb.conf提供通用节选项，必填参数："
  "（如"share"）和""（如"log level = 2"）
• -g "<parameter>"：为smb.conf提供全局选项，必填参数：""（如"log level = 2"）
• -i "<path>"：导入smbpassword文件，必填参数：容器内的完整文件路径
• -n：启动nmbd守护进程以广播共享
• -p：设置共享的所有权和权限
• -r：禁用共享的回收站功能
• -S：禁用SMB2最低版本
• -s "<name;/path>[;browse;readonly;guest;users;admins;writelist;comment]"：配置共享
  • 必填参数：";"（为客户端显示名称，为共享路径）
  • [browsable]：是否可浏览，默认"yes"或"no"
  • [readonly]：是否只读，默认"yes"或"no"
  • [guest]：是否允许访客访问，默认"yes"或"no"
  • [users]：允许访问的用户，默认"all"或用户列表（用逗号分隔）
  • [admins]：管理员用户，默认"none"或用户列表（用逗号分隔）
  • [writelist]：可写入只读共享的用户列表
  • [comment]：共享描述
• -u "<username;password>[;ID;group;GID]"：添加用户
  • 必填参数：";"（用户名和密码）
  • [ID]：用户ID
  • [group]：用户组
  • [GID]：组ID
• -w "<workgroup>"：配置工作组（域），必填参数：""
• -W：允许访问宽符号链接
• -I "<include file path>"：在smb.conf末尾添加include选项，必填参数：容器内的包含文件路径（如绑定挂载的文件）

环境变量

• CHARMAP：同-c，配置字符映射
• GENERIC：同-G，配置通用节选项（见注3）
• GLOBAL：同-g，配置全局选项（见注3）
• IMPORT：同-i，导入smbpassword文件
• NMBD：同-n，启用nmbd
• PERMISSIONS：同-p，设置所有共享的文件权限
• RECYCLE：同-r，禁用回收站
• SHARE：同-s，配置共享（见注3）
• SMB：同-S，禁用SMB2最低版本
• TZ：设置时区，如EST5EDT
• USER：同-u，添加用户（见注3）
• WIDELINKS：同-W，允许访问宽符号链接
• WORKGROUP：同-w，设置工作组
• USERID：设置Samba默认用户（smbuser）的UID
• GROUPID：设置Samba默认用户（smbuser）的GID
• INCLUDE：同-I，添加smb.conf包含文件

注：若启用nmbd（通过-n或NMBD环境变量），需暴露137和138端口：-p 137:137/udp -p 138:138/udp。

注2：有报告称-n和NMBD仅在容器使用主机网络栈时有效。

注3：支持以相同名称开头的附加变量，如SHARE可扩展为SHARE2、SHARE3...SHAREx等。

使用示例

以下命令可在创建容器时通过docker run执行，或之后通过docker exec -it samba samba.sh（Docker 1.3及以上版本）执行。

设置时区

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

创建用户和共享

bash
sudo docker run -it -p 139:139 -p 445:445 -d upagge/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"

故障排除

客户端提示“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 upagge/samba -p

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

Samba进程内存占用过高

在docker run命令中添加-m 512m选项，或在docker_compose.yml中设置mem_limit:：

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

使用smbclient命令行工具连接

Samba默认尝试使用已弃用且有安全问题的SMB1，本容器默认使用SMB2，需指定SMB3版本：

bash
smbclient -m SMB3 [其他选项]

问题反馈

如遇问题或有疑问，请通过https://github.com/upagge/samba/issues联系。