vimagick/samba

samba

https://www.samba.org/ 是用于Linux和Unix的标准Windows互操作性程序套件，可实现Linux/Unix系统与Windows系统之间的文件共享、打印机共享及网络资源访问。

核心功能与特性

• 支持SMB/CIFS协议，实现Windows与Linux/Unix系统间的文件共享
• 提供用户认证与权限管理
• 支持***访问与用户级访问控制
• 可集成到现有Windows网络环境

使用场景

• 家庭或小型办公网络中的跨平台文件共享
• Linux服务器作为Windows网络中的文件服务器
• 需要在Linux/Unix与Windows系统间交换文件的环境

部署与使用方法

docker-compose.yml 配置

yaml
samba:
  image: docker.xuanyuan.run/vimagick/samba
  volumes:
    - ./data/smb.conf:/etc/samba/smb.conf  # 自定义配置文件挂载
    - ./share:/share                     # 共享目录挂载
  net: host
  tty: yes
  restart: always

取消注释以使用自定义配置文件。

USB设备挂载配置（可选）

如需将USB闪存驱动器挂载到容器中，可创建系统挂载配置文件 /etc/systemd/system/mnt-usb.mount：

[Unit]
Description=USB Storage Mount

[Mount]
What=/dev/disk/by-uuid/829B-2038  # 替换为实际USB设备的UUID
Where=/mnt/usb                     # 挂载点

[Install]
WantedBy=local-fs.target

Samba配置文件 (smb.conf)

[global]
netbios name = easypi              # 网络BIOS名称
workgroup = WORKGROUP              # 工作组名称
server string = EasyPi Samba Server # 服务器描述
server role = standalone           # 独立服务器模式
map to guest = bad user            # 错误用户映射为来宾
usershare allow guests = yes       # 允许来宾访问用户共享

[homes]
comment = Home Directories         # 家目录共享
browseable = no                    # 不可浏览
writable = yes                     # 可写

[share]
comment = Public File Sharing       # 公共文件共享
path = /share                      # 共享路径
browseable = yes                   # 可浏览
read only = no                     # 非只读
guest ok = yes                     # 允许来宾访问
admin users = root                 # 管理员用户

服务器端部署步骤

bash
$ cd ~/fig/samba          # 进入项目目录
$ mkdir share             # 创建共享目录
$ touch share/README.txt  # 创建测试文件
$ docker-compose up -d    # 启动容器
$ docker exec -it samba_samba_1 sh  # 进入容器
>>> testparm              # 验证配置文件语法
>>> smbpasswd -a root     # 添加Samba用户（root）
New SMB password:******   # 输入密码
Retype new SMB password:******  # 确认密码
>>> exit                  # 退出容器

客户端访问方法

macOS客户端

bash
$ smbutil view -NG smb://easypi  # 查看共享资源
Share                                           Type    Comments
-------------------------------
share                                           Disk
IPC$                                            Pipe    IPC Service (Samba Server)
2 shares listed

$ mkdir -p /Volumes/share        # 创建挂载点
$ mount_smbfs //guest@easypi/share /Volumes/share  # 挂载共享目录
$ umount /Volumes/share          # 卸载共享目录

root 用户可读写，guest 用户只读。