aguslr/samba

aguslr/docker-samba

镜像概述和主要用途

此Docker镜像在容器中设置Samba服务。

Samba 是SMB网络协议的免费软件重新实现，用于在不同操作系统之间共享文件和打印机。

核心功能和特性

• 快速部署Samba服务器，无需复杂的系统配置
• 通过环境变量灵活配置用户信息
• 支持多种用户管理方式：默认用户、导入smbpasswd文件、解析用户列表文件
• 允许自定义smb.conf配置文件，实现高级共享设置
• 轻量级设计，易于集成到现有Docker环境

使用场景和适用范围

适用于需要快速搭建文件共享服务的场景，如家庭网络文件共享、小型办公环境资源共享、跨平台（Windows、Linux、macOS）文件交换等。

详细使用方法和配置说明

安装

使用docker-samba需遵循以下步骤：

1. 拉取并启动容器：

   bash
   docker run -p 445:445 \
     -e SAMBA_USER=bob \
     -e SAMBA_PASS=123456 \
     -v "${PWD}"/home:/home \
     docker.io/aguslr/samba:latest
   

2. 配置Samba客户端软件，连接到Samba服务器的IP地址，使用用户SAMBA_USER进行认证。

环境变量

镜像通过运行时传递的环境变量进行配置，所有变量均以SAMBA_为前缀。

添加用户

默认会创建一个用户，用户名为smbuser（或SAMBA_USER变量的值），如果未通过SAMBA_PASS提供密码，则会自动生成密码。要查看自动生成的密码，请检查容器日志：

bash
docker logs <container_name> | grep '^Password'

导入smbpasswd文件

如果提供了有效的smbpasswd文件，其中的用户将被添加到系统中，并通过pdbedit工具导入。可以使用相同的工具从现有Samba设置中导出该文件：

bash
pdbedit -e smbpasswd:/tmp/smbpasswd

解析用户文件

第三种提供更精细控制的方式是使用SAMBA_USERSFILE变量，将包含用户信息的文件路径传递给容器。

该文件应每行包含一个用户，格式为UID:NAME:GROUP:NTHASH。例如：

1000:smbuser:users:32ED87BDB5FDC5E9CBA88547376818D4

可以使用mkpasswd工具从明文密码生成NT哈希：

bash
mkpasswd --method=nt 123456

上述命令将输出示例中使用的哈希值：

$3$32ed87bdb5fdc5e9cba88547376818d4

自定义smb.conf

要配置额外的共享或参数，可以将这些内容添加到smb.conf文件中：

ini
[Data]
  path = /data
  comment = 数据目录
  available = yes
  browseable = yes
  read only = yes
  valid users = @users @nogroup
  write list = @users

然后通过以下方式挂载该文件：

bash
docker run -p 445:445 \
  -e SAMBA_PASSWDFILE=/tmp/smbpasswd \
  -v "${PWD}"/smbpasswd:/tmp/smbpasswd \
  -v "${PWD}"/data:/data \
  -v "${PWD}"/home:/home \
  -v "${PWD}"/smb.conf:/etc/samba/includes.conf \
  docker.io/aguslr/samba:latest

本地构建

除了从远程仓库拉取镜像外，还可以本地构建：

1. 克隆仓库：

   bash
   git clone https://github.com/aguslr/docker-samba.git
   

2. 进入新创建的目录，使用docker-compose构建并启动容器：

   bash
   cd docker-samba && docker-compose up --build -d