oaktreetech/orthanc-sonador

Orthanc PACS with Sonador Plugin Docker镜像文档

镜像概述

本Docker镜像基于Orthanc PACS服务器集成Sonador插件构建，提供轻量级、可扩展的医学影像管理解决方案。Orthanc是一款开源PACS服务器，支持DICOM标准协议，具备影像存储、查询、检索等核心功能；Sonador插件进一步扩展其能力，专注于DICOM结构化报告（SR）处理、工作流自动化及第三方系统集成，适用于***影像管理场景的快速部署与应用。

核心功能与特性

Orthanc PACS基础功能

• DICOM标准支持：兼容DICOM 3.0标准，支持C-STORE（存储）、C-FIND（查询）、C-MOVE（检索）等DICOM服务类。
• Web管理界面：内置Web客户端，支持影像预览、患者/检查数据管理、DICOM元数据查看。
• REST API：提供RESTful API，支持通过HTTP接口进行影像操作与系统配置。
• 数据持久化：支持影像数据与配置的持久化存储，确保服务重启后数据不丢失。
• 轻量级架构：资源占用低，适合中小规模部署或嵌入式环境。

Sonador插件增强功能

• DICOM结构化报告（SR）处理：支持SR文档的解析、存储与检索，满足结构化医学报告管理需求。
• 工作流自动化：提供可配置的影像处理工作流，如自动路由、 anonymization（去标识化）、格式转换等。
• 第三方系统集成：支持与HIS/LIS系统、电子病历（EMR）及影像分析工具的接口对接。
• 日志与审计：增强系统操作日志记录，支持合规性审计与故障排查。

使用场景

• 医院/诊所影像科：用于存储X光、CT、MRI等设备产生的医学影像，支持医生查询与诊断。
• 医学影像研究机构：管理科研项目中的影像数据，结合SR功能记录研究分析结果。
• 远程*系统**：作为分布式影像中心节点，支持跨机构影像共享与远程诊断。
• 软件测试环境：快速搭建标准化PACS服务，用于影像相关软件的开发与测试。

使用方法与配置说明

快速启动（Docker Run）

通过以下命令启动容器，默认配置下可直接使用基础功能：

bash
docker run -d \
  --name orthanc-sonador \
  -p 4242:4242 \  # DICOM服务端口
  -p 8042:8042 \  # Web界面与REST API端口
  -v orthanc-data:/var/lib/orthanc/db \  # 持久化存储卷（自动创建）
  orthanc/orthanc-sonador:latest

持久化存储配置

为避免容器重启后数据丢失，建议显式挂载主机目录作为持久化存储：

bash
docker run -d \
  --name orthanc-sonador \
  -p 4242:4242 \
  -p 8042:8042 \
  -v /host/path/to/orthanc/db:/var/lib/orthanc/db \  # 主机目录挂载（需提前创建）
  -v /host/path/to/orthanc/config:/etc/orthanc \  # 自定义配置文件挂载（可选）
  orthanc/orthanc-sonador:latest

环境变量配置

通过环境变量自定义核心参数（部分常用参数如下）：

示例：自定义用户名/密码并启用DEBUG日志

bash
docker run -d \
  --name orthanc-sonador \
  -p 4242:4242 \
  -p 8042:8042 \
  -v orthanc-data:/var/lib/orthanc/db \
  -e ORTHANC_USERNAME=admin \
  -e ORTHANC_PASSWORD=SecurePass123! \
  -e SONADOR_LOG_LEVEL=DEBUG \
  docker.xuanyuan.run/orthanc/orthanc-sonador:latest

高级配置（自定义orthanc.json）

如需精细化配置（如DICOM节点、插件参数等），可通过挂载自定义orthanc.json文件实现。默认配置文件路径为/etc/orthanc/orthanc.json，示例配置片段：

json
{
  "Name": "My Hospital PACS",
  "DicomAet": "ORTHANC_SONADOR",
  "Plugins": [
    "/usr/share/orthanc/plugins/libSonador.so"  # Sonador插件路径（默认已配置）
  ],
  "Sonador": {
    "Workflow": {
      "AutoRoute": true,
      "AnonymizeOnStore": false
    }
  }
}

挂载自定义配置文件启动：

bash
docker run -d \
  --name orthanc-sonador \
  -p 4242:4242 \
  -p 8042:8042 \
  -v /host/path/to/orthanc.json:/etc/orthanc/orthanc.json \
  -v orthanc-data:/var/lib/orthanc/db \
  docker.xuanyuan.run/orthanc/orthanc-sonador:latest

访问与验证

• Web管理界面：启动后通过 http://<主机IP>:8042 访问，使用配置的用户名/密码登录（默认：orthanc/orthanc）。
• DICOM服务测试：使用DICOM发送工具（如Horos、Weasis）向 主机IP:4242 发送影像，验证存储功能。
• REST API调用：通过 http://<主机IP>:8042/api 访问API，例如查询患者列表：

  bash
  curl -u orthanc:orthanc http://<主机IP>:8042/api/patients
  

注意事项

• 数据安全：***影像数据敏感，建议通过HTTPS加密Web访问（可配合反向代理如Nginx实现），并限制DICOM端口访问权限。
• 性能优化：大规模部署时，建议将持久化存储挂载至高性能磁盘（如SSD），并根据并发量调整容器CPU/内存资源。
• 版本兼容性：Sonador插件版本需与Orthanc核心版本匹配，建议使用官方镜像标签指定稳定版本（如:1.12.0-sonador1.5）。