SORMAS Docker镜像文档

镜像概述和主要用途

SORMAS（传染病监测、疫情响应管理和分析系统）是一个开源电子健康系统，包含独立的Web和移动应用，旨在优化传染病传播监测和疫情响应流程。本Docker镜像项目旨在为SORMAS应用提供容器化部署支持，简化安装配置并提高环境一致性。

项目目标

构建SORMAS应用的Docker镜像，实现应用的容器化部署，便于快速搭建测试环境和生产环境。

防火墙注意事项

运行SORMAS Docker部署的主机应位于外部防火墙后方。多个容器会在底层主机开放端口，可能绕过主机的iptables防火墙。

快速开始

如需搭建本地测试实例，请遵循以下步骤。

前提条件

运行容器化SORMAS需安装以下工具：

1. Docker（19.3版本经测试可正常运行SORMAS）
2. docker-compose
3. 在/etc/hosts文件中添加以下行：

127.0.0.1    sormas-docker-test.com

4. 以运行docker-compose的用户身份创建以下目录：

bash
mkdir /srv/dockerdata/sormas/psqldata
mkdir /srv/dockerdata/sormas/sormas-backup
mkdir /srv/dockerdata/sormas/sormas-web

启动应用

1. 克隆本仓库
2. 打开终端，进入项目根目录（包含docker-compose.yml的目录）
3. 执行以下命令启动应用：

bash
docker-compose up

默认登录信息

以下为演示系统的默认用户，生产环境中需停用或修改密码：

• 管理员
  用户名：admin，密码：sadmin
• 监测主管（Web界面）
  用户名：SunkSesa，密码：Sunkanmi
• 监测官员（移动应用）
  用户名：SanaObas，密码：Sanaa

核心功能和特性

• 容器化部署：支持通过Docker快速部署SORMAS完整服务栈（含数据库、应用服务器、Web服务器）
• 环境隔离：通过容器化确保应用运行环境一致性，减少部署冲突
• 灵活配置：支持通过环境变量自定义系统参数（如数据库配置、服务器URL、资源限制等）
• 安全支持：可集成SSL证书实现HTTPS访问，保障数据传输安全

使用场景和适用范围

适用于公共卫生机构、***机构等需要部署传染病监测与疫情响应系统的场景，尤其适合：

• 快速搭建测试环境进行功能验证
• 部署生产环境实现传染病监测与疫情响应流程数字化
• 多环境一致化部署（开发、测试、生产）

详细配置说明

高级安装

可通过编辑.env文件自定义部署配置，主要配置选项如下：

数据库相关环境变量

SORMAS相关环境变量

更改主机名

如需使用自定义主机名（如[***]），请按以下步骤操作：

1. 获取所选主机名的SSL证书和私钥（如使用Let's Encrypt）
2. 将证书文件复制到./apache2/certs目录，并重命名为：
   • 证书文件：[hostname].crt（如sormas.example.com.crt）
   • 私钥文件：[hostname].key（如sormas.example.com.key）
3. 设置环境变量SORMAS_SERVER_URL为自定义主机名
4. 确保DNS解析指向部署主机
5. 执行以下命令启动：

bash
docker-compose up -d

资源限制配置

可通过以下环境变量配置各组件的CPU和内存资源限制（内存单位为M，CPU为浮点值）：

应用服务器资源限制

• APPSERVER_JVM_MAX：Java应用服务器最大堆空间（示例：4096M）
• APPSERVER_MEM：应用服务器最大可用内存（需比JVM堆大至少150MB，示例：4300M）
• APPSERVER_MEM_RESERVED：应用服务器保留内存（示例：4300M）
• APPSERVER_CPUS：应用服务器CPU核心数（示例：2.0）

Web服务器资源限制

• WEBSERVER_MEM：Web服务器最大可用内存（示例：1000M）
• WEBSERVER_MEM_RESERVED：Web服务器保留内存（示例：400M）
• WEBSERVER_CPUS：Web服务器CPU核心数（示例：2.0）

数据库服务器资源限制

• DB_MEM：数据库服务器最大可用内存（示例：3000M）
• DB_MEM_RESERVED：数据库服务器保留内存（示例：2500M）
• DB_CPUS：数据库服务器CPU核心数（示例：3.0）

数据库备份工具资源限制

• DB_DUMP_MEM：数据库备份工具最大可用内存（示例：500M）
• DB_DUMP_MEM_RESERVED：数据库备份工具保留内存（示例：100M）
• DB_DUMP_CPUS：数据库备份工具CPU核心数（示例：0.5）