adevur/easy-samba

easy-samba镜像说明

镜像概述

easy-samba是基于CentOS 8构建的Samba服务器镜像，旨在通过JSON配置文件简化Samba服务的部署与管理。用户只需定义配置文件中的用户、共享目录及权限规则，镜像即可自动完成环境初始化，支持多架构（amd64、arm64v8、ppc64le）部署。

核心功能

1. JSON配置驱动：通过单一JSON文件定义用户账户、共享路径及权限策略，无需手动编写Samba配置；
2. 多用户管理：支持创建多个用户账户，并为不同用户分配差异化的共享访问权限；
3. 灵活权限控制：可设置公开共享（所有人读写）或私有共享（指定用户访问）；
4. 多架构支持：latest标签覆盖amd64、arm64v8、ppc64le架构，适配不同硬件环境；
5. 版本分支：提供unstable（开发版）、stable（稳定版）、long-term（长期支持版）分支，满足不同生产场景需求。

使用场景

• 小型团队协作：快速搭建内部文件共享服务器，实现团队成员间文件交换；
• 家庭网络存储：构建家庭NAS系统，支持多设备访问共享媒体文件；
• 开发环境资源共享：共享代码、工具或测试数据，提升团队协作效率。

配置说明

配置文件示例

创建config.json文件，定义用户与共享规则：

json
{
  "users": [
    {"name": "user1", "password": "user1pass"},
    {"name": "user2", "password": "user2pass"}
  ],
  "shares": [
    {
      "name": "PublicShare",
      "path": "/share/public",
      "read_only": false,
      "guest_ok": true
    },
    {
      "name": "User2Private",
      "path": "/share/user2",
      "read_only": false,
      "guest_ok": false,
      "valid_users": ["user2"]
    }
  ]
}

部署示例

Docker Run命令

bash
docker run -d \
  --name easy-samba \
  -p 139:139 -p 445:445 \
  -v /host/path/config.json:/app/config.json \
  -v /host/path/shared:/share \
  docker.xuanyuan.run/adevur/easy-samba:latest

构建镜像（可选）

构建stable版本镜像：

bash
docker build --tag local/easy-samba:stable ./stable/latest

版本与分支说明

• unstable：最新开发版（如2.4.0），支持多架构，不建议生产环境使用；
• stable：稳定版（如1.19.1），仅支持amd64架构，适合生产环境；
• long-term：长期支持版（暂未发布），仅提供bug修复与安全更新。

更多详情请参考官方资源：https://github.com/adevur/docker-easy-samba、https://hub.docker.com/r/adevur/easy-samba。