OpenEMR 快速上手教程
OpenEMR 上手建议先用 Docker 跑通一个本地实例，再按"注册患者 → 建预约 → 录病历 → 开处方 → 看账单"这条门诊主线熟悉系统。
1. 最推荐的运行方式：Docker
OpenEMR 官方提供了 openemr/openemr 镜像和 docker/ 目录下的 Compose 配置，适合快速体验。
# 方式一：直接拉镜像运行
docker pull openemr/openemr:latest
docker run -d --name openemr -p 80:80 openemr/openemr
# 方式二：用 Docker Compose（推荐，含数据库）
git clone https://github.com/openemr/openemr.git
cd openemr/docker
docker compose up -d启动后访问：
http://localhost
# 或 http://localhost:80，具体端口以 compose 文件为准首次访问会进入 Web 安装向导，按提示创建数据库和管理员账号即可。
2. 源码/本地部署路线
如果你想在 macOS 或 Linux 上直接跑源码，需要：
- PHP 7.4+（推荐 8.1+）
- MySQL 5.7+ 或 MariaDB 10.2+
- Apache 或 Nginx
- Node.js（构建前端资源时需要）
- Composer
大致流程：
git clone https://github.com/openemr/openemr.git
cd openemr
composer install --no-dev
npm install
npm run build
composer dump-autoload -o然后把项目放到 Web 服务器根目录，访问安装向导完成数据库和管理员配置。
3. 安装向导里重点看这些
OpenEMR 安装向导通常会让你完成：
- 环境检查
- 选择创建数据库
- 设置数据库账号密码
- 设置 OpenEMR 管理员账号
- 选择主题
- 记录初始登录信息
完成后用管理员账号登录即可。
4. 登录后先跑通门诊主流程
按这个顺序体验最直观：
- Patients → Add New Patient：注册第一个患者，填姓名、性别、出生日期、联系方式。
- Calendar：给患者建一个预约，理解排班视图。
- Patients → 选择患者 → Encounters：开始一次就诊。
- Vitals：录入体温、血压、身高、体重。
- Diagnosis：添加诊断，例如 ICD 编码。
- Prescriptions：开处方，查看药品和用药说明。
- Billing：查看账单、保险信息、费用记录。
- Reports：跑一个简单报表，看数据是否已沉淀。
5. 几个关键入口
| 入口 | 作用 |
|---|---|
| Patients | 患者档案、搜索、新建 |
| Calendar | 预约、排班、医生日程 |
| Encounters | 就诊记录、病历、诊断、处方 |
| Fee Sheet / Billing | 费用、账单、保险申报 |
| Administration | 用户、角色、表单、全局配置 |
| Reports | 临床报表、运营统计 |
6. 二次开发可以这样走
- 先用 Docker 跑通标准实例。
- 再读
interface/目录，理解患者、就诊、处方、账单入口。 - 看
interface/forms/，了解如何新增临床表单。 - 研究 FHIR / REST API，用于对接移动端或第三方系统。
- 最后再碰权限、模块、报表和专科表单。
7. 常见坑
- 默认账号密码不要沿用：安装完成后立刻修改管理员密码。
- 端口可能不是 80：Compose 文件里可能映射到 8080、8090 等，以实际配置为准。
- 不要直接当国内 HIS 用：医保、电子病历评级、院内流程需要大量本地化。
- 生产环境要配 HTTPS：医疗数据敏感，至少做到内网 HTTPS + 定期备份。
- 源码构建需要 Node 和 Composer：只拉代码不构建，前端资源可能不完整。