snowdreamtech/samba

Samba Docker镜像文档

镜像概述与主要用途

Snowdreamtech/samba镜像为Samba服务提供了便捷的Docker化部署方案。Samba是实现SMB/CIFS协议的开源软件，用于跨平台文件共享（如Windows、Linux、macOS设备间文件互访）。该镜像支持多种硬件架构，可通过简单配置快速部署，满足个人或企业的文件共享需求。

核心功能与特性

• 多平台支持：兼容amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x等架构
• 简易部署：支持Docker CLI或Docker Compose两种部署方式，提供基础与高级配置示例
• 灵活配置：通过环境变量设置时区（TZ），支持数据卷挂载自定义存储路径
• 服务稳定性：支持容器自动重启策略，确保服务持续运行
• 跨平台共享：基于Samba实现SMB/CIFS协议，支持Windows、Linux、macOS等多系统文件互访

使用场景与适用范围

• 个人用户家庭网络跨设备文件共享
• 小型团队内部文件协作与资源共享
• 嵌入式设备或多架构服务器环境中的轻量级文件服务部署
• 需要快速搭建临时或长期Samba服务的Docker环境用户

使用方法与配置说明

部署方式选择

Docker CLI部署

基础配置（Simple）

适用于快速启动默认配置的Samba服务，仅需设置时区和容器基本属性：

bash
docker run -d \
  --name=samba \
  -e TZ=Asia/Shanghai \  # 设置时区（示例：亚洲/上海）
  --restart unless-stopped \  # 容器退出时自动重启（除非手动停止）
  snowdreamtech/samba:latest

高级配置（Advance）

适用于需要自定义数据存储路径的场景，通过卷挂载实现宿主机目录共享：

bash
docker run -d \
  --name=samba \
  -e TZ=Asia/Shanghai \  # 时区设置
  -v /path/to/data:/path/to/data \  # 挂载宿主机目录（冒号前为宿主机路径，后为容器内路径）
  --restart unless-stopped \
  snowdreamtech/samba:latest

Docker Compose部署

基础配置（Simple）

创建docker-compose.yml文件，内容如下：

yaml
services:
  samba:
    image: snowdreamtech/samba:latest
    container_name: samba  # 容器名称
    environment:
      - TZ=Asia/Shanghai  # 时区配置
    restart: unless-stopped  # 自动重启策略

执行命令启动服务：docker-compose up -d

高级配置（Advance）

添加数据卷挂载，自定义共享存储路径：

yaml
services:
  samba:
    image: snowdreamtech/samba:latest
    container_name: samba
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - /path/to/data:/path/to/data  # 宿主机与容器目录映射
    restart: unless-stopped

执行命令启动服务：docker-compose up -d

开发构建（可选）

如需自行构建多平台镜像，可使用Docker Buildx工具：

bash
# 创建Buildx构建上下文
docker buildx create --use --name build --node build --driver-opt network=host
# 构建并推送多平台镜像（支持386、amd64、arm/v6、arm/v7、arm64等架构）
docker buildx build -t snowdreamtech/samba --platform=linux/386,linux/amd64,linux/arm/v6,linux/arm/v7,linux/arm64,linux/ppc64le,linux/riscv64,linux/s390x . --push

参考资料

1. 使用 buildx 构建多平台 Docker 镜像
2. 如何使用 docker buildx 构建跨平台 Go 镜像
3. Building Multi-Arch Images for Arm and x86 with Docker Desktop
4. How to Rapidly Build Multi-Architecture Images with Buildx
5. Faster Multi-Platform Builds: Dockerfile Cross-Compilation Guide
6. https://github.com/docker/buildx

联系方式（备注：samba）

• ：

• ---

• ---

• 微信/***：sn0wdr1am

许可证

本项目采用MIT许可证开源。