jodogne/orthanc

Orthanc Docker镜像文档

1. 镜像概述和主要用途

Orthanc Docker镜像是用于构建和运行Orthanc及其官方插件的容器化解决方案。Orthanc是一款轻量级、RESTful架构的医学影像中立归档服务器（Vendor Neutral Archive, VNA），旨在标准化存储、管理和交换DICOM（数字成像和通信医学）格式的***影像数据。该镜像集成了Orthanc核心服务及官方插件，提供开箱即用的医学影像归档能力。

2. 核心功能和特性

2.1 DICOM标准支持

• 完整兼容DICOM 3.0标准，支持DICOM C-STORE（存储）、C-FIND（查询）、C-MOVE（检索）等服务类。
• 支持DICOM元数据解析与管理，兼容多种影像模态（如CT、MRI、超声等）。

2.2 RESTful API接口

• 提供HTTP/HTTPS RESTful API，支持通过JSON格式进行影像数据CRUD操作、系统配置及状态监控。
• 支持Web界面访问（默认路径http://<host>:8042），可直接浏览和管理DICOM数据。

2.3 轻量级架构

• 基于C++开发，无复杂依赖，单进程运行，资源占用低（最小内存需求<128MB），适合边缘计算或嵌入式环境部署。

2.4 插件扩展能力

• 集成官方插件生态，支持功能扩展，如：
  • 数据库存储（PostgreSQL、MySQL）
  • DICOMweb协议（WADO-RS、QIDO-RS）
  • 医学影像可视化（OHIF Viewer集成）
  • 安全认证（LDAP、OAuth2）

2.5 数据存储灵活性

• 支持本地文件系统存储（默认）或通过插件对接外部数据库，数据持久化可通过容器卷挂载实现。

3. 使用场景和适用范围

3.1 医学影像归档系统

• 医院、诊所等***机构的PACS（ Picture Archiving and Communication System）辅助存储节点，用于长期归档DICOM影像。

3.2 DICOM数据交换枢纽

• 作为***设备（如CT机、X光机）与医院信息系统（HIS）、电子病历系统（EMR）之间的DICOM数据中转服务。

3.3 ***软件开发与测试

• 为医学影像相关应用（如AI辅助诊断、影像分析工具）提供标准化DICOM服务测试环境。

3.4 多中心***协作

• 支持跨机构DICOM数据共享，通过RESTful API实现远程影像检索与传输。

4. 使用方法

4.1 Docker Run命令示例

4.1.1 基础运行（默认配置）

启动Orthanc服务，暴露HTTP端口（8042）和DICOM端口（104），并挂载数据卷持久化存储：

bash
docker run -d \
  --name orthanc \
  -p 8042:8042 \  # HTTP/RESTful API端口
  -p 104:104 \    # DICOM服务端口（TCP）
  -v ./orthanc-data:/var/lib/orthanc/db \  # 数据持久化目录
  osimis/orthanc  # 官方镜像名称

4.1.2 带基础认证的配置

通过环境变量设置Web界面及API访问的用户名和密码：

bash
docker run -d \
  --name orthanc-auth \
  -p 8042:8042 \
  -p 104:104 \
  -v ./orthanc-data:/var/lib/orthanc/db \
  -e ORTHANC_USER=admin \    # 登录用户名
  -e ORTHANC_PASSWORD=P@ssw0rd \  # 登录密码
  osimis/orthanc

4.2 Docker Compose配置示例

创建docker-compose.yml文件，定义服务、网络及持久化配置：

yaml
version: '3.8'

services:
  orthanc:
    image: osimis/orthanc
    container_name: orthanc
    restart: always
    ports:
      - "8042:8042"   # HTTP/REST端口
      - "104:104/tcp" # DICOM端口（TCP协议）
    volumes:
      - ./orthanc-data:/var/lib/orthanc/db:rw  # 数据存储目录
      - ./orthanc.json:/etc/orthanc/orthanc.json:ro  # 自定义配置文件（可选）
    environment:
      - ORTHANC_USER=radiologist  # 自定义用户名
      - ORTHANC_PASSWORD=Rad@2024  # 自定义密码
      - DICOM_AETITLE=HOSPITAL_VNA  # DICOM应用实体标题（默认：ORTHANC）
    networks:
      - orthanc-net

networks:
  orthanc-net:
    driver: bridge

启动服务：

bash
docker-compose up -d

5. 配置说明

5.1 环境变量

Orthanc镜像支持通过环境变量快速配置核心参数，常用变量如下：

5.2 配置文件挂载

对于复杂配置（如插件启用、高级DICOM参数、数据库连接等），需通过挂载自定义orthanc.json配置文件实现。容器内默认配置路径为/etc/orthanc/orthanc.json，用户可通过本地文件挂载覆盖默认配置：

5.2.1 自定义配置文件示例（orthanc.json）

json
{
  "Name": "Hospital-VNA",
  "DicomAet": "HOSPITAL_VNA",
  "DicomPort": 104,
  "HttpPort": 8042,
  "AuthenticationEnabled": true,
  "RegisteredUsers": {
    "admin": "P@ssw0rd",
    "radiologist": "Rad@2024"
  },
  "Plugins": [
    "/usr/share/orthanc/plugins/libOrthancDicomWeb.so",
    "/usr/share/orthanc/plugins/libOrthancPostgreSQL.so"
  ],
  "PostgreSQL": {
    "Host": "postgres",
    "Port": 5432,
    "Database": "orthanc",
    "Username": "orthanc-user",
    "Password": "db-pass"
  }
}

5.2.2 挂载配置文件

通过-v参数将本地配置文件挂载至容器：

bash
docker run -d \
  --name orthanc-custom \
  -p 8042:8042 \
  -p 104:104 \
  -v ./orthanc-data:/var/lib/orthanc/db \
  -v ./orthanc.json:/etc/orthanc/orthanc.json:ro \  # 只读挂载配置文件
  osimis/orthanc

6. 参考文档

• 完整配置指南：Orthanc Book - Docker章节
• DICOM服务协议：DICOM 3.0 Standard
• Orthanc官方插件列表：Orthanc Plugins