slapd-dcm4chee Docker镜像文档

1. 镜像概述

1.1 简介

slapd-dcm4chee是一个预配置的OpenLDAP服务器(slapd)Docker镜像，专为dcm4chee-arc 5.x归档系统设计。该镜像包含了所有必要的LDAP模式(schemas)和默认配置，可直接用于dcm4chee-arc 5.x环境的部署，简化了***影像归档系统的搭建流程。

1.2 主要用途

提供符合dcm4chee-arc 5.x要求的LDAP目录服务，用于存储和管理DICOM归档系统的配置信息、用户账户、权限设置及其他相关元数据。

2. 核心功能和特性

• 基于***OpenLDAP服务器构建
• 预加载dcm4chee-arc 5.x所需的所有LDAP模式：
  • DICOM相关模式(dicom.schema)
  • dcm4che扩展模式(dcm4che.schema)
  • 归档系统特定模式(dcm4chee-arc.schema)
• 默认配置包含:
  • 基本目录结构
  • 标准管理员账户
  • 适合***环境的访问控制策略
• 支持数据持久化存储
• 集成TLS/SSL加密
• 提供简单的配置自定义方式
• 兼容dcm4chee-arc 5.x所有版本

3. 使用场景和适用范围

3.1 适用场景

• dcm4chee-arc 5.x归档系统的开发环境搭建
• ***影像归档系统的测试部署
• 生产环境中的DICOM配置管理服务
• ***相关应用的LDAP目录服务

3.2 适用范围

• 医院PACS系统集成
• 医学影像研究机构
• ***软件开发商
• 需要符合DICOM标准的***IT环境

4. 快速开始

4.1 基本运行命令

docker run -d -p 389:389 -p 636:636 --name slapd-dcm4chee dcm4che/slapd-dcm4chee:latest

4.2 带有数据持久化的运行命令

docker run -d -p 389:389 -p 636:636 \
  -v /path/to/ldap/data:/var/lib/ldap \
  -v /path/to/slapd/config:/etc/ldap/slapd.d \
  --name slapd-dcm4chee dcm4che/slapd-dcm4chee:latest

5. 配置说明

5.1 环境变量

5.2 自定义配置示例

使用自定义域名和管理员密码:

docker run -d -p 389:389 -p 636:636 \
  -e LDAP_DOMAIN=hospital.example.org \
  -e LDAP_BASE_DN=dc=hospital,dc=example,dc=org \
  -e LDAP_ROOTPWD=StrongPassword123! \
  -e LDAP_ORGANISATION="Example Hospital" \
  --name slapd-dcm4chee dcm4che/slapd-dcm4chee:latest

6. Docker Compose配置

6.1 基本配置

version: '3'

services:
  slapd:
    image: dcm4che/slapd-dcm4chee:latest
    ports:
      - "389:389"
      - "636:636"
    environment:
      - LDAP_DOMAIN=hospital.example.org
      - LDAP_BASE_DN=dc=hospital,dc=example,dc=org
      - LDAP_ROOTPWD=StrongPassword123!
      - LDAP_ORGANISATION=Example Hospital
    volumes:
      - ldap-data:/var/lib/ldap
      - ldap-config:/etc/ldap/slapd.d
    restart: unless-stopped

volumes:
  ldap-data:
  ldap-config:

6.2 与dcm4chee-arc集成的完整配置

version: '3'

services:
  slapd:
    image: dcm4che/slapd-dcm4chee:latest
    ports:
      - "389:389"
      - "636:636"
    environment:
      - LDAP_DOMAIN=dcm4che.org
      - LDAP_BASE_DN=dc=dcm4che,dc=org
      - LDAP_ROOTPWD=secret
    volumes:
      - ldap-data:/var/lib/ldap
      - ldap-config:/etc/ldap/slapd.d
    restart: unless-stopped

  arc:
    image: dcm4che/dcm4chee-arc-psql:latest
    depends_on:
      - slapd
      - db
    environment:
      - LDAP_URL=ldap://slapd:389
      - LDAP_BASE_DN=dc=dcm4che,dc=org
      - LDAP_ROOTPWD=secret
      - POSTGRES_DB=dcm4chee
      - POSTGRES_USER=dcm4chee
      - POSTGRES_PASSWORD=dcm4chee
    ports:
      - "8080:8080"
      - "8443:8443"
      - "9990:9990"
    restart: unless-stopped

  db:
    image: postgres:13-alpine
    environment:
      - POSTGRES_DB=dcm4chee
      - POSTGRES_USER=dcm4chee
      - POSTGRES_PASSWORD=dcm4chee
    volumes:
      - db-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  ldap-data:
  ldap-config:
  db-data:

7. 数据持久化

为确保LDAP数据不丢失，建议使用Docker卷或主机目录挂载以下路径：

• /var/lib/ldap: LDAP数据库文件
• /etc/ldap/slapd.d: LDAP服务器配置

示例命令(主机目录挂载):

docker run -d -p 389:389 -p 636:636 \
  -v /host/path/to/ldap/data:/var/lib/ldap \
  -v /host/path/to/slapd/config:/etc/ldap/slapd.d \
  --name slapd-dcm4chee dcm4che/slapd-dcm4chee:latest

8. 安全配置

8.1 TLS/SSL设置

默认情况下，容器会自动生成自签名证书。在生产环境中，建议使用自定义证书：

docker run -d -p 389:389 -p 636:636 \
  -v /host/path/to/cert.pem:/etc/ldap/tls/cert.pem \
  -v /host/path/to/key.pem:/etc/ldap/tls/key.pem \
  -v /host/path/to/ca.pem:/etc/ldap/tls/ca.pem \
  -e TLS_CERT_FILE=/etc/ldap/tls/cert.pem \
  -e TLS_KEY_FILE=/etc/ldap/tls/key.pem \
  -e TLS_CA_FILE=/etc/ldap/tls/ca.pem \
  --name slapd-dcm4chee dcm4che/slapd-dcm4chee:latest

8.2 访问控制

默认配置包含基本的访问控制策略。可通过挂载自定义的slapd配置文件进行修改：

docker run -d -p 389:389 -p 636:636 \
  -v /host/path/to/custom/slapd.conf:/etc/ldap/slapd.conf \
  --name slapd-dcm4chee dcm4che/slapd-dcm4chee:latest

9. 管理和维护

9.1 连接到LDAP服务器

使用ldapsearch命令验证服务器状态：

ldapsearch -x -H ldap://localhost:389 -b "dc=dcm4che,dc=org" -D "cn=admin,dc=dcm4che,dc=org" -w secret

9.2 容器日志

查看容器日志：

docker logs slapd-dcm4chee

9.3 备份数据

备份LDAP数据：

docker exec slapd-dcm4chee slapcat > backup.ldif

恢复数据：

docker exec -i slapd-dcm4chee slapadd -c < backup.ldif

10. 故障排除

10.1 常见问题

1. 无法连接到LDAP服务器

   • 检查容器是否正在运行：docker ps | grep slapd-dcm4chee
   • 验证端口映射：docker port slapd-dcm4chee
   • 检查防火墙设置

2. 启动失败

   • 检查日志获取详细错误信息：docker logs slapd-dcm4chee
   • 确保挂载的目录权限正确
   • 尝试删除并重新创建持久化卷

3. dcm4chee-arc无法连接到LDAP

   • 验证LDAP_BASE_DN和LDAP_ROOTPWD是否匹配
   • 检查网络连接：docker exec -it dcm4chee-arc-container ping slapd

11. 版本信息

12. 相关资源

• dcm4che***网站
• dcm4chee-arc文档
• OpenLDAP***文档
• dcm4che Dockerfiles GitHub仓库