pingidentity/pingdirectoryproxy

Ping Identity PingDirectoryProxy™ Docker镜像

镜像概述和主要用途

PingDirectoryProxy™ Docker镜像是一个快速、可扩展且易于使用的LDAP代理服务器，专为为PingDirectory提供高可用性而设计。该镜像作为客户端与后端PingDirectory实例之间的中间层，实现请求路由、负载均衡、故障转移等功能，简化分布式部署架构，提升整体服务可用性与扩展性。

核心功能和特性

• 高可用支持：为后端PingDirectory实例提供负载均衡与自动故障转移，确保服务持续可用
• 请求路由与分流：基于策略（如用户组、请求类型）将客户端请求路由至特定PingDirectory实例
• 连接优化：内置连接池管理，减少客户端与后端目录服务器的连接开销
• 协议转换：支持LDAP与LDAPS（加密LDAP）协议转换，简化客户端配置
• 可扩展性：支持动态添加/移除后端PingDirectory实例，无需重启代理服务
• 监控集成：兼容标准监控工具，提供关键指标（如请求延迟、吞吐量、后端健康状态）
• 轻量级部署：基于Docker容器化设计，支持快速部署与环境一致性

使用场景和适用范围

• 企业级LDAP服务高可用部署：适用于对LDAP服务可用性要求严苛的场景，通过代理实现后端目录服务的冗余与故障转移
• PingDirectory水平扩展：当单节点PingDirectory性能不足时，通过代理将流量分发至多实例集群，提升并发处理能力
• 多区域部署请求路由：在跨区域部署中，通过地理位置或负载策略将客户端请求路由至最近/最优后端实例
• 客户端连接简化：为客户端提供单一访问入口，隐藏后端目录服务拓扑，降低客户端配置复杂度
• 合规与安全增强：集中管理加密（如TLS termination）、访问控制策略，满足数据安全合规要求

使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+）或Docker Desktop
• 已获取PingDirectoryProxy许可证（评估许可证或商业许可证，详见「许可协议」章节）
• 接受许可协议（通过环境变量显式声明）

基本使用（docker run）

bash
docker run -d \
  --name pingdirectoryproxy \
  -p 389:389 \          # LDAP端口
  -p 636:636 \          # LDAPS端口
  -e PING_IDENTITY_ACCEPT_EULA=Yes \  # 必须接受许可协议
  -e LICENSE_FILE=/path/to/license.json \  # 许可证文件路径（评估或商业）
  -v /host/config:/opt/out/instance/config \  # 挂载配置文件（可选）
  -v /host/logs:/opt/out/instance/logs \      # 挂载日志目录（可选）
  pingidentity/pingdirectoryproxy:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  pingdirectoryproxy:
    image: pingidentity/pingdirectoryproxy:latest
    container_name: pingdirectoryproxy
    ports:
      - "389:389"   # LDAP端口
      - "636:636"   # LDAPS端口
    environment:
      - PING_IDENTITY_ACCEPT_EULA=Yes
      - LICENSE_FILE=/licenses/license.json  # 许可证文件挂载路径
      - LOG_LEVEL=INFO  # 日志级别：DEBUG/INFO/WARN/ERROR
    volumes:
      - ./license:/licenses  # 本地许可证文件目录挂载
      - ./config:/opt/out/instance/config  # 自定义配置文件（可选）
      - ./logs:/opt/out/instance/logs      # 日志持久化（可选）
    restart: unless-stopped

关键配置参数

环境变量

许可协议

容器化软件、操作系统软件及其他非产品核心的第三方软件，均受其适用的开源许可协议约束。

对于镜像中安装的Ping Identity产品（"软件"）适用的许可协议：

• 通过将环境变量PING_IDENTITY_ACCEPT_EULA设置为"Yes"，镜像用户同意其对Docker镜像中软件的使用受本段落所述许可协议条款约束。若镜像用户（或其所属组织）未从Ping Identity购买软件的商业许可，则适用此处的许可协议条款，且软件被视为该条款下的"试用产品"。若已购买有效的商业许可，且用户（或其所属组织）与Ping Identity Corporation签署了软件许可协议，则适用该签署协议；否则，仍适用此处的条款。
• 在运行本镜像中的软件前，必须获取许可证：
  • 可通过此处定义的方式获取评估许可证。
  • 可通过联系Ping Identity购买商业许可证。

与所有Docker镜像一样，本镜像可能包含基础发行版中的其他软件及主软件的直接/间接依赖，这些软件可能受其他许可协议约束。各发行版中包含的第三方软件及其许可协议列表见https://github.com/pingidentity/pingidentity-devops-getting-started/blob/master/3RD_PARTY_SOFTWARE.md%E3%80%82%E5%AF%B9%E4%BA%8E%E4%BB%BB%E4%BD%95%E9%A2%84%E6%9E%84%E5%BB%BA%E9%95%9C%E5%83%8F%E7%9A%84%E4%BD%BF%E7%94%A8%EF%BC%8C%E7%A1%AE%E4%BF%9D%E7%AC%A6%E5%90%88%E5%85%B6%E4%B8%AD%E6%89%80%E6%9C%89%E8%BD%AF%E4%BB%B6%E7%9A%84%E7%9B%B8%E5%85%B3%E8%AE%B8%E5%8F%AF%E5%8D%8F%E8%AE%AE%E6%98%AF%E9%95%9C%E5%83%8F%E7%94%A8%E6%88%B7%E7%9A%84%E8%B4%A3%E4%BB%BB%E3%80%82

商业支持

本协议项下提供的软件按"现状"提供，不附带任何明示、暗示或法定的保证或陈述。

详情请联系***。

Docker镜像保留政策

Ping Identity维护的Docker镜像将在发布日期起一（1）个日历年内可在Docker Hub获取。为确保速度和可靠性，建议将所需镜像版本标记并推送到您自己的容器仓库。

Ping Identity不对Docker Hub上的镜像可用性提供任何保证。

Docker支持政策

• Ping Identity支持政策：[***]
• Ping Identity镜像支持政策：[***]

版权信息

Copyright © 2023 Ping Identity. 保留所有权利。