snomedinternational/snowstorm

Snowstorm 镜像文档

概述

Snowstorm是一款开源术语服务器，专为SNOMED CT提供增强支持，基于Elasticsearch构建，以高性能和企业级可扩展性为核心设计目标。该服务器提供双API架构，支持多种术语系统管理与查询，并由社区提供支持（SNOMED International不提供商业支持）。

核心功能与特性

双API架构

• HL7 FHIR API（推荐）
  • 实现HL7 FHIR术语模块
  • 支持SNOMED CT、LOINC、ICD-10、ICD-10-CM等多种代码系统
  • 推荐给术语服务实现者使用，提供标准化接口
• SNOMED CT专用API
  • 支持SNOMED CT代码系统管理
  • 为SNOMED CT浏览器提供后端支持
  • 支持SNOMED CT版本创作功能

关键特性

• 基于Elasticsearch的分布式架构，支持横向扩展
• 多语言内容检索与搜索能力
• 完全兼容ECL v2.0查询语言
• 完整历史记录支持（需导入完整RF2数据）
• 支持多版本扩展与国际版SNOMED CT并行托管

使用场景

面向实现者

SNOMED International建议通过标准化接口（如HL7 FHIR API）使用术语服务，Snowstorm适合以下团队：

• 刚起步的SNOMED CT实施团队
• 具备术语管理和技术支持能力的团队
• 需要松散耦合架构的应用系统

注：如需商业支持，可参考Snomed International推荐的其他术语服务器

SNOMED CT浏览器支持

为SNOMED International浏览器提供API支持，包括国际版及14个国家版本，本地部署可实现：

• 国际版与多扩展版本并行托管
• 多语言搜索与内容检索
• ECL v2.0标准查询
• 只读FHIR API访问

创作平台支持

作为SNOMED International创作平台的后端服务，用于维护：

• 国际版SNOMED CT
• 9个国家版本
• 多个社区扩展内容

使用方法

Docker快速部署

前提条件

• 安装Docker Engine（20.10+）
• 安装Docker Compose（可选，推荐用于多容器管理）

基本部署步骤

1. 拉取镜像

bash
docker pull docker.xuanyuan.run/snomedinternational/snowstorm

2. 单容器运行（需外部Elasticsearch）

bash
docker run -d \
  --name snowstorm \
  -p 8080:8080 \
  -e elasticsearch.url=http://<elasticsearch-host>:9200 \
  docker.xuanyuan.run/snomedinternational/snowstorm

3. Docker Compose部署（含Elasticsearch） 创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  elasticsearch:
    image: ***-elastic.xuanyuan.run/elasticsearch/elasticsearch:7.14.0
    environment:
      - discovery.type=single-node
      - "ES_JAVA_OPTS=-Xms2g -Xmx2g"
    ports:
      - "9200:9200"
    volumes:
      - esdata:/usr/share/elasticsearch/data
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9200/_cluster/health"]
      interval: 10s
      timeout: 10s
      retries: 5

  snowstorm:
    image: docker.xuanyuan.run/snomedinternational/snowstorm
    depends_on:
      elasticsearch:
        condition: service_healthy
    environment:
      - elasticsearch.url=http://elasticsearch:9200
      - server.port=8080
    ports:
      - "8080:8080"
    restart: unless-stopped

volumes:
  esdata:

启动服务：

bash
docker-compose up -d

服务启动后可通过http://localhost:8080访问API端点。

配置说明

核心配置参数

通过环境变量或配置文件设置，关键参数包括：

• elasticsearch.url: Elasticsearch服务地址（默认：http://localhost:9200）
• server.port: 服务端口（默认：8080）
• snowstorm.rest-api.readonly: 只读模式开关（默认：false）

安全配置

• 支持基础认证与OAuth2集成，详见安全配置指南
• 推荐通过Nginx配置SSL终端，参考nginx-setup.md

数据加载与管理

SNOMED CT数据导入

1. 准备RF2格式的SNOMED CT数据
2. 通过专用API或命令行工具执行导入
3. 支持增量更新与多版本管理

详细步骤参见Loading SNOMED CT content

相关文档

• 快速开始（基础安装）
• 配置指南
• FHIR API使用说明
• SNOMED CT专用API使用说明