yaurora/samba

yaurora/samba镜像说明

镜像概述

本镜像基于Samba 4构建，旨在帮助用户快速搭建SMB文件共享服务，无需在服务器上进行复杂的环境配置。只需拉取镜像、挂载共享目录并设置必要参数，即可实现跨平台的文件共享。

核心功能

• 提供标准SMB文件共享服务，支持Windows、Linux、macOS等多平台访问
• 支持自定义SMB配置文件，可设置多个共享目录
• 支持通过环境变量快速配置用户账号和密码
• 兼容主机网络和桥接网络两种部署方式

使用场景

• 家庭内部多设备间的文件共享
• 小型团队内部的文档协作与共享
• 跨平台环境下的文件传输与访问

配置说明

必要参数

• TZ: 时区设置（例如：Asia/Shanghai）
• SMB_USER: 用于访问共享的用户账号（拥有管理员权限）
• SMB_PASS: 上述用户的密码

部署示例

示例1：使用主机网络，暴露/media/movies目录（配置文件挂载到/container_data/samba/config）

shell
docker run -d --name samba --net=host -v /media/movies:/share -v /container_data/samba/config:/etc/samba docker.xuanyuan.run/yaurora/samba:latest

示例2：使用桥接网络，暴露139和445端口

shell
docker run -d --name samba -p 139:139 -p 445:445 -v /media/movies:/share -v /container_data/samba/config:/etc/samba docker.xuanyuan.run/yaurora/samba:latest

示例3：使用docker-compose部署

yaml
version: '3'
services:
  samba:
    image: docker.xuanyuan.run/yaurora/samba
    container_name: samba
    volumes:
      - /container_data/samba/config:/etc/samba
      - /container_data/media:/share
    environment:
      - TZ=Asia/Shanghai
      - SMB_USER=someuser
      - SMB_PASS=somePass
    ports:
      - 139:139
      - 445:445
    restart: always

多共享目录配置

若需设置多个共享目录，可自定义smb.conf文件，并确保挂载对应的卷。例如docker-compose配置：

yaml
version: '3'
services:
  samba:
    image: docker.xuanyuan.run/yaurora/samba
    container_name: samba
    volumes:
      - /container_data/samba/config:/etc/samba
      - /some_folder/movies:/movies
      - /another_folder/tvseries:/tvseries
    environment:
      - TZ=Asia/Shanghai
      - SMB_USER=someuser
      - SMB_PASS=somePass
    ports:
      - 139:139
      - 445:445
    restart: always

对应的smb.conf配置（确保路径与卷挂载一致）：

conf
[global]
   map to guest = Bad User
   log file = /var/log/samba/%m
   log level = 10
   workgroup = WORKGROUP
   server role = standalone server
   usershare allow guests = no
[movies]
    comment = movies
    path = /movies
    read only = no
    browsable = yes
[tvseries]
    comment = tvseries
    path = /tvseries
    read only = no
    browsable = yes

测试方法

• Windows平台：使用资源管理器或命令行挂载共享（不要以管理员身份运行命令，否则可能无法访问映射的驱动器）
  命令行示例：

  cmd
  net use X: \\192.168.1.100\media smb_pass /user:smb_user /persistent:yes
  

  PowerShell示例：

  PowerShell
  New-PSDrive -Name Y -PSProvider FileSystem -Root \\192.168.1.100\media -Description "Samba share on 192.168.1.100" -Scope global -Persist -Credential (Get-Credential)
  

权限说明

确保为Samba用户设置正确的目录权限。若访问出现问题，可进入容器调整权限：

shell
docker exec -it samba /bin/bash
chown -R SMB_USER: /share      # 将SMB_USER替换为你创建的用户名，路径替换为实际共享目录

来源：https://github.com/yaurora/docker-samba