dcm4che/dcm4che-tools

dcm4che 3 DICOM工具集镜像文档

1. 镜像概述

dcm4che 3是基于Java开发的开源DICOM（数字成像和通信医学）工具集，实现了DICOM 3.0标准的核心协议与功能。该镜像封装了dcm4che 3的全套工具，包括命令行工具、网络服务组件及Java开发库，可直接用于部署DICOM服务或集成到医学影像系统中，简化***信息化场景下的DICOM数据处理流程。

2. 核心功能与特性

2.1 DICOM文件操作

• 格式处理：支持DICOM文件的解析、生成、验证及元数据编辑，兼容多种DICOM媒体存储格式（如DICOM Part 10文件）。
• 格式转换：提供DICOM到JPEG/PNG等图像格式的转换（dcm2jpg、dcm2png），及DICOM数据压缩/解压（支持JPEG、JPEG 2000等压缩算法）。
• 隐私保护：内置DICOM去标识（anonymization）工具（dcm anonymize），支持按DICOM标准移除患者隐私信息，满足HIPAA等合规要求。

2.2 网络服务组件

• 存储服务（C-STORE SCP）：通过storescp工具启动DICOM存储服务，接收并持久化存储远程设备发送的DICOM影像。
• 查询/检索服务：支持DICOM查询（C-FIND）、检索（C-GET/C-MOVE）客户端（findscu、getscu），实现DICOM数据的远程查询与获取。
• 安全传输：支持DICOM TLS加密传输（-tls参数），保障数据传输过程中的安全性。

2.3 工具集与集成能力

• 命令行工具：提供超过30种命令行工具（如dcmsend、dcmqr、dcmvalidator），覆盖DICOM处理全流程。
• Java开发库：包含完整的DICOM协议Java API，支持二次开发，可集成到自定义医学影像应用中。
• 跨平台兼容：基于Docker容器化部署，支持Linux、Windows、macOS等主流操作系统。

3. 使用场景与适用范围

3.1 医学影像系统开发

• 作为DICOM协议实现组件，用于构建PACS（影像归档和通信系统）、RIS（放射科信息系统）等核心***影像系统。
• 开发DICOM数据处理模块，如影像格式转换、元数据提取、质量控制等功能。

3.2 DICOM数据管理

• 自动化处理DICOM文件：批量转换格式、去标识处理、元数据标准化，适用于医学研究数据预处理。
• 搭建轻量级DICOM存储节点，临时接收或中转***设备（如CT、MRI）输出的影像数据。

3.3 ***数据集成与测试

• 与医院信息系统（HIS）、实验室信息系统（LIS）集成，实现DICOM影像与患者信息的关联传输。
• ***信息化教学、DICOM协议兼容性测试及医学影像应用原型验证。

4. 使用方法与配置说明

4.1 基本使用（Docker Run）

通过docker run命令可直接调用镜像中的工具或启动服务，以下为典型场景示例：

4.1.1 启动DICOM存储服务（C-STORE SCP）

启动一个接收DICOM文件的存储服务，将文件保存到本地目录：

bash
docker run -d --name dcm4che-storescp \
  -p 104:104 \  # 映射DICOM默认端口（TCP）
  -v /local/dicom-storage:/dcm4che/data \  # 挂载本地目录存储DICOM文件
  dcm4che/dcm4che:3.3.8 \  # 替换为实际镜像标签（如3.3.8）
  storescp -b DCM4CHEE:104 \  # 配置AE Title与端口
  -d \  # 启用调试日志（可选）
  /dcm4che/data  # 存储路径

4.1.2 DICOM文件转换（dcm2jpg）

将本地DICOM文件转换为JPEG格式：

bash
docker run --rm \
  -v /local/input:/input \  # 输入目录（包含DICOM文件）
  -v /local/output:/output \  # 输出目录（保存JPEG文件）
  dcm4che/dcm4che:3.3.8 \
  dcm2jpg -i /input/example.dcm -o /output/example.jpg

4.2 核心配置参数

4.3 Docker Compose示例

以下为集成DICOM存储服务与数据持久化的docker-compose.yml配置：

yaml
version: '3'
services:
  dcm4che-storescp:
    image: dcm4che/dcm4che:3.3.8
    container_name: dcm4che-storescp
    restart: unless-stopped
    ports:
      - "104:104"  # DICOM服务端口
    volumes:
      - ./dicom-data:/dcm4che/data  # 本地DICOM存储目录
      - ./config:/dcm4che/config  # 自定义配置文件（如日志配置）
    command: storescp -b HOSPITAL_AE:104 -d /dcm4che/data
    environment:
      - TZ=Asia/Shanghai  # 设置时区

5. 注意事项

• 版本兼容性：不同版本的dcm4che 3工具集可能存在命令参数差异，使用前需参考官方文档确认具体版本的工具用法。
• 资源配置：处理大量或高分辨率DICOM文件时，建议通过--cpus和-m参数分配足够的CPU与内存资源（如--cpus 2 -m 4g）。
• 网络安全：公网部署时需限制端口访问范围（如通过Docker网络策略或主机防火墙），并优先启用TLS加密传输。