bfren/samba

Docker Samba 镜像文档

!GitHub release (latest by date) !Docker Pulls !Docker Image Size !GitHub Workflow Status

https://hub.docker.com/r/bfren/samba - https://github.com/bfren/docker

该镜像预安装Samba服务，并通过JSON文件（参见shares-conf-sample.json）生成配置，支持快速部署文件共享服务。

目录

• 端口
• 卷
• 示例文件
• 许可证/版权

概述

Docker Samba镜像旨在简化Samba服务的部署流程，预集成Samba服务组件，通过JSON配置文件定义用户账户和共享目录，无需手动编写复杂的smb.conf配置文件，适用于家庭网络、小型办公环境或开发团队的文件共享场景。

核心功能

• 预配置Samba：镜像内置Samba服务，无需额外安装配置
• JSON配置驱动：通过shares.json文件定义用户账户和共享规则，配置简单直观
• 多用户支持：可创建多个用户账户，并为不同共享目录分配访问权限
• 灵活共享设置：支持配置共享目录的可浏览性、可写性及访问用户列表
• 持久化存储：通过卷挂载确保共享文件数据持久化保存

端口

• 445（SMB服务默认端口）

卷

示例文件

docker-compose.yml

yaml
version: "3.8"

services:
  samba:
    image: bfren/samba:latest
    container_name: samba
    restart: unless-stopped
    ports:
      - "0.0.0.0:445:445"  # 将容器445端口映射到主机
    volumes:
      - ./v/shares.json:/files/shares.json:ro  # 只读挂载共享配置文件
      - ./v/example:/files/example  # 挂载示例共享目录
      - ./v/another:/files/another  # 挂载另一个共享目录
    networks:
      - samba

networks:
  samba:
    driver: bridge
    name: samba

shares.json（共享配置文件）

json
{
    "$schema": "https://schemas.bfren.dev/docker/samba/shares.json",
    "users": [
        {
            "name": "fred",  // 用户名
            "pass": "password"  // 用户密码
        },
        {
            "name": "jones",
            "pass": "another"
        }
    ],
    "shares": [
        {
            "name": "example",  // 共享名称
            "comment": "共享的可选描述",  // 可选描述信息
            "users": [  // 允许访问该共享的用户列表
                "fred"
            ],
            "browseable": false,  // 是否可浏览（false为隐藏）
            "writeable": false  // 是否可写（false为只读）
        },
        {
            "name": "another",
            "users": [
                "fred",
                "jones"  // 多用户访问配置
            ]
        }
    ]
}

许可证/版权

MIT许可证

版权所有 (c) 2022-2025 bfren（除非另有说明）