ahmetozer/samba

Docker容器化Samba服务

镜像概述

这是一个轻量、易用的Docker容器化Samba文件共享服务器，提供自动配置工具，帮助用户快速部署和管理文件共享服务，支持多种网络访问方式和灵活的共享配置。

核心功能

• 自动配置Samba服务，简化部署流程
• 支持快速添加/删除用户及共享目录
• 多种网络访问方式（端口映射、静态IP、***）
• 提供快速安装选项，通过环境变量自定义配置
• 支持容器内外目录绑定，实现主机与容器间文件共享

使用场景

• 本地网络内多设备文件共享
• 容器与主机之间的文件传输与管理
• 小型团队协作中的文件存储与共享
• 开发环境中快速搭建临时文件共享服务

配置说明

获取镜像

通过Docker拉取官方镜像：

bash
docker pull docker.xuanyuan.run/ahmetozer/samba

或本地构建：

bash
git clone git@github.com:AhmetOZER/docker-samba.git
cd docker-samba
docker build -t samba .

基本运行

直接启动容器并进入交互模式：

bash
docker run -it docker.xuanyuan.run/ahmetozer/samba

网络访问方式

1. 端口映射：通过-p参数暴露445端口（Samba默认端口）

bash
docker run -it -p 445:445 docker.xuanyuan.run/ahmetozer/samba

2. 静态IP：为容器分配静态IP（仅本地网络可访问）

bash
docker run -it --ip 172.17.0.80 ahmetozer/samba

3. 访问：通过实现远程访问（***脚本待完善）

共享文件夹绑定

使用-v参数将主机目录绑定到容器内目录，实现文件共享：

bash
docker run -it -v /var/www:/share/web docker.xuanyuan.run/ahmetozer/samba

（注：/var/www为主机目录，/share/web为容器内目录）

容器内命令

容器提供以下命令用于管理Samba服务：

• 添加用户：useradd（支持交互或直接输入用户名密码） 示例：

  bash
  # 交互模式
  useradd
   # 直接指定用户名和密码
  useradd root3 mypassword
  

• 添加共享：shareadd（需先绑定外部目录或使用容器内目录） 示例：

  bash
  # 交互模式
  shareadd
  # 直接指定参数（名称、路径、用户、描述）
  shareadd newshare "/share/newshare" "newshareuser" "newshare Directory"
  

• 列出共享：sharelist（查看所有共享目录）
• 查看共享配置：shareshow [共享名称]（显示指定共享的配置信息）
• 更新配置：update-samba（重新生成配置并重载服务）
• 删除共享：sharedel [共享名称]（删除指定共享）
• 重载服务：reload-samba（重载Samba服务）

快速安装

通过环境变量实现快速配置：

• 自动生成密码：

  bash
  docker run -v /var/www:/share/web -e sharename=web -it docker.xuanyuan.run/ahmetozer/samba
  

• 自定义密码：

  bash
  docker run -it -v /var/www:/share/web -e sharename=web -e password=12345678 docker.xuanyuan.run/ahmetozer/samba
  

• 交互输入密码：

  bash
  docker run --rm -it -e sharename=web -e passato=no docker.xuanyuan.run/ahmetozer/samba
  

支持的环境变量：username（用户名）、sharename（共享名称）、sharecomment（共享描述）、sharepath（共享路径）、passato（是否自动生成密码，yes/no）

配置文件存储

Samba共享配置文件位于容器内/etc/samba/conf.d/目录。