viniciusleterio/samba

Simple Samba Docker 镜像文档

1. 镜像概述

Simple Samba 是一个轻量级 Docker 镜像，基于 Samba 服务实现 SMB/CIFS 协议的文件共享功能。该镜像旨在简化文件共享服务的部署流程，提供基础的用户认证、权限控制和跨平台访问能力，适用于快速搭建轻量级文件共享环境。

2. 核心功能与特性

• 轻量级部署：基于 Alpine 基础镜像构建，镜像体积小，资源占用低
• 基础用户认证：支持自定义用户名/密码，限制访问权限
• 灵活权限控制：可配置共享目录为只读或读写模式
• 跨平台兼容：支持 Windows、Linux、macOS 等系统通过 SMB 协议访问
• 持久化存储：支持宿主机目录挂载，确保数据持久化
• 简化配置：通过环境变量快速配置核心参数，无需手动编写复杂配置文件

3. 使用场景与适用范围

• 家庭网络文件共享：家庭内部多设备（电脑、电视、手机）间的照片、视频等文件共享
• 小型办公环境：团队内部临时文件协作、文档共享
• 开发测试环境：快速搭建临时文件服务器，用于应用测试或数据交换
• 嵌入式设备：低资源环境（如树莓派）中的简易文件服务

4. 使用方法与配置说明

4.1 基础使用条件

• 已安装 Docker 引擎（20.10+ 版本推荐）
• 宿主机需开放 139/tcp 和 445/tcp 端口（SMB 协议默认端口）

4.2 环境变量配置

4.3 自定义配置文件（高级）

如需复杂配置（如多共享目录、***访问、权限细分等），可通过挂载自定义 smb.conf 文件覆盖默认配置：

• 宿主机准备自定义配置文件（如 ./smb.conf）
• 容器运行时通过 -v ./smb.conf:/etc/samba/smb.conf 挂载配置文件

5. 部署示例

5.1 Docker Run 快速启动

基本读写共享示例

bash
docker run -d \
  --name samba-share \
  -p 139:139 \
  -p 445:445 \
  -v /宿主机/共享目录:/shared \  # 宿主机目录挂载（需替换为实际路径）
  -e SAMBA_USER=myuser \         # 自定义用户名
  -e SAMBA_PASSWORD=mypassword \ # 自定义密码
  -e SHARE_NAME=myshare \        # 共享名称（客户端可见）
  -e READ_ONLY=no \              # 读写模式
  simple-samba

只读共享示例

bash
docker run -d \
  --name samba-readonly \
  -p 139:139 \
  -p 445:445 \
  -v /宿主机/只读目录:/data \
  -e SAMBA_USER=readonly \
  -e SAMBA_PASSWORD=readonly123 \
  -e SHARE_NAME=readonly-share \
  -e SHARE_PATH=/data \          # 指定容器内共享路径（需与挂载路径一致）
  -e READ_ONLY=yes \             # 只读模式
  simple-samba

5.2 Docker Compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  samba:
    image: simple-samba
    container_name: samba-service
    restart: unless-stopped
    ports:
      - "139:139"
      - "445:445"
    volumes:
      - /宿主机/共享目录:/shared  # 宿主机目录挂载
    environment:
      - SAMBA_USER=officeuser
      - SAMBA_PASSWORD=Secure@2024
      - SHARE_NAME=office-share
      - READ_ONLY=no
      - WORKGROUP=OFFICE         # 自定义工作组名称
    networks:
      - samba-net

networks:
  samba-net:
    driver: bridge

启动服务：

bash
docker-compose up -d

5.3 自定义配置文件（进阶）

如需配置多共享目录或高级权限，可挂载本地 smb.conf 文件：

1. 本地创建 smb.conf（示例配置）：

ini
[global]
   workgroup = MYGROUP
   server string = Simple Samba Server
   security = user
   map to guest = bad user

[public-share]
   path = /public
   guest ok = yes
   read only = yes

[private-share]
   path = /private
   valid users = myuser
   read only = no

2. 启动容器时挂载配置文件：

bash
docker run -d \
  --name samba-custom \
  -p 139:139 -p 445:445 \
  -v /宿主机/public:/public \
  -v /宿主机/private:/private \
  -v /本地路径/smb.conf:/etc/samba/smb.conf \  # 挂载自定义配置
  -e SAMBA_USER=myuser \
  -e SAMBA_PASSWORD=mypass \
  simple-samba

6. 注意事项

• 权限匹配：宿主机挂载目录的权限需与容器内用户 ID（默认 1000）匹配，避免权限不足导致无法访问（可通过 USER_ID 和 GROUP_ID 环境变量调整）
• 密码安全：生产环境中建议通过 Docker Secrets 或环境变量文件传递密码，避免明文暴露
• 端口冲突：确保宿主机 139/445 端口未被其他服务占用（如 Windows 共享服务）
• 日志查看：通过 docker logs samba-share 查看服务运行日志，排查连接问题
• 防火墙配置：如需跨网络访问，需在宿主机防火墙开放 139/445 端口

7. 访问测试

服务启动后，可通过以下方式访问共享目录：

• Windows：资源管理器输入 \\<宿主机IP>\<SHARE_NAME>，输入配置的用户名/密码
• Linux/macOS：文件管理器通过 smb://<宿主机IP>/<SHARE_NAME> 访问，或使用命令 smbclient //<宿主机IP>/<SHARE_NAME> -U <SAMBA_USER>