Orthanc-nginx

概述

Orthanc-nginx是一个运行在Orthanc前端的Web服务，主要用于处理***影像研究的共享和管理界面访问。它通过环境变量配置不同服务的路由规则，实现对Orthanc主服务、认证服务、查看器等组件的访问控制和请求转发。

核心功能和特性

• 通过环境变量灵活启用/禁用不同服务的访问路由
• 支持多种***影像相关服务的集成，包括Orthanc、Keycloak、MedDream查看器、OHIF查看器等
• 提供客户端证书认证和HTTPS加密功能，增强访问安全性
• 为API访问、共享链接等场景提供专用路由配置

使用场景和适用范围

• ***影像系统中需要共享研究数据（如通过 publication 链接）
• 集成多种影像查看器（MedDream、OHIF）到统一访问入口
• 需要通过Keycloak进行用户认证和授权的场景
• 为DicomWeb客户端或脚本提供Orthanc API访问接口
• 需要通过客户端证书控制特定服务访问权限的安全场景

配置说明

服务启用配置

通过以下环境变量控制不同服务的访问权限，设置为true时启用对应路由：

注意：当ENABLE_CLIENT_CERTIFICATE设为true时，必须在/etc/nginx/ssl/ca.crt提供根CA证书。客户端需出示由该根CA签名的证书才能获得访问权限。

其他配置

注意：当ENABLE_HTTPS设为true时，必须在/etc/nginx/tls/crt.pem提供证书文件，并在/etc/nginx/tls/key.pem提供私钥文件。

部署示例

以下是基本的Docker运行示例，启用Orthanc主服务和OHIF查看器：

bash
docker run -d \
  -p 80:80 \
  -e ENABLE_ORTHANC=true \
  -e ENABLE_OHIF=true \
  --name orthanc-nginx \
  orthanc-nginx:latest

更多演示配置可参考 GitHub仓库。