医疗应用合规部署难题？Medplum全流程安装配置指南-CSDN博客

医疗应用合规部署难题？Medplum全流程安装配置指南

[【免费下载链接】medplum Medplum is a healthcare platform that helps you quickly develop high-quality compliant applications. 项目地址: https://gitcode.com/GitHub_Trending/me/medplum](https://link.gitcode.com/i/899e6538e4892ef23e6c9efd83b2bc16?uuid_tt_dd=10_19420766220-1781765820785-850771&isLogin=1&from_id=147062043 “【免费下载链接】medplum”)

开篇：为什么选择Medplum？

医疗健康应用开发面临三大核心挑战：合规性（HIPAA、FHIR标准）、数据安全（患者隐私保护）、开发效率（快速迭代与集成）。Medplum作为开源医疗平台，通过集成FHIR服务器、认证系统、React组件库和Bots自动化工具，为开发者提供一站式解决方案。本文将带你从环境准备到生产部署，全程攻克Medplum的安装配置难关，2小时内完成合规医疗应用的基础设施搭建。

读完本文你将掌握：

开发/生产环境的差异化部署方案
Docker容器化部署的最佳实践
FHIR服务器初始化与数据迁移技巧
多环境变量配置与安全管理
常见故障排查与性能优化策略

1. 项目架构与系统要求

1.1 核心组件架构

mermaid

1.2 环境要求矩阵

环境类型	操作系统	Node.js	npm	Docker	PostgreSQL	Redis
开发环境	Linux/macOS	20.19.0+	10.9.3+	20.10+	16+	7+
生产环境	Linux	22.12.0+	10.9.3+	24.0+	16+（集群）	7+（集群）

⚠️ 警告：Windows系统需启用WSL2，不支持直接部署

2. 开发环境部署（本地模式）

2.1 环境准备

1
2
3
4
5
6
7


git clone https://gitcode.com/GitHub_Trending/me/medplum.git

cd medplum

sudo apt update && sudo apt install -y docker.io docker-compose nodejs npm

sudo systemctl enable --now docker

2.2 数据库与缓存服务

1
2
3


docker-compose up -d

docker-compose ps

2.3 项目初始化

1
2
3
4
5
6
7


npm install

npm run build

npm run seed

npm run dev

2.4 环境变量配置

创建.env文件（参考examples/medplum-hello-world/.env.defaults）：

1

# 基础配置 MEDPLUM_BASE_URL=http://localhost:8103 NODE_ENV=development # 数据库连接 POSTGRES_HOST=localhost POSTGRES_PORT=5432 POSTGRES_USER=medplum POSTGRES_PASSWORD=medplum POSTGRES_DB=medplum # Redis配置 REDIS_HOST=localhost REDIS_PORT=6379 REDIS_PASSWORD=medplum

3. 生产环境部署（容器化方案）

3.1 部署架构图

mermaid

3.2 Docker部署流程

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21


npm run build:docker

export MEDPLUM_BASE_URL=https://api.yourdomain.com

export POSTGRES_HOST=prod-postgres.yourdomain.com

export REDIS_HOST=prod-redis.yourdomain.com

docker run -d \

--name medplum-server \

-p 8103:8103 \

-e NODE_ENV=production \

-e MEDPLUM_BASE_URL=$MEDPLUM_BASE_URL \

-e POSTGRES_HOST=$POSTGRES_HOST \

medplum/server:latest

3.3 前端应用部署

1
2
3
4
5


cd packages/app

npm run build

aws s3 sync dist/ s3://your-app-bucket/ --cache-control "public, max-age=31536000"

4. 配置验证与功能测试

4.1 服务健康检查

1
2
3


curl -X GET https://api.yourdomain.com/health

curl -X GET https://api.yourdomain.com/fhir/Patient

4.2 示例应用运行

1
2
3
4
5


cd examples/medplum-hello-world

npm install

npm run dev

4.3 功能测试清单

用户注册与登录（OAuth/SMART-on-FHIR）
患者资源创建（POST /Patient）
数据搜索功能（GET /Patient?name=Smith）
Bots自动化触发（创建资源后执行规则）
文件上传（POST /Binary）

5. 高级配置与优化

5.1 环境变量优先级

Medplum按以下顺序加载配置（优先级从高到低）：

命令行参数 --medplum-base-url=https://...
系统环境变量 export MEDPLUM_BASE_URL=...
.env.local 文件
.env 文件
内置默认值

5.2 性能优化参数

1

# 服务器性能调优 NODE_OPTIONS=--max-old-space-size=8192 MEDPLUM_WORKERS=4 # CPU核心数的1.5倍 # 数据库连接池 DB_POOL_SIZE=20 DB_CONNECTION_TIMEOUT=30000 # 缓存策略 REDIS_CACHE_TTL=3600 # 缓存1小时

6. 常见问题与故障排除

6.1 数据库连接失败

错误：Error connecting to PostgreSQL: Connection refused

解决方案：

检查Postgres容器状态：docker-compose logs postgres
验证网络连通性：telnet postgres-host 5432
确认凭据正确性：echo $POSTGRES_PASSWORD

6.2 前端资源加载404

1

错误：Failed to load resource: net::ERR_ABORTED 404