OpenDJ Docker 镜像文档

镜像概述与主要用途

OpenDJ 是一个符合 LDAPv3 标准的目录服务，基于 Java 平台开发，提供高性能、高可用且安全的身份数据存储解决方案。其简化的安装流程结合 Java 平台的特性，使其成为部署和管理最简单、快速的目录服务，并支持将 LDAPv3 数据库存储在 Cassandra/Scylla 集群中。

作为开源、轻量级、可嵌入式目录服务，OpenDJ 能够轻松在企业、云、社交和移动环境中实时共享客户、设备和用户身份数据。

核心功能与特性

• 大规模数据扩展与高可用性：为开发者提供超轻量级身份数据访问方式
• 高性能：毫秒级响应时间，每秒支持数万次读写操作
• 多主复制：确保服务高可用性
• LDAPv3 兼容：完全符合 LDAPv3 协议标准
• 安全存储：提供身份数据的安全存储与访问控制
• 灵活部署：支持多种复制架构（标准复制、独立复制服务器等）

使用场景与适用范围

OpenDJ 适用于需要集中管理身份数据的各类场景，包括但不限于：

• 企业级身份认证与授权系统
• 云环境中的用户数据存储
• 社交平台与移动应用的身份管理
• 需要高可用、高性能目录服务的业务系统
• 跨环境（企业/云/移动端）身份数据同步

支持平台

环境变量

使用方法

基本运行命令

docker run -h ldap-01.domain.com -p 1389:1389 -p 1636:1636 -p 4444:4444 --name ldap-01 openidentityplatform/opendj

说明：

• -h：设置容器主机名
• -p：映射端口（1389: LDAP，1636: LDAPS，4444: 管理端口）
• --name：指定容器名称

从 LDIF 文件导入数据

docker run -it --rm --entrypoint "/opt/opendj/bin/import-ldif" \
  -v ./data.ldif:/opt/opendj/import-data/data.ldif \
  openidentityplatform/opendj \
  -b dc=openam,dc=openidentityplatform,dc=org -D 'cn=Directory Manager' -h opendj -p 4444 -w passw0rd -l /opt/opendj/import-data/data.ldif

参数说明：

• -it --rm：交互式运行并在完成后删除容器
• --entrypoint：覆盖默认入口点，使用 import-ldif 工具
• -v：挂载本地 LDIF 文件到容器内
• -b：指定基准 DN
• -D：绑定的管理员 DN
• -h：目标 LDAP 服务器主机名
• -p：目标服务器端口
• -w：管理员密码
• -l：容器内 LDIF 文件路径

数据持久化

有关如何在容器重启间持久化 OpenDJ 数据的详细说明，请参考：How to Persist OpenDJ Docker Container Data Between Restarts

参考资料

• OpenDJ 社区版
• OpenDJ 官方文档