flywheel/dicomscp

DICOM SCP for Flywheel数据摄入镜像

镜像概述与主要用途

本镜像提供DICOM SCP（Service Class Provider）服务，专门用于将DICOM数据导入Flywheel数据管理平台。作为DICOM网络协议的服务端组件，该镜像可接收来自DICOM客户端（如设备、PACS系统）的DICOM数据，并通过与Flywheel平台的集成，实现数据的自动化摄入与集中管理，简化影像数据的收集流程。

核心功能与特性

• DICOM数据接收：作为标准DICOM SCP服务运行，支持DICOM C-STORE操作，接收DICOM格式的***影像数据。
• Flywheel集成：内置Flywheel API客户端，可将接收到的DICOM数据自动导入指定的Flywheel项目或组。
• 自动化数据处理：支持DICOM数据完整性验证，确保导入数据符合Flywheel平台要求。
• 灵活配置：通过环境变量或配置文件自定义DICOM服务参数（如AETitle、端口）及Flywheel连接信息。
• 日志监控：提供详细日志输出，记录数据接收状态、导入进度及错误信息，便于问题排查。

使用场景与适用范围

• ***影像中心：医院或影像中心需将CT、MRI等设备产生的DICOM数据集中管理至Flywheel平台时使用。
• 科研机构：研究项目中需自动化收集DICOM影像数据并整合至Flywheel进行分析管理的场景。
• 临床数据流程优化：替代手动上传流程，实现DICOM数据从设备到Flywheel平台的端到端自动化流转。

使用方法与配置说明

前置条件

• 已部署的Flywheel平台实例及有效的API密钥（需具备数据写入权限）。
• 网络环境中DICOM客户端可访问本服务的DICOM端口（默认104）。

Docker Run部署示例

bash
docker run -d \
  --name flywheel-dicom-scp \
  -p 104:104 \
  -e FLYWHEEL_API_KEY="your_flywheel_api_key" \
  -e FLYWHEEL_SITE_URL="https://your-flywheel-instance.flywheel.io" \
  -e DICOM_AETITLE="FLYWHEEL_SCP" \
  -e LOG_LEVEL="INFO" \
  flywheel/dicom-scp-ingestion:latest

Docker Compose配置示例

yaml
version: '3'
services:
  flywheel-dicom-scp:
    image: flywheel/dicom-scp-ingestion:latest
    container_name: flywheel-dicom-scp
    ports:
      - "104:104"
    environment:
      - FLYWHEEL_API_KEY=your_flywheel_api_key
      - FLYWHEEL_SITE_URL=https://your-flywheel-instance.flywheel.io
      - DICOM_AETITLE=FLYWHEEL_SCP
      - DICOM_PORT=104
      - LOG_LEVEL=INFO
      - FLYWHEEL_PROJECT=default_project  # 可选，默认导入项目
      - FLYWHEEL_GROUP=default_group      # 可选，默认导入组
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置参数说明

服务验证方法

1. 检查容器运行状态：docker ps | grep flywheel-dicom-scp
2. 查看服务日志：docker logs flywheel-dicom-scp，确认服务已启动并监听端口
3. 使用DICOM测试工具发送测试数据（如dcmtk的storescu）：

   bash
   storescu -aet TEST_AETITLE -aec FLYWHEEL_SCP localhost 104 path/to/test.dcm
   

4. 在Flywheel平台验证数据是否成功导入