个人健康档案管理工具MediKeep

杨浦老苏

425人浏览 · 2026-03-20 12:14:27

杨浦老苏 · 2026-03-20 12:14:27 发布

在这里插入图片描述

简介

什么是 MediKeep？

MediKeep 是一个开源的个人健康档案管理工具，基于 React 前端和 FastAPI 后端构建。它可以帮助用户集中管理个人医疗记录、追踪用药情况、生成健康报告，并与医疗机构共享数据。

主要特点

病历管理：集中存储和管理个人医疗记录，包括诊断、检查报告、处方等
用药追踪：记录和管理所有药物信息，包括剂量、服药时间和用药计划
报告生成：内置报告构建器，支持自定义健康报告并导出与医疗机构共享
数据备份：支持通过管理后台或 CLI 工具进行数据备份与恢复
SSO 支持：可选集成 Google、GitHub 等 SSO 登录（OIDC 也支持）
开源免费：基于自定义协议开源，可免费使用和部署

应用场景

个人健康记录管理：将分散在各处的病历、检查报告、处方等集中数字化管理
用药提醒与追踪：记录家庭成员的用药情况，方便按时服药和管理药品库存
就医资料准备：生成结构化的健康报告，快速提供给医生参考
家庭健康管理：一个账号管理全家人的健康档案

总的来说，MediKeep 是一个功能完整的个人健康档案管理平台，适合希望数字化管理自己和家人医疗记录的用户。

安装

在群晖上以 Docker 方式安装。

本文写作时， latest 版本对应为 v0.58.0；

docker-compose 安装

MediKeep 采用多容器架构，包含 PostgreSQL 数据库和 FastAPI 应用服务。由于镜像托管在 ghcr.io，建议通过 docker-compose 进行部署。

1. 创建目录

在 docker 文件夹中创建一个新文件夹 medikeep 及子目录，并进入目录：

# 新建文件夹 medikeep 和 子目录
mkdir -p /volume1/docker/medikeep/{backups,logs,postgres,uploads}

# 进入 medikeep 目录
cd /volume1/docker/medikeep

2. docker-compose.yml

可以从 GitHub 下载官方配置文件自己修改

curl -sO https://raw.githubusercontent.com/afairgiant/MediKeep/main/docker/docker-compose.yml

也可以直接保存老苏修改后的 docker-compose.yml

services:
  # PostgreSQL Database Service
  postgres:
    image: postgres:15.8-alpine
    container_name: medical-records-db
    restart: unless-stopped
    environment:
      POSTGRES_DB: medical_records
      POSTGRES_USER: medapp
      POSTGRES_PASSWORD: medikeep
    volumes:
      - ./postgres:/var/lib/postgresql/data
    #   - ./init.sql:/docker-entrypoint-initdb.d/init.sql:ro
    #  ports:
    #   - '5432:5432'
    healthcheck:
      test:
        [
          'CMD-SHELL',
          'pg_isready -U ${DB_USER:-medapp} -d ${DB_NAME:-medical_records}',
        ]
      interval: 10s
      timeout: 5s
      retries: 5

  # Combined Frontend + Backend Application Service
  medical-records-app:
    image: ghcr.io/afairgiant/medikeep:latest
    container_name: medical-records-app
    restart: unless-stopped
    ports:
      - 8015:8000 # Single port serves both React app and FastAPI
    environment:
      DB_HOST: postgres
      DB_PORT: 5432
      DB_NAME: medical_records
      DB_USER: medapp
      DB_PASSWORD: medikeep
      SECRET_KEY: rR9EbERNMGXTB9PrdRx2qwZbxjvLZHco
      TZ: Asia/Shanghai
      LOG_LEVEL: INFO
      #PUID: ${PUID} # Enable if using bind mounts
      #PGID: ${PGID} # Enable if using bind mounts

      # SSL Configuration - set ENABLE_SSL=true in .env to enable HTTPS - Uncomment if needed
      #ENABLE_SSL: ${ENABLE_SSL:-false}
      # SSO Configuration (Optional) - SSO is disabled by default
      SSO_ENABLED: 'false'
      #SSO_PROVIDER_TYPE: ${SSO_PROVIDER_TYPE:-oidc}
      #SSO_CLIENT_ID: ${SSO_CLIENT_ID:-}
      #SSO_CLIENT_SECRET: ${SSO_CLIENT_SECRET:-}
      #SSO_ISSUER_URL: ${SSO_ISSUER_URL:-}
      #SSO_REDIRECT_URI: ${SSO_REDIRECT_URI:-}
      #SSO_ALLOWED_DOMAINS: ${SSO_ALLOWED_DOMAINS:-[]}

    volumes:
      - ./uploads:/app/uploads
      - ./logs:/app/logs
      - ./backups:/app/backups
      # Uncomment the line below and create certificates if you want HTTPS
      # - ./certs:/app/certs:ro
    depends_on:
      postgres:
        condition: service_healthy
    healthcheck:
      test: ['CMD', 'curl', '-f', 'http://localhost:8000/health']
      interval: 30s
      timeout: 10s
      retries: 3

3. 启动容器

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

docker-compose.yml 环境变量配置说明：

postgres 容器

环境变量	值/来源	描述
`POSTGRES_DB`	`medical_records`	数据库名称
`POSTGRES_USER`	`medapp`	数据库用户
`POSTGRES_PASSWORD`	`medikeep`	数据库密码

medical-records-app 容器

环境变量	值/来源	描述
`DB_HOST`	postgres	数据库主机
`DB_PORT`	5432	数据库端口
`DB_NAME`	medical_records	数据库名称
`DB_USER`	medapp	数据库用户
`DB_PASSWORD`	medikeep	数据库密码
`SECRET_KEY`	rR9EbERNMGXTB9PrdRx2qwZbxjvLZHco	应用密钥
`TZ`	Asia/Shanghai	时区设置
`LOG_LEVEL`	INFO	日志级别
`PUID`	${PUID}	用户ID（可选，bind mount用）
`PGID`	${PGID}	进程组ID（可选，bind mount用）
`ENABLE_SSL`	${ENABLE_SSL:-false}	SSL启用（注释中，可选）
`SSO_ENABLED`	‘false’	SSO功能开关
`SSO_PROVIDER_TYPE`	${SSO_PROVIDER_TYPE:-oidc}	SSO提供商类型（可选）
`SSO_CLIENT_ID`	${SSO_CLIENT_ID:-}	SSO客户端ID（可选）
`SSO_CLIENT_SECRET`	${SSO_CLIENT_SECRET:-}	SSO客户端密钥（可选）
`SSO_ISSUER_URL`	${SSO_ISSUER_URL:-}	SSO发行者URL（可选）
`SSO_REDIRECT_URI`	${SSO_REDIRECT_URI:-}	SSO重定向URI（可选）
`SSO_ALLOWED_DOMAINS`	${SSO_ALLOWED_DOMAINS:-[]}	SSO允许域名（可选）