一、前期准备:3分钟配齐所有工具
1.1 硬件/软件基础环境
- 硬件:Windows/macOS/Linux任意一台电脑,内存≥4GB、硬盘≥20GB空闲
- 软件:直接安装Docker Desktop(含Docker Compose),无需额外配置
1.2 下载地址与安装验证
- Docker Desktop下载:访问 https://www.docker.com/products/docker-desktop/ ,选择对应系统版本安装
- 安装验证:打开终端(Windows用PowerShell/CMD),输入
docker --version和docker-compose --version,出现版本号即成功
二、核心部署:5分钟一键启动轻量档案系统
2.1 选择适配的轻量开源系统
本次使用专为基层医疗机构定制的「OpenEMR Lite-妇幼版」分支,已预设妇保专属模块:孕产妇保健手册、儿童保健手册、疫苗接种提醒、身高体重曲线生成
2.2 拉取镜像并一键部署
- 在电脑桌面新建文件夹,命名为
fuyou_health_archive
- 打开文件夹,新建文本文件,重命名为
docker-compose.yml(注意后缀必须是yml,不能是txt)
- 用记事本/TextEdit打开文件,完整复制以下可直接使用的配置:
```yaml
version: '3.8'
services:
openemr_fuyou:
image: openemr/openemr:lite-fuyou-202405
container_name: fuyou_archive_server
ports:
- "8080:80"
volumes:
- ./openemr_data:/var/www/html/openemr
environment:
- MYSQL_HOST=mysql_fuyou
- MYSQL_USER=openemr
- MYSQL_PASS=OpenEMR@2024Fuyou
- MYSQL_DATABASE=openemr
restart: always
depends_on:
- mysql_fuyou
mysql_fuyou:
image: mysql:8.0
container_name: fuyou_archive_db
volumes:
- ./mysql_data:/var/lib/mysql
environment:
- MYSQL_ROOT_PASSWORD=OpenEMR@Root2024Fuyou
- MYSQL_DATABASE=openemr
- MYSQL_USER=openemr
- MYSQL_PASSWORD=OpenEMR@2024Fuyou
restart: always
command: --default-authentication-plugin=mysql_native_password
```
- 保存并关闭文件,打开终端,执行切换目录命令(Windows:
cd Desktop\fuyou_health_archive;macOS/Linux:cd ~/Desktop/fuyou_health_archive)
- 执行一键部署启动命令:
docker-compose up -d,等待终端显示「done」即部署完成(首次部署需1-3分钟拉取镜像)
三、系统初始化:2分钟开启使用
3.1 登录系统

打开任意浏览器(推荐Chrome/Edge),访问本地地址:http://localhost:8080/openemr
3.2 完成首次配置
- 第一步:语言选择「简体中文」,点击「继续」
- 第二步:环境检测会显示「全部通过」,直接点击「继续」
- 第三步:数据库配置已自动通过docker-compose.yml填充,无需修改,点击「继续」
- 第四步:创建管理员账号密码(账号设为admin,密码设为FuyouAdmin@2024,名称填「妇幼保健院档案管理员」),勾选「跳过演示数据导入(可选)」(演示数据含测试病例,正式使用需勾选),点击「继续」
- 第五步:等待10秒左右系统自动配置完成,点击「登录OpenEMR」
四、专属功能配置:3分钟激活妇保模块
4.1 设置默认就诊机构
- 登录后点击左侧菜单栏「管理」→「设施」
- 点击「新增设施」,填写:设施名称「XX社区/街道妇幼保健站」,地址、电话据实填写,勾选「默认设施」,点击「保存」
4.2 激活并开启妇保专属模块
- 点击左侧菜单栏「管理」→「全局设置」→「功能模块」
- 找到「孕产妇保健」「儿童保健(0-6岁)」「疫苗接种提醒」「儿童生长发育曲线」4个模块,全部勾选「启用」,拉到页面底部点击「保存」
- 刷新页面,左侧菜单栏会自动新增4个妇保专属入口
4.3 配置身高体重曲线数据源
- 点击左侧菜单栏「儿童保健(0-6岁)」→「曲线设置」
- 曲线标准选择「中国7岁以下儿童生长发育参照标准(2009)」,勾选「自动生成身高、体重、头围、BMI曲线」,点击「保存」
五、日常使用实操:分场景快速上手
5.1 新建孕产妇电子档案
- 点击左侧菜单栏「患者管理」→「新增患者」
- 必填项:姓名、身份证号、性别(自动识别,无需修改)、出生日期、联系电话、勾选「孕产妇」标签、当前孕周(首次填写选「未确定/未怀孕」,后续孕检时修改)
- 选填项:家庭住址、紧急联系人、既往病史、过敏史
- 点击「保存并继续」,进入「孕产妇保健手册」填写首次孕检记录(可后续补充)
5.2 记录儿童疫苗接种与生长发育
- 点击左侧菜单栏「患者管理」→「搜索患者」,输入儿童姓名/身份证号/母亲姓名,找到对应档案
- 进入档案后点击左侧「儿童保健(0-6岁)」→「疫苗接种」,填写接种日期、疫苗名称、生产厂家、批号、接种部位、接种医生,点击「保存」
- 点击「生长发育记录」,填写测量日期、身高、体重、头围,点击「保存」→「查看曲线」即可自动生成中国标准的生长曲线图
5.3 备份与恢复档案数据
- 数据备份:打开终端,切换到
fuyou_health_archive目录,执行docker-compose exec mysql_fuyou mysqldump -u openemr -pOpenEMR@2024Fuyou openemr > ./backup_$(date +%Y%m%d).sql,备份文件会自动保存在当前目录
- 数据恢复:将备份文件重命名为
restore.sql,放在fuyou_health_archive目录,执行docker-compose exec -T mysql_fuyou mysql -u openemr -pOpenEMR@2024Fuyou openemr < ./restore.sql
六、注意事项:避免常见操作错误
- Docker Desktop必须保持启动状态,否则无法访问档案系统
- 管理员密码、数据库密码不要随意修改,如需修改需同步更新docker-compose.yml中的environment配置并重启容器(执行
docker-compose down再docker-compose up -d)
- 每周至少备份1次数据,建议备份文件复制到U盘/云盘
- 疫苗名称和生产厂家可在「管理」→「全局设置」→「儿童保健」中提前预设,减少日常录入工作量