HaHafeng
4b9b90ffb8
Summary: - Deploy REDCap 15.8.0 on ECS with Docker CE 26.1.3 - Configure RDS MySQL 8.0 database (redcap_prod) - Setup Nginx reverse proxy with HTTPS/SSL - Domain configured: https://redcap.xunzhengyixue.com/ Documentation: - Add ECS deployment guide - Add deployment info record - Update system status document (v4.5 -> v4.6) Status: REDCap production environment fully operational Co-authored-by: Cursor <cursoragent@cursor.com>
622 lines
16 KiB
Markdown
622 lines
16 KiB
Markdown
# REDCap 阿里云 ECS 生产环境部署方案
|
||
|
||
**版本：** v1.0
|
||
**创建日期：** 2026-02-02
|
||
**适用环境：** 阿里云 ECS + RDS MySQL 8.0
|
||
**REDCap版本：** 15.8.0
|
||
**状态：** 📋 待执行
|
||
|
||
---
|
||
|
||
## 📋 部署概览
|
||
|
||
### 目标架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 阿里云生产环境架构 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ ┌──────────────────────────────────────────────────────┐ │
|
||
│ │ 公网访问层 │ │
|
||
│ │ 公网IP: 39.105.153.58:80/443 │ │
|
||
│ └──────────────────────────────────────────────────────┘ │
|
||
│ ↓ │
|
||
│ ┌──────────────────────────────────────────────────────┐ │
|
||
│ │ ECS 服务器 (launch-advisor-20260108) │ │
|
||
│ │ ├── Docker Engine │ │
|
||
│ │ └── REDCap 容器 │ │
|
||
│ │ ├── Apache 2.4 + PHP 8.1 │ │
|
||
│ │ └── REDCap 15.8.0 │ │
|
||
│ │ 私网IP: 172.17.173.82 │ │
|
||
│ └──────────────────────────────────────────────────────┘ │
|
||
│ ↓ VPC内网 │
|
||
│ ┌──────────────────────────────────────────────────────┐ │
|
||
│ │ RDS MySQL 8.0 (rm-2ze9587199003517c) │ │
|
||
│ │ ├── 2核 4GB │ │
|
||
│ │ ├── 数据库: redcap_prod │ │
|
||
│ │ └── 用户: redcap_user │ │
|
||
│ │ 内网地址: rm-2ze9587199003517c.mysql.rds.aliyuncs.com │
|
||
│ └──────────────────────────────────────────────────────┘ │
|
||
│ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 资源清单
|
||
|
||
| 资源 | 规格 | 状态 | 备注 |
|
||
|------|------|------|------|
|
||
| ECS 服务器 | 2核 4GB | ✅ 已购买 | launch-advisor-20260108 |
|
||
| RDS MySQL | 2核 4GB，MySQL 8.0 | ✅ 已购买 | rm-2ze9587199003517c |
|
||
| 公网IP | 39.105.153.58 | ✅ 已分配 | 需配置安全组 |
|
||
| 域名 | 待配置 | ⏳ 可选 | 建议使用域名+SSL |
|
||
|
||
---
|
||
|
||
## 🚀 部署步骤
|
||
|
||
### 阶段1：ECS 服务器初始化
|
||
|
||
#### 1.1 SSH 连接到 ECS
|
||
|
||
```bash
|
||
# 方式1：使用阿里云控制台"远程连接"
|
||
# 方式2：本地 SSH 连接
|
||
ssh root@39.105.153.58
|
||
```
|
||
|
||
#### 1.2 更新系统
|
||
|
||
```bash
|
||
# 更新系统包
|
||
sudo yum update -y
|
||
|
||
# 安装常用工具
|
||
sudo yum install -y git curl wget vim
|
||
```
|
||
|
||
#### 1.3 安装 Docker
|
||
|
||
```bash
|
||
# 安装 Docker
|
||
sudo yum install -y docker
|
||
|
||
# 启动 Docker 服务
|
||
sudo systemctl start docker
|
||
sudo systemctl enable docker
|
||
|
||
# 验证安装
|
||
docker --version
|
||
# 预期输出: Docker version 20.x.x 或更高
|
||
|
||
# 添加当前用户到 docker 组（可选，避免每次 sudo）
|
||
sudo usermod -aG docker $USER
|
||
```
|
||
|
||
#### 1.4 安装 Docker Compose
|
||
|
||
```bash
|
||
# 下载 Docker Compose
|
||
sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
|
||
|
||
# 添加执行权限
|
||
sudo chmod +x /usr/local/bin/docker-compose
|
||
|
||
# 验证安装
|
||
docker-compose --version
|
||
# 预期输出: Docker Compose version v2.24.0
|
||
```
|
||
|
||
#### 1.5 创建工作目录
|
||
|
||
```bash
|
||
# 创建 REDCap 部署目录
|
||
sudo mkdir -p /opt/redcap
|
||
sudo chown -R $USER:$USER /opt/redcap
|
||
cd /opt/redcap
|
||
|
||
# 创建子目录
|
||
mkdir -p config/{apache,php}
|
||
mkdir -p logs
|
||
```
|
||
|
||
---
|
||
|
||
### 阶段2：RDS MySQL 配置
|
||
|
||
#### 2.1 配置 RDS 白名单
|
||
|
||
**在阿里云 RDS 控制台操作：**
|
||
|
||
1. 进入 RDS 实例详情页
|
||
2. 左侧菜单 → "白名单与安全组"
|
||
3. 点击"修改"，添加 ECS 私网 IP：
|
||
```
|
||
172.17.173.82
|
||
```
|
||
4. 保存
|
||
|
||
#### 2.2 获取 RDS 内网连接地址
|
||
|
||
**在 RDS 控制台 → "数据库连接" 页面获取：**
|
||
|
||
```
|
||
内网地址: rm-2ze9587199003517c.mysql.rds.aliyuncs.com
|
||
端口: 3306
|
||
```
|
||
|
||
#### 2.3 创建 REDCap 数据库和用户
|
||
|
||
**方式1：使用阿里云 DMS 控制台**
|
||
|
||
1. RDS 控制台 → 点击"登录数据库"
|
||
2. 执行以下 SQL：
|
||
|
||
```sql
|
||
-- 创建数据库
|
||
CREATE DATABASE redcap_prod
|
||
CHARACTER SET utf8mb4
|
||
COLLATE utf8mb4_unicode_ci;
|
||
|
||
-- 创建用户（使用强密码！）
|
||
CREATE USER 'redcap_user'@'172.17.173.%'
|
||
IDENTIFIED BY 'YOUR_STRONG_PASSWORD_32_CHARS_MIN';
|
||
|
||
-- 授予权限
|
||
GRANT ALL PRIVILEGES ON redcap_prod.* TO 'redcap_user'@'172.17.173.%';
|
||
FLUSH PRIVILEGES;
|
||
|
||
-- 验证
|
||
SHOW DATABASES;
|
||
SELECT User, Host FROM mysql.user WHERE User = 'redcap_user';
|
||
```
|
||
|
||
**方式2：从 ECS 使用 mysql 客户端**
|
||
|
||
```bash
|
||
# 安装 MySQL 客户端
|
||
sudo yum install -y mysql
|
||
|
||
# 连接 RDS（使用 root 账户）
|
||
mysql -h rm-2ze9587199003517c.mysql.rds.aliyuncs.com -u root -p
|
||
|
||
# 执行上述 SQL
|
||
```
|
||
|
||
#### 2.4 记录数据库连接信息
|
||
|
||
```
|
||
主机: rm-2ze9587199003517c.mysql.rds.aliyuncs.com
|
||
端口: 3306
|
||
数据库: redcap_prod
|
||
用户名: redcap_user
|
||
密码: YOUR_STRONG_PASSWORD_32_CHARS_MIN
|
||
```
|
||
|
||
---
|
||
|
||
### 阶段3：准备 REDCap 文件
|
||
|
||
#### 3.1 上传 REDCap 源码
|
||
|
||
**方式1：使用 SCP 从本地上传**
|
||
|
||
```powershell
|
||
# 在本地 Windows PowerShell 执行
|
||
scp -r D:\MyCursor\Redcap\redcap15.8.0 root@39.105.153.58:/opt/redcap/
|
||
```
|
||
|
||
**方式2：使用阿里云 OSS 中转**
|
||
|
||
1. 上传 redcap15.8.0.zip 到 OSS
|
||
2. 在 ECS 下载：
|
||
```bash
|
||
cd /opt/redcap
|
||
wget https://your-bucket.oss-cn-beijing.aliyuncs.com/redcap15.8.0.zip
|
||
unzip redcap15.8.0.zip
|
||
```
|
||
|
||
#### 3.2 上传 Docker 配置文件
|
||
|
||
```powershell
|
||
# 在本地 Windows PowerShell 执行
|
||
scp D:\MyCursor\Redcap\redcap-docker-dev\Dockerfile.redcap root@39.105.153.58:/opt/redcap/
|
||
scp D:\MyCursor\Redcap\redcap-docker-dev\docker-entrypoint.sh root@39.105.153.58:/opt/redcap/
|
||
scp D:\MyCursor\Redcap\redcap-docker-dev\config\php\php.ini root@39.105.153.58:/opt/redcap/config/php/
|
||
scp D:\MyCursor\Redcap\redcap-docker-dev\config\apache\redcap.conf root@39.105.153.58:/opt/redcap/config/apache/
|
||
```
|
||
|
||
#### 3.3 创建生产环境 database.php
|
||
|
||
在 ECS 上创建：
|
||
|
||
```bash
|
||
cat > /opt/redcap/config/database.php << 'EOF'
|
||
<?php
|
||
/**
|
||
* REDCap 生产环境数据库配置
|
||
* 环境: 阿里云 ECS + RDS MySQL 8.0
|
||
* 创建日期: 2026-02-02
|
||
*/
|
||
|
||
// RDS MySQL 连接信息
|
||
$hostname = 'rm-2ze9587199003517c.mysql.rds.aliyuncs.com';
|
||
$db = 'redcap_prod';
|
||
$username = 'redcap_user';
|
||
$password = 'YOUR_STRONG_PASSWORD_32_CHARS_MIN'; // ⚠️ 修改为实际密码
|
||
|
||
// Salt值 - ⚠️ 重要：设置后永不可变！
|
||
$salt = 'YOUR_RANDOM_SALT_32_CHARS_NEVER_CHANGE'; // ⚠️ 修改为随机字符串
|
||
|
||
// 高级配置（可选）
|
||
$db_ssl_verify_server_cert = false; // RDS 内网连接可不验证
|
||
|
||
// 以下配置保持默认
|
||
$homepage_contact = 'admin@example.com';
|
||
$homepage_contact_url = '';
|
||
EOF
|
||
```
|
||
|
||
**⚠️ 重要：生成强密码和Salt**
|
||
|
||
```bash
|
||
# 生成随机密码（32字符）
|
||
openssl rand -base64 32
|
||
|
||
# 生成 Salt（建议64字符）
|
||
openssl rand -base64 48
|
||
```
|
||
|
||
#### 3.4 创建生产环境 docker-compose.prod.yml
|
||
|
||
```bash
|
||
cat > /opt/redcap/docker-compose.prod.yml << 'EOF'
|
||
# REDCap Docker Compose 配置 - 生产环境
|
||
# 版本：v1.0
|
||
# 日期：2026-02-02
|
||
# 用途：阿里云 ECS + RDS MySQL 生产环境
|
||
|
||
version: '3.8'
|
||
|
||
services:
|
||
# ========== REDCap Web服务 (Apache + PHP 8.1) ==========
|
||
redcap-web:
|
||
build:
|
||
context: .
|
||
dockerfile: Dockerfile.redcap
|
||
container_name: redcap-prod
|
||
restart: always
|
||
ports:
|
||
- "80:80"
|
||
# - "443:443" # HTTPS（配置SSL后启用）
|
||
volumes:
|
||
# REDCap源代码（只读）
|
||
- ./redcap15.8.0/redcap:/var/www/html/redcap:ro
|
||
|
||
# 配置文件
|
||
- ./config/apache/redcap.conf:/etc/apache2/sites-available/000-default.conf:ro
|
||
- ./config/php/php.ini:/usr/local/etc/php/php.ini:ro
|
||
- ./config/database.php:/var/www/html/redcap/database.php:ro
|
||
|
||
# 持久化数据（可读写）
|
||
- redcap-edocs:/var/www/html/redcap/edocs
|
||
- redcap-modules:/var/www/html/redcap/modules
|
||
- redcap-temp:/var/www/html/redcap/temp
|
||
|
||
# 日志
|
||
- ./logs:/var/log/apache2
|
||
environment:
|
||
TZ: Asia/Shanghai
|
||
# RDS 连接信息（用于健康检查）
|
||
REDCAP_DB_HOST: rm-2ze9587199003517c.mysql.rds.aliyuncs.com
|
||
REDCAP_DB_PORT: 3306
|
||
REDCAP_DB_NAME: redcap_prod
|
||
healthcheck:
|
||
test: ["CMD", "curl", "-f", "http://localhost/"]
|
||
interval: 30s
|
||
timeout: 10s
|
||
retries: 3
|
||
logging:
|
||
driver: "json-file"
|
||
options:
|
||
max-size: "100m"
|
||
max-file: "3"
|
||
|
||
# ========== 数据卷配置 ==========
|
||
volumes:
|
||
# REDCap上传文件（重要！需定期备份）
|
||
redcap-edocs:
|
||
name: redcap-edocs-prod
|
||
driver: local
|
||
|
||
# External Modules
|
||
redcap-modules:
|
||
name: redcap-modules-prod
|
||
driver: local
|
||
|
||
# 临时文件
|
||
redcap-temp:
|
||
name: redcap-temp-prod
|
||
driver: local
|
||
EOF
|
||
```
|
||
|
||
#### 3.5 确保脚本有执行权限
|
||
|
||
```bash
|
||
chmod +x /opt/redcap/docker-entrypoint.sh
|
||
```
|
||
|
||
---
|
||
|
||
### 阶段4：配置安全组
|
||
|
||
#### 4.1 ECS 安全组规则
|
||
|
||
**在阿里云 ECS 控制台 → 安全组 配置：**
|
||
|
||
| 规则方向 | 协议 | 端口 | 授权对象 | 说明 |
|
||
|---------|------|------|---------|------|
|
||
| 入方向 | TCP | 80 | 0.0.0.0/0 | HTTP访问 |
|
||
| 入方向 | TCP | 443 | 0.0.0.0/0 | HTTPS访问（可选） |
|
||
| 入方向 | TCP | 22 | 您的IP/32 | SSH管理（限制IP） |
|
||
| 出方向 | TCP | 3306 | 172.17.0.0/16 | 访问RDS |
|
||
| 出方向 | TCP | 443 | 0.0.0.0/0 | HTTPS出站 |
|
||
|
||
**⚠️ 安全建议：**
|
||
- SSH 端口（22）建议限制为您的办公网络 IP
|
||
- 不要开放 3306 端口到公网
|
||
|
||
---
|
||
|
||
### 阶段5：部署 REDCap
|
||
|
||
#### 5.1 验证文件结构
|
||
|
||
```bash
|
||
cd /opt/redcap
|
||
ls -la
|
||
|
||
# 预期结构：
|
||
# /opt/redcap/
|
||
# ├── Dockerfile.redcap
|
||
# ├── docker-compose.prod.yml
|
||
# ├── docker-entrypoint.sh
|
||
# ├── config/
|
||
# │ ├── apache/redcap.conf
|
||
# │ ├── php/php.ini
|
||
# │ └── database.php
|
||
# ├── redcap15.8.0/
|
||
# │ └── redcap/
|
||
# └── logs/
|
||
```
|
||
|
||
#### 5.2 测试数据库连接
|
||
|
||
```bash
|
||
# 测试 RDS 连接
|
||
mysql -h rm-2ze9587199003517c.mysql.rds.aliyuncs.com \
|
||
-u redcap_user -p \
|
||
-e "SELECT 1;"
|
||
```
|
||
|
||
#### 5.3 构建并启动容器
|
||
|
||
```bash
|
||
cd /opt/redcap
|
||
|
||
# 构建镜像
|
||
docker-compose -f docker-compose.prod.yml build
|
||
|
||
# 启动容器
|
||
docker-compose -f docker-compose.prod.yml up -d
|
||
|
||
# 查看状态
|
||
docker-compose -f docker-compose.prod.yml ps
|
||
|
||
# 查看日志
|
||
docker-compose -f docker-compose.prod.yml logs -f
|
||
```
|
||
|
||
#### 5.4 初始化 REDCap 数据库
|
||
|
||
**方式1：使用安装向导（推荐）**
|
||
|
||
1. 访问 http://39.105.153.58/install.php
|
||
2. 按照向导完成安装
|
||
3. 创建管理员账户
|
||
|
||
**方式2：导入 SQL 文件**
|
||
|
||
```bash
|
||
# 如果有现成的 redcap_install.sql
|
||
mysql -h rm-2ze9587199003517c.mysql.rds.aliyuncs.com \
|
||
-u redcap_user -p redcap_prod < redcap_install.sql
|
||
```
|
||
|
||
---
|
||
|
||
### 阶段6：验证部署
|
||
|
||
#### 6.1 访问测试
|
||
|
||
| 测试项 | URL | 预期结果 |
|
||
|--------|-----|---------|
|
||
| 首页 | http://39.105.153.58/ | 显示REDCap登录页 |
|
||
| 安装向导 | http://39.105.153.58/install.php | 显示安装页面 |
|
||
| 控制中心 | http://39.105.153.58/ControlCenter/ | 需登录后访问 |
|
||
|
||
#### 6.2 功能验证清单
|
||
|
||
- [ ] 页面样式正常，无404错误
|
||
- [ ] 可以成功登录
|
||
- [ ] 可以创建项目
|
||
- [ ] 可以创建表单
|
||
- [ ] 数据可以正常保存
|
||
- [ ] API 可以正常调用
|
||
|
||
---
|
||
|
||
## 🔒 安全加固（重要！）
|
||
|
||
### 7.1 修改 REDCap Base URL
|
||
|
||
登录后在 Control Center 修改：
|
||
|
||
```
|
||
Configuration > General Configuration > REDCap base URL
|
||
设置为: http://39.105.153.58
|
||
（或您的域名: https://redcap.yourdomain.com）
|
||
```
|
||
|
||
### 7.2 配置 HTTPS（强烈建议）
|
||
|
||
**方式1：使用阿里云 SSL 证书**
|
||
|
||
1. 申请免费 SSL 证书（阿里云控制台）
|
||
2. 下载证书文件
|
||
3. 配置 Nginx 反向代理或修改 Apache 配置
|
||
|
||
**方式2：使用 Let's Encrypt**
|
||
|
||
```bash
|
||
# 安装 Certbot
|
||
sudo yum install -y certbot
|
||
|
||
# 获取证书（需要域名指向此服务器）
|
||
sudo certbot certonly --standalone -d redcap.yourdomain.com
|
||
```
|
||
|
||
### 7.3 定期备份
|
||
|
||
```bash
|
||
# 创建备份脚本
|
||
cat > /opt/redcap/backup.sh << 'EOF'
|
||
#!/bin/bash
|
||
DATE=$(date +%Y%m%d)
|
||
BACKUP_DIR=/opt/redcap/backups
|
||
|
||
mkdir -p $BACKUP_DIR
|
||
|
||
# 备份数据库
|
||
mysqldump -h rm-2ze9587199003517c.mysql.rds.aliyuncs.com \
|
||
-u redcap_user -p'YOUR_PASSWORD' \
|
||
redcap_prod > $BACKUP_DIR/redcap_db_$DATE.sql
|
||
|
||
# 备份 edocs
|
||
docker cp redcap-prod:/var/www/html/redcap/edocs $BACKUP_DIR/edocs_$DATE
|
||
|
||
# 保留最近7天
|
||
find $BACKUP_DIR -mtime +7 -delete
|
||
|
||
echo "Backup completed: $DATE"
|
||
EOF
|
||
|
||
chmod +x /opt/redcap/backup.sh
|
||
|
||
# 添加定时任务（每天凌晨2点）
|
||
echo "0 2 * * * /opt/redcap/backup.sh" | crontab -
|
||
```
|
||
|
||
---
|
||
|
||
## 📋 部署检查清单
|
||
|
||
### 部署前
|
||
|
||
- [ ] ECS 服务器已启动
|
||
- [ ] RDS MySQL 已启动
|
||
- [ ] RDS 白名单已添加 ECS 私网 IP
|
||
- [ ] 安全组已配置 80/443 端口
|
||
- [ ] REDCap 源码已上传
|
||
- [ ] database.php 已配置正确的 RDS 连接信息
|
||
- [ ] Salt 值已设置并记录（永不可变！）
|
||
|
||
### 部署后
|
||
|
||
- [ ] 容器状态正常（docker-compose ps）
|
||
- [ ] 可以访问 http://39.105.153.58/
|
||
- [ ] 页面样式正常
|
||
- [ ] 可以成功登录
|
||
- [ ] 可以创建项目并保存数据
|
||
- [ ] 备份脚本已配置
|
||
- [ ] （可选）HTTPS 已配置
|
||
|
||
---
|
||
|
||
## 🛠️ 常用运维命令
|
||
|
||
```bash
|
||
# 进入部署目录
|
||
cd /opt/redcap
|
||
|
||
# 查看容器状态
|
||
docker-compose -f docker-compose.prod.yml ps
|
||
|
||
# 查看日志
|
||
docker-compose -f docker-compose.prod.yml logs -f
|
||
|
||
# 重启服务
|
||
docker-compose -f docker-compose.prod.yml restart
|
||
|
||
# 停止服务
|
||
docker-compose -f docker-compose.prod.yml stop
|
||
|
||
# 启动服务
|
||
docker-compose -f docker-compose.prod.yml start
|
||
|
||
# 重建容器（代码更新后）
|
||
docker-compose -f docker-compose.prod.yml up -d --build
|
||
|
||
# 进入容器
|
||
docker exec -it redcap-prod bash
|
||
|
||
# 查看磁盘使用
|
||
docker system df
|
||
```
|
||
|
||
---
|
||
|
||
## ⚠️ 重要注意事项
|
||
|
||
### Salt 值
|
||
|
||
```
|
||
⚠️ Salt 值一旦设置，永远不可更改！
|
||
用于数据去标识化哈希，更改将导致所有去标识化数据失效。
|
||
请务必记录并安全保存。
|
||
```
|
||
|
||
### 密码安全
|
||
|
||
- 数据库密码建议 32+ 字符
|
||
- 定期更换管理员密码
|
||
- 不要在代码中硬编码密码
|
||
|
||
### 数据备份
|
||
|
||
- 每日自动备份数据库
|
||
- edocs 目录包含上传文件，需备份
|
||
- 备份文件建议同步到 OSS
|
||
|
||
---
|
||
|
||
## 📚 相关文档
|
||
|
||
- [Docker部署操作手册](./10-REDCap_Docker部署操作手册.md)
|
||
- [部署问题排查手册](./13-部署问题排查手册.md)
|
||
- [REDCap API使用指南](../03-API对接与开发/30-REDCap_API使用指南.md)
|
||
|
||
---
|
||
|
||
## 📝 更新记录
|
||
|
||
| 日期 | 版本 | 更新内容 |
|
||
|------|------|---------|
|
||
| 2026-02-02 | v1.0 | 初始版本，基于 ECS + RDS 架构 |
|
||
|
||
---
|
||
|
||
**文档维护：** AI Clinical Research 开发团队
|
||
**有问题？** 查看 [部署问题排查手册](./13-部署问题排查手册.md)
|