forumi0721/alpine-samba

alpine-samba

镜像概述

基于Alpine Linux构建的Samba服务镜像，支持x64和aarch64架构。Samba是Linux和Unix系统的标准Windows互操作性套件，提供跨平台文件共享能力，实现Linux/Unix与Windows系统间的文件交换与共享。

• 发行版：Alpine Linux
• 支持架构：x64, aarch64
• 核心应用：Samba（Windows互操作性套件）

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 多架构支持：同时提供x64和aarch64架构版本，适配不同硬件平台
• 快速配置：通过环境变量即可完成基础共享配置，无需手动编写配置文件
• 灵活扩展：支持自定义smb.conf配置文件，满足复杂共享需求

使用场景

• 家庭网络中Linux/Unix设备与Windows设备的文件共享
• 小型办公环境跨平台文件交换与协作
• 嵌入式设备（如树莓派，aarch64架构）作为简易文件服务器
• 开发环境中快速搭建临时跨平台共享服务

使用方法

Docker运行命令

sh
docker run -d -t \
           -p 137:137/udp \
           -p 138:138/udp \
           -p 139:139/tcp \
           -p 445:445/tcp \
           -v /data:/data \
           -e USER_NAME=<用户名> \
           -e USER_PASSWD=<密码> \
           -e USER_UID=<用户ID> \
           -e USER_GID=<用户组ID> \
           -e NETBIOS_NAME=SAMBA \
           -e WORKGROUP=WORKGROUP \
           -e SAMBA_SHARE="data=/data,..." \
           forumi0721/alpine-samba:[架构标签]

参数说明：

• <用户名>：登录共享的用户名（默认：forumi0721）
• <密码>：登录共享的密码（默认：passwd）
• <用户ID>/<用户组ID>：共享目录的文件权限ID（默认：1000/100）
• [架构标签]：根据硬件架构选择，x64或aarch64

共享目录挂载方法

Linux系统

sh
mount -t cifs -o user=<用户名>,pass=<密码> //<服务器IP>/data /mnt/data

macOS系统（Darwin）

sh
mount -t smbfs //<用户名>:<密码>@<服务器IP>/data /Volumes/data

默认凭据：若未配置环境变量，默认用户名/密码为 forumi0721/passwd

注意事项

• 复杂配置需求：如需多用户管理或高级共享设置，需手动创建smb.conf配置文件，并通过-v /本地路径/smb.conf:/conf.d/smb.conf挂载到容器中覆盖默认配置。

配置参数说明

Docker选项

端口映射

数据卷

环境变量