# orthanc.json 配置说明

## Name

显示在 Orthanc web 服务的 header 文字

## StorageDirectory

> EnableStorage 为 true 的话，默认是用数据库插件的路径存储。

用来指定 Orthanc 存储 DICOM 文件的目录的，它不仅针对 sqlite，也针对其他数据库插件，例如 PostgreSQL 或 MySQL。但是如果使用了数据库插件，你也可以配置它们把 DICOM 文件存储在数据库中，而不是在 StorageDirectory 指定的目录中

## IndexDirectory

用来指定 Orthanc 存储 SQLite 索引的目录，如果没设置，默认使用 `StorageDirectory` 的值，可以优化性能

## TemporaryDirectory

临时文件夹，可以被安全的删除，

- UNIX-like: "/tmp/Orthanc/
- windows: "C:/Temp"

## StorageCompression

用来指定 Orthanc 是否对 DICOM 文件进行压缩的。如果这个属性设置为 true，Orthanc 会在存储 DICOM 文件之前，使用 gzip 算法对它们进行压缩，以节省磁盘空间。如果这个属性设置为 false，Orthanc 不会对 DICOM 文件进行压缩，而是保持它们的原始传输语法

## MaximumStorageSize

存储大小限制，`0`代表不限制

## MaximumPatientCount

在给定时间可以存储的最大患者数量，`0`代表不限制

## LuaScripts []

可以嵌入到 Orthanc 中的脚本语言，它可以用来定制 Orthanc 的行为和逻辑，以适应特定的医疗工作流程。你可以使用 lua 脚本来实现以下功能：

- 响应 Orthanc 的各种事件，例如接收到 DICOM 实例、提交了一个任务、完成了一个任务等。
- 过滤或修改传入的 DICOM 实例或 REST 请求，例如删除敏感信息、添加元数据、转换传输语法等。
- 调用 Orthanc 的 REST API 或其他外部服务，例如发送邮件、通知、日志等。
- 实现自定义的插件或扩展，例如增加新的 REST 端点、提供新的功能或界面等。

## Plugins []

插件的目录

```json
"Plugins": ["/usr/share/orthanc/plugins"]
```

## ConcurrentJobs

> Orthanc <= 1.3.2 ，请设为 1

用来指定 Orthanc 可以同时运行的任务（jobs）的最大数量的。任务是一种可以在 Orthanc 中执行的长时间操作，例如转码、导出、修改、删除等。你可以通过 REST API 来创建、查询、取消或删除任务。ConcurrentJobs 属性可以控制 Orthanc 的并发性能和资源消耗，你可以根据你的硬件配置和工作负载来调整这个属性

- 设置为 `0`，使用全部的 CPU 核心

## HttpServerEnabled

如果此参数设置为“false”，禁用 REST API。默认 Orthanc 充当纯粹的 DICOM 服务器。

## HttpPort

REST API 服务 web 界面端口

## HttpDescribeErrors

当以下选项为`true`时，如果遇到错误在调用 REST API 时，一条描述错误的 JSON 消息放在 HTTP 响应中

## HttpCompressionEnabled

启用 HTTP 压缩以提高网络带宽利用率

支持`gzip`和`deflate` 编码。

## DicomServerEnabled

启用 DICOM 服务器。如果此参数设置为“false”，Orthanc 充当纯粹的 REST 服务器。不能接收文件或通过 DICOM 协议进行查询/检索。

## DicomAet

> Aet:（Application Entity Title）

用来标识 DICOM 网络节点的字符串，它在 DICOM 通信中起到了类似于 IP 地址或域名的作用。

## DicomCheckCalledAet

用来指定 Orthanc 是否检查传入的 DICOM 连接的应用实体标题（Application Entity Title）的。

如果这个属性设置为：

- true：接受与 `DicomAet` 属性相同的连接
- false：接受全部连接

## DicomPort

DICOM 服务器的端口

## DefaultEncoding

> 推荐设置 Utf8 || Chinese

假设的 DICOM 文件的默认编码没有 `SpecificCharacterSet`DICOM 标签，指定 Orthanc 的默认字符编码

- Ascii
- Utf8
- Latin1
- Latin2
- Latin3
- Latin4
- Latin5
- Cyrillic: 西里尔字母
- Windows1251
- Arabic: 阿拉伯语
- Greek: 希腊语
- Hebrew: 希伯来语
- Thai
- Japanese
- Chinese
- JapaneseKanji
- Korean
- SimplifiedChinese: 简体中文

## DeflatedTransferSyntaxAccepted

> Deflated 压缩是一种基于 Zlib 的无损压缩算法，可以减少 DICOM 文件的大小

用来控制是否接受 `Deflated` 压缩的 DICOM 文件

## JpegTransferSyntaxAccepted

用来控制是否接受 JPEG 压缩的 DICOM 文件

## JpegLosslessTransferSyntaxAccepted

用来控制是否接受 JPEG 无损压缩的 DICOM 文件

## JpipTransferSyntaxAccepted

> JPIP 是一种基于网络的交互式图像传输协议，可以实现图像的渐进式加载和区域访问

控制是否接受 JPIP 压缩的 DICOM 文件

## Mpeg2TransferSyntaxAccepted

> MPEG-2 是一种用于视频和音频的压缩标准，可以实现高质量的多媒体传输

用来控制是否接受 `MPEG-2` 压缩的 DICOM 文件

## RleTransferSyntaxAccepted

> RLE 是一种无损压缩算法，可以减少 DICOM 文件的大小

是否接受 RLE 压缩的 DICOM 文件

## UnknownSopClassAccepted

> SOP 类是一种定义了 DICOM 服务类型和信息对象类型的标识符

用来控制是否接受未知的存储 SOP 类的 DICOM 文件

## DicomScpTimeout

作为 C-Store SCP 传输超时设计

## RemoteAccessAllowed

用来控制是否允许远程主机连接到 HTTP 服务器

## SslEnabled

是否启用 SSL 加密

## SslCertificate

指定 SSL 证书的路径

## AuthenticationEnabled

> 设为 false 无需密码登录

是否启用`用户名密码`登录。从 Orthanc 1.5.8 开始，默认启用，需要开启`RemoteAccessAllowed`

## RegisteredUsers

访问 `8042 web`需要输入的账号密码，如果为 `{}`，直接访问

```json
"RegisteredUsers": {
  // 用户1
  "demo": "demo",
  // 用户2
  "hm": "27516120"
},
```

## DicomModalities

用来配置已知的 DICOM 设备的列表的，每个设备需要指定：

1. 一个符号名称，AET（应用实体标题）
2. IP 地址
3. 端口号

这样就可以通过`DICOM commands (C-ECHO,C-STORE, C-FIND, C-MOVE...)`与这些设备进行 DICOM 通信。

```json
"demo": [
  "HM-ORTHANC",
  "192.168.1.126",
  4242
],
"ohif" : [ "OHIFDCM", "viewer", 3000 ]
```

## DicomModalitiesInDatabase

是否将 DICOM 模式存储在 Orthanc 数据库中，而不是在此配置文件中（Orthanc 1.5.0 中的新增）

## DicomAlwaysAllowEcho

Orthanc SCP 是否允许传入的 `C-Echo` 请求，只有`Orthanc 1.3.0`默认为 false

## DicomAlwaysAllowStore

Orthanc SCP 是否允许传入的 `C-Store` 请求

## DicomCheckModalityHost

Orthanc 是否检查远程的 IP/主机名地址，启动 DICOM 连接的模式

## DicomScuTimeout

远程 DICOM SCP（服务器）没有回答的，超时就关闭，单位 `seconds`

# OrthancPeers

用来配置已知的 Orthanc 服务器的列表的，每个服务器需要指定一个符号名称，以及其基本 URL，可能还需要用户名和密码（如果该服务器启用了密码保护的话）。可以通过 HTTP/HTTPS 协议与这些服务器进行资源的发送和接收。

```json
  "OrthancPeers": {
    "peer"  : [ "http://127.0.0.1:8043/", "alice", "alicePassword" ]
    "peer2" : [ "http://127.0.0.1:8044/" ]
    "peer3" : {
      "Url" : "http://127.0.0.1:8043/",
      "Username" : "alice",
      "Password" : "alicePassword",
      "HttpHeaders" : { "Token" : "Hello world" },
      "CertificateFile" : "client.crt",
      "CertificateKeyFile" : "client.key",
      "CertificateKeyPassword" : "certpass",
      "Pkcs11" : false
    }
  },
```

## OrthancPeersInDatabase

是否将`peers`存在数据库中

## HttpProxy

网络访问受限的情况下，可以使用 配置 http 代理

## HttpVerbose

是否在日志中显示 Orthanc 发出的 HTTP 请求的详细信息的

## HttpTimeout

http 服务请求超时时间，单位 `seconds`

## HttpsVerifyPeers

`peers`在 http 通信过程中 是否校验`ssl证书`

## HttpsCACertificates

`peers` 通信证书的路径，证书必须采用 PEM 格式，基于 Debian 的系统，此选项可以设置为`/etc/ssl/certs/ca-certificates.crt`

## UserMetadata

用来定义用户自定义元数据的字典，将一个介于 1024 和 65535 之间的数字映射到一个唯一的字符串。这个选项可以用于为 DICOM 资源添加一些额外的信息，例如患者的电话号码或者检查的费用

## UserContentType

`MIME`限制

## StableAge

定义一个 DICOM 资源被认为是稳定的所需的最小生命周期（以`秒`为单位）

## StrictAetComparison

避免在资源还在接收过程中就被处理或者导出。`Aet`名称严格要求`大小写`相同

## StoreMD5ForAttachments

> 默认为 true

是否为每个附件计算并存储 MD5 校验，检测附件是否被篡改或者损坏，但是会增加一些存储空间和计算时间的开销

## LimitFindResults

> 默认为 0，不限制

响应 `C-Find` 请求时返回的最大结果数

## LimitFindInstances

> 默认为 0，不限制

响应 `C-Find` 请求时返回的最大实例数

## LimitJobs

> 可以用于控制 Orthanc 的并发性能，但是也会增加内存和 CPU 的消耗

给定时间同时运行的最大处理任务数的，如果设置为 0，则表示使用所有可用的 CPU 逻辑核心。

## LogExportedResources

LogExportedResources 参数是用来控制是否在日志中记录导出到其他 DICOM 设备或者 Orthanc 节点的资源的

## KeepAlive

用来控制是否启用 HTTP 长连接的，这个选项可以用于提高 HTTP 通信的效率，但是也会占用更多的网络资源

## TcpNoDelay

是否禁用 TCP 延迟算法，如果设置为 true，则表示禁用

## HttpThreadsCount

> 这个选项可以用于控制 Orthanc 的并发性能，但是也会增加内存和 CPU 的消耗

用来控制处理 HTTP 请求的线程数的，如果设置为 0，则表示使用所有可用的 CPU 逻辑核心。

## StoreDicom

如果此选项设置为`false`，Orthanc 将仅在索引中运行模式。DICOM 文件不会存储在驱动器上。

> 此选项可能会阻止升级到较新版本的 Orthanc

## DicomAssociationCloseDelay

> 避免过早地关闭 DICOM 关联，导致一些设备无法发送后续的 DICOM 文件

在没有收到进一步的 `DIMSE` 命令后，Orthanc 作为 C-Store SCP 关闭 DICOM 关联的延迟时间（以秒为单位）

## QueryRetrieveSize

查询/检索 DICOM 请求的最大数量

## CaseSensitivePN

> 默认情况下，搜索是不区分大小写

处理 C-Find SCP 请求时，将此标志设置为`true`，将为 PN 值表示启用区分大小写的匹配（如患者姓名）。

## Pkcs11

硬件安全模块（HSM）进行 HTTPS 客户端身份验证时的智能卡

```json
"Pkcs11": {
  "Module" : "/usr/local/lib/libbeidpkcs11.so",
  "Module" : "C:/Windows/System32/beidpkcs11.dll",
  "Pin" : "1234",
  "Verbose" : true
}
```

## LoadPrivateDictionary

> 以用于避免与用户自定义的私有 DICOM 标签冲突，但是也会导致一些私有 DICOM 标签无法识别

是否加载 Orthanc 自带的私有 DICOM 标签字典的

## Locale

> 可以用于支持不同语言和字符集的人名，但是也会影响排序和检索的结果

指定 Orthanc 使用的区域设置的，目前只用于比较人名（PN）类型的 DICOM 标签。

## Dictionary

> 可以用于扩展 Orthanc 支持的 DICOM 标签，但是也要注意避免与现有的 DICOM 标准或者私有字典冲突

定义用户自定义的 DICOM 标签字典的，每个条目必须将一个十六进制的标签编号映射到一个字符串，表示该标签的 VR（值表示）和名称。

```json
"Dictionary": {
  "0008,0005": ["SpecificCharacterSet", "GB18030", 1, 1]
  "0014,1020" : [ "DA", "ValidationExpiryDate", 1, 1 ]
  "00e1,10c2" : [ "UI", "PET-CT Multi Modality Name", 1, 1, "ELSCINT1" ]
  "7053,1003" : [ "ST", "Original Image Filename", 1, 1, "Philips PET Private Group" ]
  "2001,5f" : [ "SQ", "StackSequence", 1, 1, "Philips Imaging DD 001" ]
}
```

## SynchronousCMove

是否同步运行 DICOM C-Move 操作

## JobsHistorySize

保存在内存中的已完成作业的最大数量

## SaveJobs

> 默认 true

是否将作业保存到 Orthanc 数据库中。挂起/正在运行/完成的作业是如果 Orthanc 停止，则自动从数据库重新加载然后`重新启动`

## OverwriteInstances

> 默认 false，不覆盖

指定 Orthanc 在接收 DICOM 实例，是否覆盖

## MediaArchiveSize

ZIP/媒体档案的最大数量

## StorageAccessOnFind

> 默认 Always，允许 Orthanc 在需要时立即读取存储区域

C-FIND 期间，指定 Orthanc 如何访问存储的性能设置

## MetricsEnabled

是否启用 `Prometheus` 兼容的指标接口的，如果设置为 true，则表示启用。用于监控 Orthanc 的运行状态和性能，但是也会增加一些内存和 CPU 的消耗

## ExecuteLuaEnabled

> 默认情况下禁用

是否启用了对 URI`/tools/execute-script`的调用。Orthanc 1.5.8，出于安全考虑

## HttpRequestTimeout

以秒为单位设置 HTTP 请求的超时，这个参数对应于 `Mongoose/Civetweb` 的 `request_timeout_ms` 也有影响

## DicomWeb

```json
"DicomWeb":{
    "Enable": true, // 是否开启 Enable
    "Root": "/dicom-web/", // DICOMweb API的根URI（适用于QIDO-RS、STOW-RS和WADO-RS）
    "EnableWado": true, // 是否启用WADO-URI（以前称为WADO）支持
    "WadoRoot": "/wado", // WADO-URI的根URI（又名WADO）API
    "Ssl": false, // ssl 开启
    "QidoCaseSensitive": true, // 对于QIDO-RS服务器，搜索是否区分大小写（自版本0.5起）
    "Host": "localhost", // WADO-RS请求的 host
    "StudiesMetadata": "Full", // 如何检索 研病例级元数据
    "SeriesMetadata": "Full" // 如何检 索序列级元数据
}
```

## PostgreSQL

```json
"PostgreSQL": {
  "EnableIndex": true,
  "EnableStorage": true, // 启用或禁用PostgreSQL存储插件。如果设置为true，Orthanc将把它接收到的DICOM文件存储为PostgreSQL数据库中的大对象。如果设置为false，Orthanc将继续使用默认的文件系统存储区域。对应的是 StorageDirectory属性的路径，也就是DICOM文件存储在/var/lib/orthanc/db/ 里
  "Host": "postgres", // PostgreSQL容器的host，对应 docker 的 container_name
  "Port": 5432, // PostgreSQL容器服务的端口
  "Database": "orthanc", // PostgreSQL容器数据库名称
  "Username": "orthanc", // PostgreSQL容器数据库用户名
  "Password": "orthanc" // PostgreSQL容器数据库密码
}
```