pre-openemr 镜像技术文档

1. 镜像概述和主要用途

pre-openemr 是 OpenEMR 演示环境（demo farm）的专用基础镜像，旨在为 OpenEMR 应用提供标准化、可复用的底层运行环境。该镜像基于不同版本的 Ubuntu 或 Alpine Linux 构建，预配置了运行 OpenEMR 所需的基础依赖，适用于快速部署 OpenEMR 演示实例、开发测试环境或教学培训系统。

2. 核心功能和特性

• 多基础系统支持：基于 Ubuntu（14.04 至 24.04）和 Alpine Linux（3.5 至 3.22 及 edge 版本）构建，满足不同场景下的系统环境需求。
• 版本化环境管理：提供多个镜像标签，对应不同 Linux 发行版及版本，部分标签集成特定版本 Node.js（如 Node.js 14、16、18、20、22），适配 OpenEMR 对底层依赖的版本要求。
• 轻量与稳定兼顾：Alpine 系列镜像体积更小，适合资源受限场景；Ubuntu 系列镜像提供更广泛的软件兼容性，适合稳定性优先的场景。
• 标准化配置：预安装 OpenEMR 运行所需的基础系统工具和依赖库，减少部署时的环境配置工作。

3. 使用场景和适用范围

• OpenEMR 演示环境搭建：作为 OpenEMR demo farm 的基础组件，快速部署可访问的 OpenEMR 演示实例。
• 开发测试环境：供开发人员在不同 Linux 环境下测试 OpenEMR 的兼容性和功能。
• 教学培训：为***信息化教学、OpenEMR 使用培训提供标准化的底层环境。
• 功能验证：验证 OpenEMR 在不同系统版本或 Node.js 版本下的运行状态。

4. 镜像标签说明

4.1 Ubuntu 系列镜像

4.2 Alpine 系列镜像

5. 使用方法和配置说明

5.1 拉取镜像

通过 Docker 命令拉取指定标签的 pre-openemr 镜像：

bash
# 拉取 Ubuntu 24.04 + Node.js 22 版本
docker pull pre-openemr:24.04-22

# 拉取 Alpine 3.22 版本
docker pull pre-openemr:3.22

5.2 基础运行示例

pre-openemr 作为基础镜像，通常需与 OpenEMR 应用镜像配合使用。以下为单独运行基础镜像的示例（用于环境验证）：

bash
# 运行 Ubuntu 22.04 + Node.js 18 版本的基础镜像
docker run -it --rm pre-openemr:22.04-18 /bin/bash

说明：该命令启动一个交互式容器，可用于验证基础环境（如检查 Node.js 版本：node -v）。

5.3 注意事项

• 依赖 OpenEMR 应用镜像：pre-openemr 仅提供底层环境，需结合 OpenEMR 应用代码或应用镜像才能完整运行 OpenEMR 系统。
• 数据持久化：实际部署时，建议通过数据卷（Volume）挂载 OpenEMR 应用数据，避免容器重启导致数据丢失。
• 版本匹配：选择镜像标签时，需根据 OpenEMR 版本要求匹配对应的基础系统和 Node.js/PHP 版本（参考 OpenEMR ***文档）。
• 网络配置：若需对外提供服务，需映射容器端口（如 -p 80:80）并配置网络访问规则。

6. Dockerfile 参考

各版本镜像的详细构建流程可通过对应 Dockerfile 查看，链接见「4. 镜像标签说明」中的 Dockerfile 链接列。Dockerfile 包含基础系统配置、依赖安装、环境变量设置等详细信息，可作为自定义构建或问题排查的参考。