stanback/alpine-avahi

Samba 4 + Alpine Linux Docker镜像

概述

该镜像基于Alpine Linux构建，集成Samba 4实现网络文件共享功能。作为替代Netatalk（AFP）的解决方案，适用于自建ZFS NAS服务器，支持OSX、Linux和Windows多平台客户端连接。Apple已逐步转向SMB2/3协议，本镜像提供现代、安全的文件共享服务。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 多客户端兼容：支持OSX、Linux和Windows系统连接
• 安全强化：可限制网络访问范围和绑定接口，禁用NetBIOS、WINS等legacy协议
• 高级文件特性：支持ZFS POSIX风格ACL、回收站功能、OSX扩展属性（EA）支持
• 服务自动发现：可配合Avahi实现mDNS/DNS-SD（Bonjour）协议的网络发现

使用场景

• 个人或小型工作组文件服务器
• 基于ZFS的自建NAS系统
• 需要跨平台（OSX/Linux/Windows）文件共享的环境
• 对资源占用和网络安全性有要求的存储场景

使用方法和配置说明

创建Samba配置文件

创建smb.conf配置文件，以下为基础示例：

[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
  server role = standalone
  server services = -dns, -nbt
  smb ports = 445
  ;name resolve order = hosts
  ;log level = 3

[Dozer]
  path = /dozer
  comment = ZFS
  browseable = yes
  writable = yes
  valid users = carol

[Shared]
  path = /share
  comment = Shared Folder
  browseable = yes
  read only = yes
  write list = carol
  guest ok = yes

安全增强配置

在[global]部分添加以下配置可限制访问来源（尤其使用--net=host时）：

  hosts allow = 192.168.11.0/24 10.0.0.0/24
  hosts deny = 0.0.0.0/0
  interfaces = 192.168.11.0/24 10.0.0.0/24
  bind interfaces only = yes

高级特性配置

添加到[global]部分以优化客户端体验和ZFS兼容性：

  create mask = 0664
  directory mask = 0775
  veto files = /.DS_Store/
  nt acl support = no
  inherit acls = yes
  ea support = yes
  vfs objects = catia fruit streams_xattr recycle
  acl_xattr:ignore system acls = yes
  recycle:repository = .recycle
  recycle:keeptree = yes
  recycle:versions = yes

运行容器

根据smb.conf定义的共享路径调整卷挂载，执行启动命令：

bash
docker run -dt \
  -v $PWD/smb.conf:/etc/samba/smb.conf \
  -v $PWD/dozer:/dozer \
  -v $PWD/share:/share \
  -p 445:445 \
  --name samba \
  --restart=always \
  stanback/alpine-samba

参数说明：

• -v：挂载配置文件和共享目录（需与smb.conf中的路径对应）
• -p 445:445：映射SMB服务端口（或使用--net=host直接使用主机网络）
• --restart=always：配置容器自动重启

添加用户

容器运行后，通过以下命令添加Samba用户：

bash
# 创建系统用户（无登录权限）
docker exec -it samba adduser -s /sbin/nologin -h /home/samba -H -D carol
# 设置Samba密码
docker exec -it samba smbpasswd -a carol

检查状态

查看服务日志（可在smb.conf中调整log level）：

bash
docker logs -f --tail=100 samba

检查Samba连接状态：

bash
docker exec -it samba smbstatus

SSDP / ZeroConf服务发现

通过Avahi实现Linux和OSX客户端的自动发现功能（Windows需手动连接IP/主机名）。

配置Avahi服务

创建services/目录并添加smb.services文件：

xml
<?xml version="1.0" standalone='no'?>
<!DOCTYPE service-group SYSTEM "avahi-service.dtd">
<service-group>
 <name replace-wildcards="yes">%h</name>
 <service>
   <type>_smb._tcp</type>
   <port>445</port>
 </service>
 <service>
   <type>_device-info._tcp</type>
   <port>0</port>
   <txt-record>model=RackMac</txt-record>
 </service>
</service-group>

运行Avahi容器

bash
docker run -d \
  -v $PWD/services:/etc/avahi/services \
  --net=host \
  --name=avahi \
  --restart=always \
  stanback/alpine-avahi

注意：推荐使用--net=host确保服务发现功能正常，端口映射方式可能存在兼容性问题。

客户端配置

OSX优化

禁用网络共享中的.DS_Store文件：

bash
defaults write com.apple.desktopservices DSDontWriteNetworkStores true

禁用NetBIOS服务（谨慎操作）：

bash
sudo launchctl disable system/netbiosd