ricariel/samba-ad-dc

samba-ad-dc Docker镜像文档

镜像概述

samba-ad-dc是一个用于部署Samba作为Active Directory（AD）域控制器的Docker镜像，旨在简化Samba AD DC的搭建流程，支持快速构建单域控制器或多域控制器测试环境，适用于企业AD环境部署、多DC功能验证及学习场景。

核心功能和特性

• 单域控制器快速部署：通过docker run命令一键初始化新域环境，包含必要配置与数据持久化
• 多域控制器测试支持：提供基于Docker Compose的多DC集群搭建方案，支持4节点及以上环境测试
• 日志与测试工具集成：支持实时日志查看及samba-tests命令验证域控制器功能
• 持久化存储：通过数据卷挂载确保Samba配置文件与域数据持久化保存

使用场景和适用范围

• 企业内部Active Directory域环境的快速部署与验证
• 多域控制器复制机制测试与功能验证
• Samba AD DC配置学习与开发测试环境搭建
• 临时AD域环境演示或培训场景

使用方法和配置说明

1. 部署单域控制器

执行以下命令部署新域控制器，需替换环境变量为实际配置：

bash
docker run -d --privileged \
  --restart=unless-stopped --network=host \
  -e REALM='SAMDOM.EXAMPLE.COM' \
  -e DOMAIN='SAMDOM' \
  -e ADMIN_PASS='Passw0rd' \
  -e DNS_FORWARDER='8.8.8.8' \
  -v dc1-samba:/usr/local/samba \
  --name dc1 --hostname DC1 diegogslomp/samba-ad-dc

参数说明：

• --privileged：赋予容器特权模式以确保Samba服务正常运行
• --restart=unless-stopped：容器异常退出时自动重启（手动停止除外）
• --network=host：使用主机网络模式保证AD服务端口正确映射
• 环境变量：
  • REALM：AD域的DNS域名（例：SAMDOM.EXAMPLE.COM）
  • DOMAIN：NetBIOS域名（例：SAMDOM）
  • ADMIN_PASS：域管理员账户密码
  • DNS_FORWARDER：DNS转发器地址（例：8.8.8.8为Google DNS）
• -v dc1-samba:/usr/local/samba：挂载数据卷持久化Samba配置与数据
• --hostname DC1：设置容器主机名（需符合AD域控制器命名规范）

2. 查看日志与运行测试

部署后可通过以下命令监控服务状态并验证功能：

bash
# 查看容器日志（按Ctrl+C退出）
docker logs dc1 -f

# 在容器内执行功能测试
docker exec dc1 samba-tests

3. 多域控制器测试环境搭建

如需测试多域控制器集群，可通过Docker Compose实现：

bash
# 克隆仓库
git clone --single-branch https://github.com/diegogslomp/samba-ad-dc
cd samba-ad-dc

# 构建并启动多DC环境
docker compose build
docker compose up -d

# 查看集群日志
docker compose logs -f

# 在所有DC节点上运行测试
for dc in dc{1,2,3,4}; do docker compose exec $dc samba-tests; done

其他信息

TODO

• Sysvol复制解决方法

官方资源

• 官方指南：设置Samba作为Active Directory域控制器
• 依赖项：构建Samba所需的包依赖
• 端口说明：Samba AD域控制器端口使用