Primero应用镜像文档

概述

Primero应用镜像是用于快速部署和运行Primero平台的Docker镜像。Primero是一款开源人道主义案例管理系统，主要由联合国儿童基金会（UNICEF）等组织开发，旨在支持保护工作者收集、管理和分析敏感案例数据，适用于儿童保护、性别暴力应对等人道主义援助场景。该镜像封装了Primero应用的核心组件，简化部署流程，确保环境一致性。

核心功能与特性

• 案例管理工作流：支持案例创建、分配、跟踪和结案全流程管理，自定义工作流规则
• 数据安全与隐私保护：符合GDPR等隐私标准，提供数据加密、访问权限控制和审计日志
• 多语言支持：内置多语言界面，适配不同地区使用需求
• 可配置表单与数据模型：通过可视化界面自定义数据收集表单和案例属性
• 离线数据同步：支持低网络环境下的数据本地存储与后续同步
• 报告与分析：生成保护服务统计报告，支持数据可视化与趋势分析

使用场景与适用范围

• 人道主义组织现场部署：在紧急救援或长期援助项目中快速搭建案例管理系统
• 儿童保护服务：跟踪儿童福利案例，协调***、教育等多部门服务
• 性别暴力应对：管理幸存者案例数据，确保服务连续性与隐私保护
• 跨机构协作平台：支持***部门、NGO等多组织间安全共享必要案例信息
• 灾后重建阶段：统筹人口登记、需求评估等基础数据管理

使用方法与配置说明

前提条件

• Docker Engine 20.10+ 或兼容容器运行时
• Docker Compose v2+（推荐，用于多容器部署）
• 最低系统资源：2 CPU核心，4GB RAM，20GB可用磁盘空间（生产环境建议翻倍）

快速启动（单容器测试）

# 拉取镜像
docker pull primero/app:latest

# 启动容器（测试环境，不包含数据库）
docker run -d -p 3000:3000 --name primero_test primero/app:latest

访问 http://localhost:3000 即可打开Primero应用界面（默认管理员账户：admin/admin123，首次登录需修改密码）。

生产环境部署（Docker Compose）

1. 创建docker-compose.yml配置文件

version: '3.8'
services:
  primero:
    image: primero/app:latest
    restart: always
    ports:
      - "80:3000"  # 可替换为HTTPS端口（如443）配合反向代理
    environment:
      - RAILS_ENV=production
      - DATABASE_URL=postgresql://primero_user:${DB_PASSWORD}@db:5432/primero_db
      - SECRET_KEY_BASE=${SECRET_KEY}  # 建议使用openssl rand -hex 64生成
      - SMTP_HOST=${SMTP_HOST}         # 邮件服务器地址
      - SMTP_PORT=${SMTP_PORT}         # 邮件服务器端口
      - SMTP_USER=${SMTP_USER}         # 邮件发送账户
      - SMTP_PASSWORD=${SMTP_PASSWORD} # 邮件发送密码
    volumes:
      - primero_uploads:/app/public/uploads  # 存储上传文件
      - primero_logs:/app/log               # 应用日志
    depends_on:
      - db

  db:
    image: postgres:14-alpine
    restart: always
    environment:
      - POSTGRES_USER=primero_user
      - POSTGRES_PASSWORD=${DB_PASSWORD}
      - POSTGRES_DB=primero_db
    volumes:
      - postgres_data:/var/lib/postgresql/data  # 持久化数据库数据
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U primero_user -d primero_db"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  primero_uploads:
  primero_logs:
  postgres_data:

2. 启动服务

# 创建环境变量文件
echo "DB_PASSWORD=your_secure_password" > .env
echo "SECRET_KEY=$(openssl rand -hex 64)" >> .env
# 添加SMTP相关变量（如需要邮件通知）

# 启动服务
docker-compose up -d

# 初始化数据库（首次启动）
docker-compose exec primero bundle exec rake db:migrate
docker-compose exec primero bundle exec rake db:seed

配置参数说明

核心环境变量

数据持久化

• 上传文件：挂载/app/public/uploads卷，存储用户上传的文档、图片等
• 数据库数据：通过PostgreSQL容器的/var/lib/postgresql/data卷持久化
• 日志：挂载/app/log卷收集应用运行日志，建议配置日志轮转

注意事项

• 安全加固：生产环境需通过反向代理（如Nginx）配置HTTPS，禁用默认管理员账户，定期更新镜像
• 数据备份：定期备份PostgreSQL数据卷和上传文件卷，建议配置自动备份脚本
• 资源监控：监控容器CPU/内存使用情况，高并发场景需调整资源分配
• 版本兼容性：升级镜像前需查阅Primero***文档，确认数据库迁移要求

参考链接

• Primero***文档
• Primero GitHub仓库
• Docker Compose部署指南