elradix/rpi-samba

elradix/rpi-samba镜像说明

镜像概述

elradix/rpi-samba是一个适用于树莓派的Samba Docker镜像，旨在帮助用户快速构建SMB文件共享服务，支持多用户访问控制和目录权限管理，满足家庭或小型团队的文件共享需求。

核心功能

• 支持创建多个共享目录，并为每个目录设置不同权限（读写、只读）
• 支持添加多个用户账户，实现精细化访问控制
• 支持容器自动重启策略配置
• 可自定义主机名
• 映射必要的SMB端口，确保网络访问正常

使用场景

• 家庭网络文件共享：将树莓派作为家庭存储服务器，实现多设备间文件共享
• 小型团队内部文件交换：团队成员通过SMB访问共享文档，提高协作效率
• 树莓派本地存储扩展：挂载外部存储设备，通过网络共享访问

配置说明

必要端口映射

需映射以下端口：

• 137/udp、138/udp：NetBIOS名称服务和数据报服务
• 139：SMB over NetBIOS
• 445：SMB直接访问端口

目录挂载

将本地目录挂载到容器内的共享路径，例如/media/stick挂载到/share/stick。

用户与共享配置

通过启动参数设置用户（-u "用户名:密码"）和共享目录（-s "共享名称:目录路径:权限:用户列表"）。

部署示例

bash
docker run -d \
  -p 137:137/udp \
  -p 138:138/udp \
  -p 139:139 \
  -p 445:445 \
  -p 445:445/udp \
  --restart='always' \
  --hostname 'filer' \
  -v /media/stick:/share/stick \
  --name samba elradix/rpi-samba:v3 \
  -u "alice:abc123" \
  -u "bob:secret" \
  -s "Backup directory:/share/stick/backups:rw:alice,bob" \
  -s "Alice (private):/share/stick/data/alice:rw:alice" \
  -s "Bob (private):/share/stick/data/bob:rw:bob" \
  -s "Documents (readonly):/share/stick/data/documents:ro:alice,bob" \
  -s "Public (readonly):/share/stick/data/public:ro:"