4teamwork/389ds

389 Directory Server

镜像概述和主要用途

Docker化的389 Directory Server (389ds)。389ds是适用于Linux的企业级开源LDAP服务器，提供稳定、可扩展的目录服务，适用于企业环境中的身份认证、用户管理和资源访问控制。

核心功能和特性

• 企业级LDAP服务：支持标准LDAP协议，提供可靠的目录服务
• Docker化部署：简化部署流程，便于在容器环境中快速启动和管理
• 数据持久化：通过卷挂载实现数据持久化，确保服务重启后数据不丢失
• 安全连接：支持LDAP（3389端口）和LDAPS（3636端口）协议
• 灵活配置：通过环境变量自定义目录管理器密码和后缀名称

使用场景和适用范围

• 企业内部身份认证系统
• 用户和组织结构管理
• 应用系统的统一目录服务
• 需要LDAP协议支持的各类业务系统集成

使用方法和配置说明

Docker Compose部署

使用docker-compose.yml是最简单的部署方式，示例配置如下：

yaml
version: "3"

services:
  389ds:
    image: 4teamwork/389ds:latest
    ports:
      - 3389:3389  # LDAP端口
      - 3636:3636  # LDAPS端口
    volumes:
      - ./data:/data  # 数据持久化卷
    environment:
      - SUFFIX_NAME=dc=example,dc=com  # 后缀名称
      - DS_DM_PASSWORD=secret  # 目录管理器密码

配置参数说明

DS_DM_PASSWORD

cn=Directory Manager用户的密码。仅在容器首次启动时设置。若未提供，将自动生成随机密码。

SUFFIX_NAME

实例配置中存储的后缀名称。注意：此参数不会自动创建后缀！ 需参考创建数据库部分手动创建。

卷

389ds镜像在/data路径下暴露卷。需挂载卷或主机目录至该路径以持久化389ds实例数据。若卷为空，容器启动时将自动创建新实例。

暴露端口

• 3389：LDAP协议端口
• 3636：LDAPS（加密LDAP）协议端口

创建数据库

默认情况下，镜像不创建任何后端或后缀。需手动创建后端和后缀：

创建后端与后缀

bash
docker-compose exec 389ds dsconf localhost backend create --suffix="dc=example,dc=com" --be-name="example"

初始化示例数据

bash
docker-compose exec 389ds dsidm localhost initialise