servercontainers/samba Docker 镜像

servercontainers查看 Docker Hub 原文页

自动构建

基于Alpine的Samba文件共享服务镜像，支持可选的zeroconf、wsdd2及Time Machine备份功能，适用于x86和arm架构。

92 次收藏下载次数: 0状态：自动构建维护者：servercontainers仓库类型：镜像最近更新：3 个月前

DockerHub 官方简介

轩辕镜像中文简介

下载命令

镜像标签列表与下载命令

轩辕镜像，不浪费每一次拉取。

点击查看

samba - (ghcr.io/servercontainers/samba) [x86 + arm]

重要提示

新仓库地址: ghcr.io/servercontainers/samba

2023年3月，Docker通知将移除servercontainers和desktopcontainers组织，除非升级到专业计划。为避免***用户接管原组织名称并发布可能带有后门的容器，建议切换至新的GitHub仓库地址：ghcr.io/servercontainers。

镜像概述与主要用途

基于Alpine Linux的Samba服务器容器，支持TimeMachine备份、zeroconf（Avahi）网络发现和WSD（Web Services for Devices，wsdd2）服务，适用于x86和ARM架构。主要用于搭建轻量级跨平台文件共享服务，支持Windows、macOS和Linux客户端，尤其适合家庭或小型办公环境。

核心功能与特性

轻量级基础：基于Alpine Linux，体积小、资源占用低
完整Samba支持：包含smbd服务，实现标准文件共享功能
可选网络发现：集成Avahi（zeroconf）用于macOS发现，wsdd2（WSD）用于Windows网络发现
TimeMachine支持：原生支持macOS TimeMachine备份，含多用户隔离功能
多架构兼容：支持x86_64、arm64和arm架构
灵活用户管理：通过环境变量创建用户/组，支持明文密码或Samba哈希
可定制配置：通过环境变量灵活配置全局Samba参数和共享卷
多变体选择：提供含/不含Avahi/wsdd2的变体镜像，满足不同场景需求

使用场景与适用范围

家庭或小型办公环境的跨平台文件共享服务器
macOS用户的TimeMachine网络备份存储
需要zeroconf（Avahi）或WSD（wsdd2）服务发现的场景
资源受限环境（如嵌入式设备、NAS）的轻量级文件服务
需快速部署、支持多架构的临时共享服务

使用方法

部署示例

docker run 快速启动

bash
docker run -d \
  --name samba \
  --net=host \
  -v /path/to/shares:/shares \
  -e ACCOUNT_user1=password123 \
  -e SAMBA_VOLUME_CONFIG_myshare="path = /shares/myshare; valid users = user1; read only = no" \
  -e MODEL=TimeCapsule \
  --cap-add=CAP_NET_ADMIN \
  ***-ghcr.xuanyuan.run/servercontainers/samba:latest

docker-compose 配置示例

yaml
version: '3'
services:
  samba:
    image: ***-ghcr.xuanyuan.run/servercontainers/samba:latest
    container_name: samba
    network_mode: host  # 如需Avahi/wsdd2发现，建议使用host网络
    volumes:
      - /path/to/shares:/shares  # 共享文件存储路径
    environment:
      # 用户配置（用户名:密码/哈希）
      - ACCOUNT_user1=password123
      - ACCOUNT_admin=:0:1001:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:8846F7EAEE8FB117AD06BDD830B7586C:[U          ]:LCT-5FE1F7DF:  # 哈希示例
      # 用户UID指定
      - UID_user1=1000
      # 组配置
      - GROUP_devops=1500
      # 用户附加组
      - GROUPS_admin=devops
      # 全局配置
      - SAMBA_GLOBAL_CONFIG_workgroup=MYGROUP
      - SAMBA_GLOBAL_CONFIG_server_string=My Samba Server
      - SAMBA_GLOBAL_STANZA=log level = 2; max log size = 50  # 多行全局配置，用;分隔
      # 共享卷配置（TimeMachine示例）
      - SAMBA_VOLUME_CONFIG_timemachine="path = /shares/timemachine/%U; valid users = %U; fruit:time machine = yes; fruit:time machine max size = 500G"
      # Avahi配置
      - MODEL=MacPro7,1
      - AVAHI_NAME=MySambaServer
    cap_add:
      - CAP_NET_ADMIN  # wsdd2需要此权限
    restart: unless-stopped

配置参数详解

环境变量

Samba 全局配置

变量名	说明	可选性	默认值	示例值
SAMBA_GLOBAL_STANZA	多行全局配置，用`;`分隔（自动转为`\n`）	可选	未设置	`log level = 2; max log size = 50`
SAMBA_GLOBAL_CONFIG_<唯一标识>	单个全局配置项，键含空格用`_SPACE_`替换，含冒号用`_COLON_`替换	可选	未设置	`SAMBA_GLOBAL_CONFIG_mykey=workgroup = MYGROUP`
SAMBA_CONF_SERVER_ROLE	Samba服务器角色	可选	standalone server	member server
SAMBA_CONF_LOG_LEVEL	日志级别	可选	1	3
SAMBA_CONF_WORKGROUP	工作组名称	可选	WORKGROUP	MYGROUP
SAMBA_CONF_SERVER_STRING	服务器描述信息	可选	Samba Server	"Office File Server"
SAMBA_CONF_MAP_TO_GUEST	***用户映射策略	可选	Bad User	Never

用户与组管理

变量名	说明	可选性	默认值	示例值
ACCOUNT_<用户名>	创建用户，值为明文密码（不可以`:<用户名>:[0-9]*:`开头）或Samba哈希	必选	未设置	ACCOUNT_user1=password123
UID_<用户名>	指定用户UID，需与ACCOUNT_<用户名>对应	可选	自动分配	UID_user1=1000
GROUP_<组名>	创建组，值为GID	可选	未设置	GROUP_devops=1500
GROUPS_<用户名>	为用户添加附加组，用`,`分隔，需与GROUP_<组名>对应	可选	未设置	GROUPS_user1=devops,users

Avahi 配置

变量名	说明	可选性	默认值	示例值
MODEL	Avahi服务设备型号	可选	TimeCapsule	MacPro7,1
AVAHI_NAME	Avahi服务名称	可选	容器 hostname	MySambaServer
AVAHI_DISABLE	禁用Avahi服务（设任意值即禁用）	可选	未设置	1

wsdd2 配置

变量名	说明	可选性	默认值	示例值
WSDD2_DISABLE	禁用wsdd2服务（设任意值即禁用）	可选	未设置	1
WSDD2_PARAMETERS	wsdd2启动参数	可选	未设置	-l

共享卷配置

变量名	说明	可选性	默认值	示例值
SAMBA_VOLUME_CONFIG_<唯一标识>	共享卷配置，多行用`;`分隔；路径以`%U`结尾时启用多用户隔离（如TimeMachine）	可选	未设置	`path = /shares/timemachine/%U; fruit:time machine = yes; valid users = %U`

卷挂载

挂载路径	说明	必要性
/shares	共享文件存储目录，需提前创建并授权	建议
/external/avahi	外部Avahi服务目录（覆盖容器内置配置）	可选

镜像变体

镜像标签格式	说明
latest a<alpine版本>-s<samba版本>	完整版本：含smbd、Avahi、wsdd2，可通过环境变量禁用可选服务（如AVAHI_DISABLE）
smbd-only-latest smbd-only-a<...>-s<...>	仅含smbd和基础脚本，无Avahi/wsdd2
smbd-avahi-latest smbd-avahi-a<...>-s<...>	含smbd、Avahi和脚本，无wsdd2
smbd-wsdd2-latest smbd-wsdd2-a<...>-s<...>	含smbd、wsdd2和脚本，无Avahi

标签中a<alpine版本>-s<samba版本>格式（如a3.15.0-s4.15.2）可用于固定版本，便于回滚或版本控制。

构建信息

构建脚本

构建多变体：通过build.sh脚本构建x86_64/arm64/arm镜像，指定DOCKER_REGISTRY环境变量可自定义仓库
生成latest标签：执行./build.sh release生成latest标签
自定义变体：使用generate-variants.sh生成自定义变体配置并手动构建

标签说明

所有镜像标签格式为a<alpine版本>-s<samba版本>，如a3.15.0-s4.15.2，便于追溯基础镜像和Samba版本。

高级信息

TimeMachine与Avahi注意事项

多用户隔离：共享路径以%U结尾（如/shares/timemachine/%U）时，每个用户将获得独立子目录
Avahi网络模式：Avahi需--net=host网络模式或正确端口映射（UDP 5353）以确保macOS发现
容量限制：通过fruit:time machine max size = 500G限制单用户TimeMachine容量

Windows 10网络发现配置

wsdd2权限：wsdd2服务需CAP_NET_ADMIN权限（--cap-add=CAP_NET_ADMIN）
主机名设置：非host网络模式下，通过hostname参数指定容器主机名（避免随机生成的名称影响发现）

变更日志

2023-03-20：迁移至GitHub Actions构建，使用ghcr.io仓库
2023-02-06：修复用户名哈希时的大小写问题（统一转为小写）
2022-05-31：支持通过环境变量设置server role
2021-12-30：支持禁用wsdd2，日志输出到stdout，Avahi服务可选
2021-12-25：支持多用户共享卷，移除bash以减小体积
2021-08-27：添加wsdd2支持Windows网络发现
2020-12-22：支持Samba密码哈希（替代明文密码）
2020-12-10：添加TimeMachine多用户支持（路径需含%U）
2020-11-05：重构为Alpine基础，支持多架构构建

参考链接

Samba配置文档：https://wiki.samba.org/index.php/Configure_Samba_to_Work_Better_with_Mac_OS_X
wsdd2项目：https://github.com/Netgear/wsdd2
Avahi服务配置：avahi.service(5)

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 samba 镜像标签

docker pull docker.xuanyuan.run/servercontainers/samba:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull servercontainers/samba:<标签>

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"