389ds/dirsrv

389 Directory Server Docker镜像文档

镜像概述和主要用途

389 Directory Server是一款全功能LDAP服务器，能够处理数百万条目，并可从小型家庭安装扩展到全球最大的分布式数据库之一。本镜像为该目录服务器项目的容器化版本，旨在实现轻松部署和运行。

核心功能和特性

• 全功能LDAP服务器支持，兼容标准LDAP协议
• 高扩展性，可处理数百万条目，适应从小型到大型分布式环境
• 容器化设计，简化部署和运维流程
• 数据持久化存储，支持版本间原地升级
• 内置管理工具自动连接，无需手动配置管理员认证
• 支持TLS加密，可通过配置文件导入证书
• 环境变量自定义，满足不同场景需求（如日志级别、内存配置等）

使用场景和适用范围

• 小型家庭或办公环境的LDAP服务部署
• 企业级身份认证和目录服务
• 需要处理大量条目的分布式数据库环境
• 快速搭建和测试LDAP服务的开发或测试场景
• 对容器化部署有需求的LDAP服务器应用

使用方法

基本运行

尝试运行镜像：

bash
docker run docker.xuanyuan.run/389ds/dirsrv:latest

数据持久化

为确保数据不丢失，可将数据目录挂载到容器外部：

bash
docker run -v dirsrv:/data docker.xuanyuan.run/389ds/dirsrv:latest

所有实例数据均存储在/data目录下，支持版本间原地升级。

管理实例

通过容器内管理工具管理实例，自动以cn=Directory Manager身份连接：

bash
docker exec -i -t CONTAINER_NAME dsconf --help

将CONTAINER_NAME替换为实际容器名称或ID。

环境变量

可通过以下环境变量自定义容器行为：

• DS_ERRORLOG_LEVEL：启动时覆盖错误日志级别，用于辅助调试
• DS_DM_PASSWORD：cn=Directory Manager用户的密码，默认随机生成
• DS_MEMORY_PERCENTAGE：用于数据库缓存的容器内存百分比，通常无需修改
• DS_REINDEX：设为true时，实例启动前将执行数据库重建索引
• DS_SUFFIX_NAME：为dsidm在部分配置文件中设置默认数据库后缀名
• DS_STARTUP_TIMEOUT：修改等待实例启动的时间，大型实例可能需要调整

配置文件

容器使用以下关键配置文件，可通过/data卷进行自定义：

• /data/config/container.inf：实例的管理工具连接设置
• /data/tls/{server.key, server.crt, ca/*.crt}：启动时导入和使用的PEM文件
  • server.key/server.crt：TLS监听的私钥和证书
  • ca/目录：存放PEM格式的CA证书，将添加到实例的信任根

注意事项

安全公告

• 2022-05-31：所有版本的389-ds中发现严重安全问题（CVE-2022-1949），已导致旧镜像流被移除。必须尽快更新至2.1/latest版本。详情参见：SUSE Bugzilla #***

功能更新

• 2022-02-18：实例现在支持在/etc/passwd等文件中未定义uid/gid编号时以非root用户运行dirsrv
• 2020-06-03：容器重启问题已在1.4/1.4.4及latest版本中修复，请尽快更新

镜像构建信息

本Docker镜像通过openSUSE Build Service的发布流水线构建。查看用于构建镜像的Dockerfile：https://build.opensuse.org/package/view_file/home:firstyear/389-ds-container/Dockerfile?expand=1