adrianmusante/samba

Samba Docker镜像文档

!https://github.com/adrianmusante/docker-samba/assets/38815440/f72b6c2a-637d-4a66-bbb9-7db4cbde3bb4

镜像概述和主要用途

本镜像为Samba服务器的Docker化实现，基于https://github.com/dperson/samba%E8%BF%9B%E8%A1%8C%E6%9B%B4%E6%96%B0%E7%BB%B4%E6%8A%A4%E3%80%82Samba%E6%98%AF%E4%B8%80%E6%AC%BE%E5%BC%80%E6%BA%90%E8%BD%AF%E4%BB%B6%EF%BC%8C%E8%87%AA1992%E5%B9%B4%E8%B5%B7%E6%8F%90%E4%BE%9B%E5%9F%BA%E4%BA%8ESMB/CIFS%E5%8D%8F%E8%AE%AE%E7%9A%84%E6%96%87%E4%BB%B6%E5%92%8C%E6%89%93%E5%8D%B0%E6%9C%8D%E5%8A%A1%EF%BC%8C%E6%94%AF%E6%8C%81DOS%E3%80%81Windows%E3%80%81OS/2%E3%80%81Linux%E7%AD%89%E6%89%80%E6%9C%89SMB/CIFS%E5%AE%A2%E6%88%B7%E7%AB%AF%EF%BC%8C%E5%AE%9E%E7%8E%B0%E8%B7%A8%E5%B9%B3%E5%8F%B0%E6%96%87%E4%BB%B6%E5%85%B1%E4%BA%AB%E3%80%82

核心功能和特性

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

适用场景和适用范围

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

Docker镜像仓库

获取镜像

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

bash
docker pull adrianmusante/samba

可用标签

• 4、4.21、latest（基于https://github.com/adrianmusante/docker-samba/blob/main/samba/Dockerfile%E6%9E%84%E5%BB%BA%EF%BC%89

查看https://hub.docker.com/r/adrianmusante/samba/tags/%E8%8E%B7%E5%8F%96%E6%89%80%E6%9C%89%E5%8F%AF%E7%94%A8%E7%89%88%E6%9C%AC%E3%80%82

配置指南

基础使用方法

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

快速启动（无本地存储）

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

挂载本地存储启动

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

命令行选项

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

bash
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，配置公共共享和私有共享：

bash
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：

yaml
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

启动服务：

bash
docker-compose up -d

故障排除

常见问题及解决方法

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

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

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

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

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

2. Samba进程内存占用过高

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

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

或在docker-compose中添加：

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

3. 使用smbclient连接失败

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

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

问题反馈

如遇问题或有疑问，请通过https://github.com/adrianmusante/docker-samba/issues%E6%8F%90%E4%BA%A4%E5%8F%8D%E9%A6%88%E3%80%82

参考链接

• Samba官方网站
• https://hub.docker.com/r/adrianmusante/samba
• https://github.com/adrianmusante/docker-samba