Samba Docker镜像文档

!logo

镜像概述和主要用途

本镜像为Samba服务器的Docker化实现，基于dperson/samba进行更新维护。Samba是一款开源软件，自1992年起提供基于SMB/CIFS协议的文件和打印服务，支持DOS、Windows、OS/2、Linux等所有SMB/CIFS客户端，实现跨平台文件共享。

核心功能和特性

• 跨平台兼容：支持所有使用SMB/CIFS协议的客户端系统，包括Windows、Linux、macOS等
• 安全稳定：提供安全的文件传输服务，支持用户认证与权限控制
• 灵活配置：支持自定义共享目录、用户管理、权限设置及全局配置
• 轻量部署：通过Docker容器化部署，简化安装与环境隔离
• 协议支持：默认支持SMB2/3协议，可配置禁用SMB2最低版本
• 功能扩展：支持字符映射、符号链接访问、回收站功能及日志级别调整

适用场景和适用范围

• 家庭网络共享：家庭局域网内多设备（PC、智能电视、手机）间文件共享
• 企业内部协作：跨操作系统（Windows/Linux/macOS）的团队文件协作
• 开发环境配置：为开发团队提供统一的共享资源池
• 嵌入式系统：在NAS设备或边缘计算节点中提供轻量级文件服务
• 临时文件交换：快速搭建临时共享服务，用于设备间文件传输

Docker镜像仓库

获取镜像

推荐从Docker Hub拉取预构建镜像：

docker pull adrianmusante/samba

可用标签

• 4、4.21、latest（基于samba/Dockerfile构建）

查看Docker Hub标签页面获取所有可用版本。

配置指南

基础使用方法

默认配置无共享目录，需通过参数或环境变量添加。

快速启动（无本地存储）

docker run -it -p 139:139 -p 445:445 -d adrianmusante/samba -p

挂载本地存储启动

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

命令行选项

启动容器时可通过命令行参数配置Samba服务。运行以下命令查看所有选项：

docker run -it --rm adrianmusante/samba -h

选项说明

环境变量配置

通过环境变量配置容器，支持多实例（如SAMBA_SHARE、SAMBA_SHARE2）。

注意：启用nmbd（-n或SAMBA_NMBD=true）时，需额外映射UDP端口：-p 137:137/udp -p 138:138/udp。部分环境下nmbd仅在使用主机网络模式时正常工作。

部署示例

示例1：基本文件共享（docker run）

创建用户alice和bob，配置公共共享和私有共享：

docker run -it --name samba -p 139:139 -p 445:445 \
  -v /data/public:/share/public \
  -v /data/alice:/share/alice \
  -v /data/bob:/share/bob \
  -d adrianmusante/samba -p \
  -u "alice;AlicePass123" \
  -u "bob;BobPass456" \
  -s "public;/share/public;yes;no;yes;all;;alice,bob;公共文件共享" \
  -s "alice_private;/share/alice;no;no;no;alice;;alice;Alice私有目录" \
  -s "bob_private;/share/bob;no;no;no;bob;;bob;Bob私有目录" \
  -w "MYHOME"

示例2：使用环境变量配置（docker-compose）

创建docker-compose.yml：

version: '3'
services:
  samba:
    image: adrianmusante/samba
    container_name: samba
    restart: always
    ports:
      - "139:139"
      - "445:445"
      - "137:137/udp"
      - "138:138/udp"
    volumes:
      - ./public:/share/public
      - ./team:/share/team
    environment:
      - TZ=Asia/Shanghai
      - PUID=1000
      - PGID=1000
      - SAMBA_WORKGROUP=MYTEAM
      - SAMBA_NMBD=true
      - SAMBA_PERMISSIONS=true
      - SAMBA_USER="john;JohnPass789;1001;team;100"
      - SAMBA_USER2="jane;JanePass321;1002;team;100"
      - SAMBA_SHARE="public;/share/public;yes;no;yes;all;;john,jane;公共共享区"
      - SAMBA_SHARE2="team;/share/team;yes;no;no;john,jane;;john,jane;团队协作区"
    command: -p

启动服务：

docker-compose up -d

故障排除

常见问题及解决方法

1. 客户端提示“访问被拒绝”或日志显示change_to_user_internal: chdir_current_service() failed!

解决：添加-p参数或设置SAMBA_PERMISSIONS=true以自动配置权限：

docker run ... -d adrianmusante/samba -p

若无法修改文件权限，可设置PUID和PGID匹配宿主机文件所有者ID：

docker run ... -e PUID=1000 -e PGID=1000 ...

2. Samba进程内存占用过高

解决：限制容器内存使用：

docker run ... -m 512m ...  # 限制最大内存为512MB

或在docker-compose中添加：

services:
  samba:
    ...
    deploy:
      resources:
        limits:
          memory: 512M

3. 使用smbclient连接失败

解决：默认禁用SMB1，需指定SMB3协议：

smbclient -m SMB3 //server_ip/share_name -U username

问题反馈

如遇问题或有疑问，请通过GitHub Issues提交反馈。

参考链接

• Samba官方网站
• Docker Hub镜像页面
• GitHub项目源码