Tidepool Platform Docker镜像文档

1. 镜像概述

Tidepool Platform Docker镜像是基于开源项目Tidepool Platform构建的容器化部署方案，旨在简化糖尿病数据管理平台的部署与运维。该镜像封装了平台核心组件，包括数据处理服务、API接口和设备集成模块，提供开箱即用的糖尿病数据管理能力，支持跨环境一致部署。

2. 核心功能与特性

2.1 核心功能

• 多源数据集成：支持主流血糖仪、胰岛素泵、动态血糖监测系统（CGM）等设备数据导入，兼容Dexcom、Medtronic、Abbott等品牌设备数据格式
• 数据管理中枢：提供结构化数据存储、标准化数据清洗及多维度数据索引，支持历史数据查询与趋势分析
• 开放API服务：内置RESTful API接口，支持第三方应用（如电子健康记录系统、科研工具）集成与数据交互
• 数据安全机制：实现数据加密存储与访问权限控制，符合医疗数据隐私保护规范

2.2 镜像特性

• 轻量化部署：基于Alpine Linux构建，镜像体积优化，启动速度快
• 配置灵活：通过环境变量实现参数动态配置，支持开发/测试/生产多环境切换
• 持久化存储：支持数据卷挂载，确保服务重启后数据不丢失
• 开源可扩展：基于MIT许可证，源码完全开放，支持功能定制与二次开发

3. 使用场景与适用范围

3.1 主要使用场景

• 医疗机构：用于糖尿病患者数据集中管理，支持临床决策与随访跟踪
• 科研机构：为糖尿病流行病学研究、药物效果评估提供标准化数据采集与分析工具
• 患者自我管理：辅助糖尿病患者整合多设备数据，实现血糖趋势可视化与健康状况监测
• 第三方开发：作为数据中台支撑糖尿病管理类应用开发，降低设备集成与数据处理门槛

3.2 适用群体

• 内分泌科医护人员
• 糖尿病相关科研人员
• 慢性病管理应用开发者
• 需要整合多设备数据的糖尿病患者

4. 使用方法与配置说明

4.1 前置要求

• Docker Engine 19.03及以上版本
• Docker Compose 1.27及以上版本（推荐）
• 最低硬件配置：2核CPU、2GB内存、20GB可用磁盘空间

4.2 基础部署流程

4.2.1 单机快速启动

docker run -d \
  --name tidepool-platform \
  -p 8080:8080 \
  -e TIDEPOOL_ENV=production \
  -e MONGO_URI=mongodb://mongo-host:27017/tidepool \
  -v tidepool-data:/app/data \
  tidepool/platform:latest

4.2.2 Docker Compose部署（推荐）

创建docker-compose.yml配置文件：

version: '3.8'
services:
  tidepool:
    image: tidepool/platform:latest
    container_name: tidepool-service
    restart: unless-stopped
    ports:
      - "8080:8080"  # API服务端口
      - "8081:8081"  # 管理界面端口
    environment:
      - TIDEPOOL_ENV=production
      - MONGO_URI=mongodb://mongodb:27017/tidepool
      - API_PORT=8080
      - ADMIN_PORT=8081
      - LOG_LEVEL=info
      - CORS_ALLOWED_ORIGINS=[***]
    volumes:
      - tidepool-data:/app/data  # 应用数据持久化
      - ./config:/app/config     # 自定义配置文件挂载（可选）  
    depends_on:
      - mongodb

  mongodb:
    image: mongo:5.0
    container_name: tidepool-mongo
    restart: unless-stopped
    volumes:
      - mongo-data:/data/db
    environment:
      - MONGO_INITDB_ROOT_USERNAME=tidepool-admin
      - MONGO_INITDB_ROOT_PASSWORD=${MONGO_PASSWORD}  # 建议通过环境变量注入密码

volumes:
  tidepool-data:
  mongo-data:

启动服务：

# 如需设置MongoDB密码，可通过环境变量传入
export MONGO_PASSWORD=your-secure-password
docker-compose up -d

4.3 核心配置参数

4.4 数据持久化配置

• 核心数据卷：tidepool-data卷存储应用配置、设备映射规则及临时处理文件
• 数据库卷：mongo-data卷存储原始数据与索引，建议定期通过mongodump工具备份

5. 注意事项

• 生产环境安全：

  • 必须修改默认MongoDB密码并启用身份验证
  • 限制CORS_ALLOWED_ORIGINS为可信域名，避免跨域安全风险
  • 通过反向代理（如Nginx）配置HTTPS加密传输

• 性能优化：

  • 数据量超过10万条时，建议单独部署MongoDB集群并配置索引优化
  • 高并发场景下，可通过水平扩展API服务节点实现负载均衡

• 许可证要求：

  • 基于MIT许可证分发，使用时需保留原始版权声明
  • 二次开发后分发需公开修改部分源码（如适用）