znedw/samba

Samba镜像文档

镜像概述

本镜像是基于Alpine Linux的Samba 4+实现，专为非交互式运行设计（例如不通过docker run直接交互启动），需通过绑定挂载配置文件使用。该镜像不包含NETBIOS、Avahi服务及主服务器功能，适用于特定使用场景。

核心功能与特性

• 基于Alpine Linux，体积小巧
• 集成Samba 4+服务
• 非交互式运行模式
• 需通过绑定挂载外部配置文件
• 精简设计：无NETBIOS、Avahi及主服务器功能

使用场景

适用于需要简单Samba文件共享服务，且用户希望自行管理配置文件的场景，尤其适合对服务组件有明确精简需求的环境。

使用方法

Docker运行

bash
docker create \
  -v $PWD/smb.conf:/etc/samba/smb.conf \
  -v /mnt/storage/tv:/share \
  -p 445:445 \
  --name samba \
  --restart=always \
  znedw/samba

Docker Compose配置

yaml
version: '2'
services:
  samba:
    image: znedw/samba:latest
    container_name: samba
    restart: always
    environment:
      - PUID=1000  # 用户ID，用于文件权限映射
      - PGID=1000  # 用户组ID，用于文件权限映射
      - TZ=Australia/Brisbane  # 时区设置
    ports:
      - '445:445'  # Samba服务端口
    volumes:
      - '/docker/samba/smb.conf:/etc/samba/smb.conf'  # 绑定挂载配置文件
      - '/mnt/storage:/share'  # 绑定挂载共享目录

添加用户

1. 创建系统用户（无登录权限）：

bash
docker exec -it samba adduser -s /sbin/nologin -h /home/samba -H -D <username>

2. 设置Samba用户密码：

bash
docker exec -it samba smbpasswd -a <username>

示例smb.conf配置

ini
[global]
  workgroup = WORKGROUP  # 工作组名称
  server string = %h server (Samba, Alpine)  # 服务器描述
  security = user  # 安全模式为用户认证
  map to guest = Bad User  # 错误用户映射为来宾
  encrypt passwords = yes  # 启用密码加密
  load printers = no  # 不加载打印机
  printing = bsd  # 打印系统类型
  printcap name = /dev/null  # 禁用打印功能
  disable spoolss = yes  # 禁用打印假脱机服务
  disable netbios = yes  # 禁用NETBIOS
  server role = standalone  # 独立服务器模式
  server services = -dns, -nbt  # 禁用DNS和NBT服务
  smb ports = 445  # Samba服务端口
  ;name resolve order = hosts  # 名称解析顺序（注释）
  ;log level = 3  # 日志级别（注释）

[storage]  # 共享名称
  path = /share  # 共享目录路径
  comment = Shared Folder  # 共享描述
  browseable = yes  # 可浏览
  writable = yes  # 可写
  write list = <username>  # 允许写入的用户列表
  valid users = <username>  # 允许访问的用户列表

参考来源

本镜像借鉴自 https://github.com/Stanback/alpine-samba 和 https://github.com/dperson/samba