hzibraunschweig/sormas-application

SORMAS Docker镜像文档

镜像概述和主要用途

SORMAS（Surveillance Outbreak Response Management and Analysis System，监测疫情响应管理与分析系统）是一款开源eHealth系统，包含独立的Web和移动应用，旨在优化传染病传播监测及疫情响应流程。本Docker镜像项目提供SORMAS应用的容器化部署方案，简化安装流程并提升环境一致性。

核心功能和特性

• 容器化部署：通过Docker容器封装SORMAS应用组件，简化部署和版本管理
• 灵活配置：支持通过环境变量自定义数据库参数、服务器URL、语言、资源限制等
• 安全隔离：各组件（应用服务器、数据库、Web服务器）通过容器隔离运行
• 资源管控：可配置CPU、内存等资源限制，适应不同部署环境需求
• 数据持久化：通过Docker卷实现数据库数据、备份文件等持久化存储

使用场景和适用范围

适用于公共卫生机构、***机构等需要对传染病进行实时监测、追踪疫情发展及协调响应措施的场景。特别适合快速部署测试环境或生产环境，支持从小型本地测试到中型生产部署的多种规模。

使用方法和配置说明

防火墙注意事项

运行SORMAS Docker容器的主机应置于外部防火墙之后。部分容器会在主机上开放端口，可能绕过主机本地防火墙（iptables）。

快速开始

以下步骤适用于搭建本地测试实例。

前提条件

需安装以下工具：

1. Docker（19.3版本已测试兼容）
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

高级安装

配置参数说明

通过编辑.env文件自定义安装配置，支持以下类别参数：

数据库配置

• SORMAS_POSTGRES_USER：SORMAS数据库用户
• SORMAS_POSTGRES_PASSWORD：数据库用户密码
• DB_NAME：SORMAS数据数据库名称
• DB_NAME_AUDIT：SORMAS审计数据数据库名称
• DB_HOST：数据库主机名或IP

SORMAS应用配置

• SORMAS_VERSION：安装的SORMAS版本（Docker镜像从1.33.0版本开始提供）
• SORMAS_SERVER_URL：SORMAS访问URL
• DOMAIN_NAME：Payara服务器中的域名
• LOCALE：SORMAS服务器默认语言
• EPIDPREFIX：数据前缀
• MAIL_HOST：SMTP主机名或IP
• SEPARATOR：CSV分隔符
• EMAIL_SENDER_ADDRESS：邮件发送地址
• EMAIL_SENDER_NAME：邮件发送者名称
• LATITUDE：地图中心纬度
• LONGITUDE：地图中心经度
• SORMAS_PATH：Docker卷存储路径

自定义主机名

若需使用自定义主机名（如https://sormas.example.com），按以下步骤操作：

1. 获取所选主机名的证书和私钥（如通过letsencrypt）
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"（表示MB），CPU配置值为浮点型（小数点为分隔符）：

应用服务器资源

• APPSERVER_JVM_MAX：Java应用服务器最大堆空间（例：4096M）
• APPSERVER_MEM：应用服务器最大可用内存（需比APPSERVER_JVM_MAX至少多150M，例：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）