轩辕镜像
轩辕镜像专业版
个人中心搜索镜像
交易
充值流量我的订单
工具
工单支持镜像收录Run 助手IP 归属地密码生成Npm 源Pip 源
帮助
常见问题我要吐槽
其他
关于我们网站地图

官方QQ群: 13763429

轩辕镜像
镜像详情
servercontainers/samba
官方博客使用教程热门镜像工单支持
本站面向开发者与科研用户，提供开源镜像的搜索和下载加速服务。
所有镜像均来源于原始开源仓库，本站不存储、不修改、不传播任何镜像内容。
轩辕镜像 - 国内开发者首选的专业 Docker 镜像下载加速服务平台 - 官方QQ群:13763429 👈点击免费获得技术支持。
本站面向开发者与科研用户，提供开源镜像的搜索和下载加速服务。所有镜像均来源于原始开源仓库，本站不存储、不修改、不传播任何镜像内容。

本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

samba Docker 镜像下载 - 轩辕镜像

samba 镜像详细信息和使用指南

samba 镜像标签列表和版本信息

samba 镜像拉取命令和加速下载

samba 镜像使用说明和配置指南

Docker 镜像加速服务 - 轩辕镜像平台

国内开发者首选的 Docker 镜像加速平台

极速拉取 Docker 镜像服务

相关 Docker 镜像推荐

热门 Docker 镜像下载

samba
servercontainers/samba
自动构建

samba 镜像详细信息

samba 镜像标签列表

samba 镜像使用说明

samba 镜像拉取命令

Docker 镜像加速服务

轩辕镜像平台优势

镜像下载指南

相关 Docker 镜像推荐

基于Alpine的Samba文件共享服务镜像，支持可选的zeroconf、wsdd2及Time Machine备份功能，适用于x86和arm架构。
84 收藏0 次下载activeservercontainers镜像
🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源
中文简介版本下载
🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

samba 镜像详细说明

samba 使用指南

samba 配置说明

samba 官方文档

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 快速启动

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.io/servercontainers/samba:latest

docker-compose 配置示例

version: '3'
services:
  samba:
    image: ghcr.io/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_ROLESamba服务器角色可选standalone servermember server
SAMBA_CONF_LOG_LEVEL日志级别可选13
SAMBA_CONF_WORKGROUP工作组名称可选WORKGROUPMYGROUP
SAMBA_CONF_SERVER_STRING服务器描述信息可选Samba Server"Office File Server"
SAMBA_CONF_MAP_TO_GUEST匿名用户映射策略可选Bad UserNever

用户与组管理

变量名说明可选性默认值示例值
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 配置

变量名说明可选性默认值示例值
MODELAvahi服务设备型号可选TimeCapsuleMacPro7,1
AVAHI_NAMEAvahi服务名称可选容器 hostnameMySambaServer
AVAHI_DISABLE禁用Avahi服务（设任意值即禁用）可选未设置1

wsdd2 配置

变量名说明可选性默认值示例值
WSDD2_DISABLE禁用wsdd2服务（设任意值即禁用）可选未设置1
WSDD2_PARAMETERSwsdd2启动参数可选未设置-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配置文档：Configure Samba to Work Better with Mac OS X
  • wsdd2项目：Netgear/wsdd2
  • Avahi服务配置：avahi.service(5)
查看更多 samba 相关镜像 →
dockurr/samba logo
dockurr/samba
by dockurr
Docker容器化的Samba，Windows SMB网络协议的实现
741M+ pulls
上次更新：4 个月前
crazymax/samba logo
crazymax/samba
by crazymax
基于Alpine Linux的Samba镜像，用于容器化部署Samba服务，实现跨平台文件共享功能
241M+ pulls
上次更新：15 天前

常见问题

轩辕镜像免费版与专业版有什么区别？

免费版仅支持 Docker Hub 加速，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

轩辕镜像免费版与专业版有分别支持哪些镜像？

免费版仅支持 docker.io；专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。

流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

轩辕镜像下载加速使用手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

🔐

登录方式进行 Docker 镜像下载加速教程

通过 Docker 登录方式配置轩辕镜像加速服务，包含7个详细步骤

🐧

Linux Docker 镜像下载加速教程

在 Linux 系统上配置轩辕镜像源，支持主流发行版

🖥️

Windows/Mac Docker 镜像下载加速教程

在 Docker Desktop 中配置轩辕镜像加速，适用于桌面系统

📦

Docker Compose 镜像下载加速教程

在 Docker Compose 中使用轩辕镜像加速，支持容器编排

📋

K8s containerd 镜像下载加速教程

在 k8s 中配置 containerd 使用轩辕镜像加速

🔧

宝塔面板 Docker 镜像下载加速教程

在宝塔面板中配置轩辕镜像加速，提升服务器管理效率

💾

群晖 NAS Docker 镜像下载加速教程

在 Synology 群晖NAS系统中配置轩辕镜像加速

🐂

飞牛fnOS Docker 镜像下载加速教程

在飞牛fnOS系统中配置轩辕镜像加速

📱

极空间 NAS Docker 镜像下载加速教程

在极空间NAS中配置轩辕镜像加速

⚡

爱快路由 ikuai Docker 镜像下载加速教程

在爱快ikuai系统中配置轩辕镜像加速

🔗

绿联 NAS Docker 镜像下载加速教程

在绿联NAS系统中配置轩辕镜像加速

🌐

威联通 NAS Docker 镜像下载加速教程

在威联通NAS系统中配置轩辕镜像加速

📦

Podman Docker 镜像下载加速教程

在 Podman 中配置轩辕镜像加速，支持多系统

📚

ghcr、Quay、nvcr、k8s、gcr 等仓库下载镜像加速教程

配置轩辕镜像加速9大主流镜像仓库，包含详细配置步骤

🚀

专属域名方式进行 Docker 镜像下载加速教程

无需登录即可使用轩辕镜像加速服务，更加便捷高效

需要其他帮助？请查看我们的 常见问题 或 官方QQ群: 13763429

商务：17300950906
|©2024-2025 源码跳动
商务合作电话：17300950906|Copyright © 2024-2025 杭州源码跳动科技有限公司. All rights reserved.