sparkfhir/spark

Spark FHIR Server 镜像文档

1. 概述

Spark FHIR Server 是一个开源的数据服务器，基于HL7 FHIR（Fast Healthcare Interoperability Resources）标准构建，旨在提供标准化的保健资源（如患者、诊断、处方等）存储、查询、交换和管理能力，支持信息系统间的数据互操作，促进数据的标准化共享与利用。

2. 核心功能与特性

• FHIR标准兼容：支持HL7 FHIR R4/R5等主流版本，完全符合FHIR资源模型规范，确保***数据结构标准化。
• 多模式数据存储：支持内存存储（测试环境）、关系型数据库（PostgreSQL/MySQL）及NoSQL数据库（MongoDB），适配不同部署需求。
• 强大查询能力：支持FHIR标准查询参数（_search、_include、_revinclude）、链式查询及复杂过滤条件，满足***数据精细化检索需求。
• 完整API支持：提供RESTful FHIR API，支持资源的CRUD操作、事务处理（transaction/batch）及历史数据版本管理。
• 安全合规特性：集成身份认证（OAuth2/OpenID Connect）、基于角色的访问控制（RBAC），支持HIPAA***数据隐私合规要求。
• 可扩展性：支持自定义FHIR扩展、术语系统集成（SNOMED CT、LOINC）及事件通知机制，适应个性化业务场景。

3. 使用场景与适用范围

• 信息系统集成：作为中间件连接电子健康记录（EHR）、实验室信息系统（LIS）等，实现跨系统数据标准化交换。
• 区域健康信息交换：为健康信息交换组织（HIE）提供数据中枢，支持***机构间患者数据共享与协同诊疗。
• 数据分析平台：作为标准化数据接口，为临床研究、公共卫生监测及质量分析系统提供结构化***数据访问能力。
• 移动应用后端**：为医患端移动应用提供FHIR资源存储与查询服务，支持远程**数据交互。

4. 使用方法与配置说明

4.1 快速启动（Docker Run）

通过以下命令快速部署基础版服务（适合测试环境）：

bash
docker run -d \
  --name spark-fhir-server \
  -p 8080:8080 \
  -e FHIR_VERSION=R4 \
  -e STORAGE_TYPE=in-memory \
  healthsamurai/spark-fhir-server:latest

参数说明：

• -p 8080:8080：映射容器8080端口至主机，用于访问FHIR API端点
• -e FHIR_VERSION=R4：指定FHIR版本（支持R4/R5，默认R4）
• -e STORAGE_TYPE=in-memory：启用内存存储（数据非持久化，重启后丢失）

4.2 生产环境部署（持久化存储）

使用PostgreSQL数据库实现数据持久化部署：

bash
docker run -d \
  --name spark-fhir-server \
  -p 8080:8080 \
  -e FHIR_VERSION=R4 \
  -e STORAGE_TYPE=postgresql \
  -e DB_URL=jdbc:postgresql://db-host:5432/fhirdb \
  -e DB_USER=fhirdbuser \
  -e DB_PASSWORD=SecurePass123! \
  -v ./conf:/app/conf \  # 挂载自定义配置文件
  healthsamurai/spark-fhir-server:latest

核心环境变量说明：

4.3 Docker Compose 完整部署示例

创建docker-compose.yml实现服务与数据库一体化部署：

yaml
version: '3.8'
services:
  fhir-server:
    image: healthsamurai/spark-fhir-server:latest
    container_name: spark-fhir
    ports:
      - "8080:8080"
    environment:
      - FHIR_VERSION=R4
      - STORAGE_TYPE=postgresql
      - DB_URL=jdbc:postgresql://postgres:5432/fhirdb
      - DB_USER=postgres
      - DB_PASSWORD=postgres
      - AUTH_ENABLED=true
      - AUTH_TYPE=basic
      - BASIC_AUTH_USER=admin
      - BASIC_AUTH_PASSWORD=AdminPass123!
    depends_on:
      - postgres
    restart: unless-stopped
    volumes:
      - fhir-logs:/app/logs  # 日志持久化

  postgres:
    image: postgres:14-alpine
    container_name: fhir-db
    environment:
      - POSTGRES_DB=fhirdb
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
    volumes:
      - postgres-data:/var/lib/postgresql/data  # 数据库数据持久化
    restart: unless-stopped

volumes:
  postgres-data:
  fhir-logs:

启动命令：docker-compose up -d

4.4 服务验证

部署完成后，通过访问以下端点验证服务状态：

• 服务元数据：http://localhost:8080/fhir/metadata（返回FHIR能力声明文档）
• 患者资源示例查询：http://localhost:8080/fhir/Patient（返回患者资源列表，初始为空）

5. 安全配置

• 基础认证：通过AUTH_TYPE=basic启用，配置BASIC_AUTH_USER和BASIC_AUTH_PASSWORD
• OAuth2认证：设置AUTH_TYPE=oauth2及OAUTH2_ISSUER_URL（如Keycloak认证服务器地址）
• HTTPS启用：挂载SSL证书至容器/app/certs目录，设置HTTPS_ENABLED=true及证书路径环境变量

6. 参考资源

• 官方文档：[***]
• FHIR标准规范：[***]
• GitHub代码仓库：https://github.com/HealthSamurai/spark