hapiproject/hapi Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

HAPI-FHIR JPA Server Docker 镜像文档

镜像概述

本镜像基于 HAPI-FHIR JPA Server 启动项目构建，提供了一种便捷的方式部署 FHIR (Fast Healthcare Interoperability Resources) 服务器。该镜像封装了 HAPI FHIR JPA 模块的核心功能，支持通过 Docker 快速启动和配置 FHIR 服务，适用于***健康数据交换、***系统集成等场景。

核心功能与特性

• 便捷部署：可直接从 Docker Hub 获取预构建镜像，无需本地配置 JDK 和 Maven 环境
• 灵活配置：支持通过环境变量、自定义 YAML 配置文件调整服务器参数
• 多数据库支持：默认使用 H2 数据库，可配置为 MySQL、PostgreSQL 等外部数据库
• 扩展功能：支持 Elasticsearch 集成、订阅功能、MDM (Master Data Management)、CQL (Clinical Quality Language) 等高级特性
• 安全轻量：提供基于 Distroless 的镜像变体，减小镜像体积并提升安全性

使用场景

• ***健康系统中 FHIR 数据模型的服务端部署
• ***数据交换平台的 FHIR API 服务搭建
• 开发者测试 FHIR 客户端应用的本地服务环境
• ***标准合规系统的 FHIR 接口实现

快速开始

从 Docker Hub 获取并运行镜像

1. 拉取镜像
   获取最新版本镜像：

   bash
   docker pull hapiproject/hapi:latest
   

   如需指定版本，可替换 latest 为具体版本标签（如 v5.7.0）。

2. 运行容器
   使用默认配置启动容器，映射容器 8080 端口到主机 8080 端口：

   bash
   docker run -p 8080:8080 hapiproject/hapi:latest
   

   服务启动后，可通过 http://localhost:8080 访问 Web UI，通过 http://localhost:8080/fhir/metadata 查看 FHIR 元数据。

自定义端口映射

如需使用非默认端口（如 8888），调整端口映射参数：

bash
docker run -p 8888:8080 hapiproject/hapi:latest

此时服务访问地址为 http://localhost:8888。

高级配置

通过环境变量配置

可通过 -e 参数传递环境变量修改默认配置，例如设置默认编码格式为 XML：

bash
docker run -p 8080:8080 -e hapi.fhir.default_encoding=xml hapiproject/hapi:latest

支持的环境变量对应 application.yaml 中的配置项，可参考 配置文件。

通过自定义 YAML 文件配置

1. 准备配置文件
   创建本地配置文件（如 custom-application.yaml），修改所需配置（如数据库连接）。

2. 挂载配置文件启动
   使用 -v 参数挂载本地配置文件到容器，并通过 SPRING_CONFIG_LOCATION 指定配置路径：

   bash
   docker run -p 8080:8080 \
     -v $(pwd)/custom-application.yaml:/configs/application.yaml \
     -e SPRING_CONFIG_LOCATION=file:///configs/application.yaml \
     hapiproject/hapi:latest
   

Docker Compose 部署

创建 docker-compose.yml 文件，示例配置如下（包含 MySQL 数据库）：

yaml
version: '3.7'
services:
  web:
    image: "hapiproject/hapi:latest"
    ports:
      - "8090:8080"
    environment:
      SPRING_CONFIG_LOCATION: 'file:///data/hapi/application.yaml'
    volumes:
      - hapi-data:/data/hapi
    depends_on:
      - mysql
  mysql:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: hapi
      MYSQL_USER: admin
      MYSQL_PASSWORD: admin
    volumes:
      - mysql-data:/var/lib/mysql
volumes:
  hapi-data:
    external: true
  mysql-data:
    external: true

启动服务：

bash
docker-compose up -d

数据库配置

MySQL 配置

修改配置文件，替换默认 H2 数据库为 MySQL：

yaml
spring:
  datasource:
    url: 'jdbc:mysql://mysql:3306/hapi'  # 容器内访问 MySQL 服务名（如 docker-compose 中的 mysql）
    username: admin
    password: admin
    driverClassName: com.mysql.jdbc.Driver
  jpa:
    hibernate:
      physical_naming_strategy: org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl

注意：MySQL 容器需设置 lower_case_table_names=1 以避免大小写敏感问题。

PostgreSQL 配置

配置文件示例：

yaml
spring:
  datasource:
    url: 'jdbc:postgresql://postgresql:5432/hapi'
    username: admin
    password: admin
    driverClassName: org.postgresql.Driver

高级功能配置

Elasticsearch 集成

启用 Elasticsearch 用于索引和搜索：

yaml
elasticsearch:
  enabled: true
  rest_url: elasticsearch:9200  # Elasticsearch 服务地址
  username: elastic
  password: changeme
  protocol: http
  required_index_status: YELLOW
  schema_management_strategy: CREATE

订阅功能（Subscriptions）

在配置文件中启用订阅：

yaml
hapi:
  fhir:
    subscription:
      resthook_enabled: true  # 启用 REST Hook 订阅
      ***
        enabled: true  # 启用邮件订阅
        host: smtp.example.com
        port: 587
        username: ***
        password: password

MDM（主数据管理）

启用 MDM 并配置匹配规则：

yaml
hapi:
  fhir:
    mdm_enabled: true  # 启用 MDM

MDM 匹配规则通过 src/main/resources/mdm-rules.json 配置，需根据实际数据需求自定义规则。

CQL 支持

启用 CQL 执行功能：

yaml
hapi:
  fhir:
    cql_enabled: true

轻量级 Distroless 镜像

为减小镜像体积并提升安全性，可构建基于 Distroless 的镜像变体：

bash
docker build --target=release-distroless -t hapi-fhir:distroless .

Distroless 镜像已自动发布到 Docker Hub，标签格式为 hapiproject/hapi:<版本>-distroless。

常见问题

如何修改缓存搜索结果时间？

默认缓存时间为 6000 毫秒，可通过配置文件调整：

yaml
hapi:
  fhir:
    reuse_cached_search_results_millis: 3000  # 设置为 3 秒
    # reuse_cached_search_results_millis: -1  # 禁用缓存

如何启用 $lastn 操作？

需同时启用 Elasticsearch 和 LastN：

yaml
hapi:
  fhir:
    lastn_enabled: true
elasticsearch:
  enabled: true  # 依赖 Elasticsearch

如何自定义 Web UI？

Web UI 基于 Thymeleaf 模板，可通过修改 src/main/webapp/WEB-INF/templates 目录下的模板文件自定义界面。