Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(redcap): REDCap 15.8.0 Docker本地开发环境部署完成

Browse Source 
核心成果:
- REDCap 15.8.0成功部署在Docker环境
- 登录功能正常，管理员账户: Admin/Admin123!
- MySQL 8.0 + PHP 8.1 + Apache 2.4环境验证通过

问题解决:
1. 修复ERR_CONTENT_DECODING_FAILED错误
   - 强制禁用Apache deflate模块
   - PHP配置关闭zlib.output_compression
   - 自动注释REDCap源码中的压缩设置

2. 修复Base URL配置错误
   - 更新redcap_config表中的redcap_base_url
   - 统一DocumentRoot与访问路径

3. 修复登录失败问题(CRLF污染)
   - 删除database.php末尾的PHP结束标签
   - 创建.gitattributes规范换行符
   - 验证REDCap官方源码无此问题

技术改进:
- 添加密码重置工具脚本
- 完善docker-entrypoint.sh启动脚本
- 创建详细的部署问题解决记录
- 建立PHP配置文件最佳实践

部署文档:
- REDCap本地Docker开发环境部署方案
- REDCap生产环境部署决策报告(ECS vs SAE)
- 部署问题解决记录(含根因分析)

下一步:
- Day 2: 开发REDCap API Adapter
- 实现与IIT Manager Agent的数据对接
This commit is contained in:
HaHafeng
2026-01-02 10:02:46 +08:00
parent dac3cecf78
commit 38d9bf99d6
25 changed files with 3990 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
redcap-docker-dev/.gitattributes vendored Normal file
View File

@@ -0,0 +1,34 @@
# Git attributes for REDCap Docker deployment
# 确保跨平台一致性，防止CRLF/LF问题
# PHP文件统一使用LF换行符（Linux标准）
*.php text eol=lf
*.inc text eol=lf
# Shell脚本统一使用LF
*.sh text eol=lf
# PowerShell脚本保持CRLF（Windows标准）
*.ps1 text eol=crlf
# 配置文件统一使用LF
*.conf text eol=lf
*.ini text eol=lf
*.yml text eol=lf
*.yaml text eol=lf
# Markdown和文档
*.md text eol=lf
*.txt text eol=lf
# 二进制文件不做转换
*.png binary
*.jpg binary
*.jpeg binary
*.gif binary
*.ico binary
*.pdf binary
*.zip binary
*.tar binary
*.gz binary

65
redcap-docker-dev/.gitignore vendored Normal file
View File

@@ -0,0 +1,65 @@
# REDCap Docker环境 - Git忽略文件
# 版本：v1.0
# 日期：2026-01-01
# ========== 环境变量文件（包含敏感信息） ==========
.env
.env.local
.env.*.local
# ========== Docker数据卷挂载点（如使用本地挂载） ==========
data/
mysql-data/
edocs/
temp/
modules/
# ========== SSL证书（敏感） ==========
ssl/
*.crt
*.key
*.pem
# ========== 日志文件 ==========
logs/
*.log
# ========== 备份文件 ==========
backups/
*.sql
*.tar
*.tar.gz
*.zip
# ========== 临时文件 ==========
tmp/
temp/
*.tmp
*.swp
*~
# ========== IDE配置 ==========
.vscode/
.idea/
*.code-workspace
# ========== 操作系统文件 ==========
# Windows
Thumbs.db
Desktop.ini
# macOS
.DS_Store
.AppleDouble
.LSOverride
# ========== 其他 ==========
# 不要忽略README.md
!README.md
# 不要忽略配置模板
!env.template
!*.example
!*.template

94
redcap-docker-dev/Dockerfile.redcap Normal file
View File

@@ -0,0 +1,94 @@
# REDCap Docker镜像定义
# 基于：PHP 8.1 Apache官方镜像
# 版本：v1.0
# 日期：2026-01-01
# 适用：开发/测试/生产环境
FROM php:8.1-apache
LABEL maintainer="IIT Manager Team"
LABEL description="REDCap 15.8.0 Docker Image for IIT Manager Agent"
LABEL version="1.0"
# ========== 设置时区 ==========
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
# ========== 配置APT使用阿里云镜像源（加速国内构建） ==========
RUN sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list.d/debian.sources || \
sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list
# ========== 安装系统依赖 ==========
RUN apt-get update && apt-get install -y \
# 图片处理库（GD扩展需要）
libpng-dev \
libjpeg-dev \
libfreetype6-dev \
# ZIP扩展
libzip-dev \
# LDAP扩展（可选，企业认证用）
libldap2-dev \
# SOAP扩展（可选，Web Service用）
libxml2-dev \
# Cron定时任务
cron \
# 常用工具
curl \
vim \
unzip \
# 清理APT缓存
&& rm -rf /var/lib/apt/lists/*
# ========== 安装PHP扩展 ==========
# GD扩展（图片处理）
RUN docker-php-ext-configure gd --with-freetype --with-jpeg && \
docker-php-ext-install -j$(nproc) gd
# 数据库扩展
RUN docker-php-ext-install -j$(nproc) \
mysqli \
pdo_mysql
# 其他必需扩展
RUN docker-php-ext-install -j$(nproc) \
zip \
soap \
calendar \
bcmath
# LDAP扩展（可选）
RUN docker-php-ext-configure ldap --with-libdir=lib/x86_64-linux-gnu/ && \
docker-php-ext-install ldap
# ========== 启用Apache模块 ==========
RUN a2enmod rewrite ssl headers
# ========== 创建必需目录 ==========
RUN mkdir -p /var/www/html/redcap/edocs && \
mkdir -p /var/www/html/redcap/temp && \
mkdir -p /var/www/html/redcap/modules && \
chown -R www-data:www-data /var/www/html
# ========== 配置Cron定时任务 ==========
# REDCap需要定期运行cron.php
RUN echo "* * * * * www-data /usr/local/bin/php /var/www/html/redcap/cron.php > /proc/1/fd/1 2>&1" >> /etc/crontab && \
echo "" >> /etc/crontab
# ========== 复制启动脚本 ==========
COPY docker-entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/docker-entrypoint.sh
# ========== 暴露端口 ==========
EXPOSE 80 443
# ========== 健康检查 ==========
HEALTHCHECK --interval=30s --timeout=10s --retries=3 \
CMD curl -f http://localhost/ || exit 1
# ========== 工作目录 ==========
WORKDIR /var/www/html
# ========== 启动命令 ==========
ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]
CMD ["apache2-foreground"]

366
redcap-docker-dev/README.md Normal file
View File

@@ -0,0 +1,366 @@
# REDCap Docker部署环境
> **IIT Manager Agent项目 - REDCap开发/生产一致性环境**
> 版本：v1.0 | 日期：2026-01-01
---
## 📋 目录
1. [快速开始](#快速开始)
2. [项目结构](#项目结构)
3. [环境要求](#环境要求)
4. [详细部署步骤](#详细部署步骤)
5. [常用命令](#常用命令)
6. [故障排查](#故障排查)
7. [生产环境部署](#生产环境部署)
---
## 🚀 快速开始
### 一键部署（推荐）
```powershell
# 进入项目目录
cd redcap-docker-dev
# 运行一键部署脚本
.\scripts\setup-redcap.ps1
# 访问REDCap
# http://localhost:8080/install.php
```
### 手动部署
```powershell
# 1. 复制环境变量模板
copy env.template .env
# 2. 构建并启动容器
docker-compose up -d
# 3. 查看容器状态
docker-compose ps
```
---
## 📁 项目结构
```
redcap-docker-dev/
├── docker-compose.yml # Docker编排（开发环境）
├── docker-compose.prod.yml # Docker编排（生产环境）
├── Dockerfile.redcap # REDCap镜像定义
├── docker-entrypoint.sh # 容器启动脚本
├── env.template # 环境变量模板
├── .gitignore # Git忽略规则
│
├── config/ # 配置文件目录
│ ├── apache/
│ │ └── redcap.conf # Apache虚拟主机配置
│ ├── php/
│ │ └── php.ini # PHP配置
│ └── database.php # REDCap数据库配置
│
├── scripts/ # 运维脚本
│ ├── setup-redcap.ps1 # 一键部署
│ ├── start-redcap.ps1 # 启动服务
│ ├── stop-redcap.ps1 # 停止服务
│ ├── logs-redcap.ps1 # 查看日志
│ └── clean-redcap.ps1 # 清理环境
│
└── README.md # 本文档
```
---
## 💻 环境要求
### 软件要求
- **Docker Desktop**：20.10+ （Windows/Mac）
- **PowerShell**：5.1+ 或 PowerShell Core 7+
- **内存**：至少4GB可用
- **磁盘**：至少10GB可用空间
### REDCap源码
确保REDCap源码位于正确位置：
```
AIclinicalresearch/
├── redcap15.8.0/
│ └── redcap/
└── redcap-docker-dev/ # 当前目录
```
---
## 📖 详细部署步骤
### 步骤1：准备环境变量
```powershell
# 复制模板
copy env.template .env
# （可选）编辑.env修改密码
notepad .env
```
**默认配置（开发环境）**：
- MySQL Root密码：`redcap_root_dev_2026`
- MySQL数据库：`redcap`
- MySQL用户：`redcap_user`
- MySQL密码：`redcap_pass_dev_456`
⚠️ **生产环境必须修改所有密码！**
### 步骤2：构建Docker镜像
```powershell
docker-compose build
```
**预计时间**：5-10分钟（首次）
### 步骤3：启动容器
```powershell
docker-compose up -d
```
**启动的服务**：
- `redcap-mysql`：MySQL 8.0数据库
- `redcap-apache`：REDCap Web服务
- `redcap-phpmyadmin`：数据库管理工具（可选）
### 步骤4：等待服务就绪
```powershell
# 等待30秒让MySQL完全启动
# 然后访问：http://localhost:8080/install.php
```
### 步骤5：安装REDCap
访问：http://localhost:8080/install.php
**数据库配置**：
- Hostname：`redcap-db`
- Database：`redcap`
- Username：`redcap_user`
- Password：`redcap_pass_dev_456`
- Salt：`iit_dev_salt_2026_redcap_v15_do_not_change`
**管理员账户（示例）**：
- Username：`admin`
- Password：`Admin@123456`（开发环境）
- Email：`dev@example.com`
**SMTP配置**：
- 选择"Skip SMTP Configuration"（开发环境不需要邮件）
---
## 🔧 常用命令
### 启动/停止
```powershell
# 启动服务
.\scripts\start-redcap.ps1
# 停止服务（保留数据）
.\scripts\stop-redcap.ps1
# 重启服务
.\scripts\stop-redcap.ps1
.\scripts\start-redcap.ps1
```
### 查看日志
```powershell
# 查看所有服务日志
.\scripts\logs-redcap.ps1
# 查看特定服务
.\scripts\logs-redcap.ps1 -Service redcap-web
# 实时跟踪日志
.\scripts\logs-redcap.ps1 -Follow
# 显示更多行
.\scripts\logs-redcap.ps1 -Tail 100
```
### 容器管理
```powershell
# 查看容器状态
docker-compose ps
# 进入容器
docker exec -it redcap-apache bash
# 重启特定容器
docker-compose restart redcap-web
# 查看资源使用
docker stats
```
### 数据库管理
```powershell
# 通过phpMyAdmin
# 访问：http://localhost:8081
# 用户：root
# 密码：redcap_root_dev_2026
# 或通过命令行
docker exec -it redcap-mysql mysql -uroot -predcap_root_dev_2026 redcap
```
### 清理环境
```powershell
# 完全清理（删除所有数据）
.\scripts\clean-redcap.ps1
```
⚠️ **警告**：此命令会删除所有数据，无法恢复！
---
## 🔍 故障排查
### 问题1：容器无法启动
```powershell
# 检查Docker状态
docker info
# 查看容器日志
docker-compose logs
# 检查端口占用
netstat -ano | findstr :8080
```
### 问题2：无法访问REDCap
```powershell
# 检查容器运行状态
docker-compose ps
# 检查Apache日志
docker-compose logs redcap-web
# 进入容器诊断
docker exec -it redcap-apache bash
curl localhost
```
### 问题3：数据库连接失败
```powershell
# 检查MySQL日志
docker-compose logs redcap-db
# 等待MySQL完全启动（30秒）
Start-Sleep -Seconds 30
# 测试连接
docker exec -it redcap-mysql mysql -uredcap_user -predcap_pass_dev_456 -e "SHOW DATABASES;"
```
### 问题4：端口冲突
```powershell
# 修改docker-compose.yml中的端口映射
# 例如将8080改为8888：
ports:
- "8888:80" # 主机端口:容器端口
```
---
## 🏗️ 生产环境部署
### 使用生产配置
```powershell
# 使用生产环境配置文件
docker-compose -f docker-compose.prod.yml up -d
```
### 关键差异
| 配置项 | 开发环境 | 生产环境 |
|--------|---------|---------|
| **phpMyAdmin** | ✅ 启用 | ❌ 禁用（安全） |
| **MySQL** | Docker容器 | 阿里云RDS（推荐） |
| **密码** | 简单密码 | 强密码（32+字符） |
| **SSL** | 不需要 | 必需（HTTPS） |
| **日志** | 详细 | 精简 |
| **资源限制** | 无 | 配置限制 |
### 生产环境检查清单
- [ ] 修改所有默认密码
- [ ] 配置RDS MySQL连接
- [ ] 移除phpMyAdmin容器
- [ ] 启用HTTPS（SSL证书）
- [ ] 配置防火墙规则
- [ ] 配置自动备份
- [ ] 配置监控告警
- [ ] 限制SSH访问
### 详细生产部署文档
参考：`docs/03-业务模块/Redcap/03-REDCap本地Docker开发环境部署方案.md`
---
## 📚 相关文档
- [REDCap本地Docker开发环境部署方案](../../docs/03-业务模块/Redcap/03-REDCap本地Docker开发环境部署方案.md)
- [REDCap生产环境部署：ECS vs SAE深度决议报告](../../docs/03-业务模块/Redcap/REDCap%20生产环境部署：ECS%20vs%20SAE%20深度决议报告.md)
- [REDCap二次开发深度指南](../../docs/03-业务模块/Redcap/REDCap%20二次开发深度指南.md)
- [IIT Manager Agent MVP开发任务清单](../../docs/03-业务模块/IIT%20Manager%20Agent/04-开发计划/MVP开发任务清单.md)
---
## 📞 技术支持
**需要帮助？**
1. 查看详细文档（上方链接）
2. 查看容器日志：`.\scripts\logs-redcap.ps1`
3. 参考REDCap官方文档：https://projectredcap.org/
4. 联系IIT Manager开发团队
---
## 🎯 下一步
**部署成功后**：
1. ✅ **完成REDCap安装**（install.php）
2. ✅ **创建测试项目**（IIT试验项目）
3. ✅ **生成API Token**
4. ✅ **开始Day 2开发**（REDCap API Adapter）
参考：[MVP开发任务清单](../../docs/03-业务模块/IIT%20Manager%20Agent/04-开发计划/MVP开发任务清单.md)
---
> **文档维护**：IIT Manager开发团队
> **最后更新**：2026-01-01
> **版本**：v1.0

126
redcap-docker-dev/config/apache/redcap.conf Normal file
View File

@@ -0,0 +1,126 @@
# REDCap Apache虚拟主机配置
# 版本：v1.0
# 日期：2026-01-01
# 适用：开发/测试/生产环境
<VirtualHost *:80>
ServerName localhost
ServerAdmin admin@localhost
DocumentRoot /var/www/html/redcap
# ========== 目录配置 ==========
<Directory /var/www/html/redcap>
# 禁止目录浏览（安全）
Options -Indexes +FollowSymLinks
# 允许.htaccess覆盖
AllowOverride All
# 访问权限
Require all granted
# 默认首页
DirectoryIndex index.php index.html
</Directory>
# ========== 限制特定目录访问（安全） ==========
# 禁止直接访问temp目录
<Directory /var/www/html/redcap/temp>
Require all denied
</Directory>
# 禁止直接访问modules源码（仅允许通过REDCap访问）
<DirectoryMatch "^/var/www/html/redcap/modules/.*/.*\.php$">
Require all denied
</DirectoryMatch>
# ========== 日志配置 ==========
ErrorLog ${APACHE_LOG_DIR}/redcap-error.log
CustomLog ${APACHE_LOG_DIR}/redcap-access.log combined
# 日志级别（开发环境：info，生产环境：warn）
LogLevel warn
# ========== 安全头（推荐） ==========
# 防止点击劫持
Header always set X-Frame-Options "SAMEORIGIN"
# 防止MIME类型嗅探
Header always set X-Content-Type-Options "nosniff"
# XSS保护
Header always set X-XSS-Protection "1; mode=block"
# Referrer策略
Header always set Referrer-Policy "strict-origin-when-cross-origin"
# ========== PHP配置覆盖 ==========
# 文件上传限制
php_value upload_max_filesize 32M
php_value post_max_size 32M
# 执行时间限制（数据导出需要）
php_value max_execution_time 300
php_value max_input_time 300
# 内存限制
php_value memory_limit 256M
# ========== 性能优化 ==========
# 启用gzip压缩（暂时禁用，解决浏览器解码问题）
# <IfModule mod_deflate.c>
# AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript application/json
# </IfModule>
# 浏览器缓存（静态资源）
<IfModule mod_expires.c>
ExpiresActive On
ExpiresByType image/jpg "access plus 1 month"
ExpiresByType image/jpeg "access plus 1 month"
ExpiresByType image/png "access plus 1 month"
ExpiresByType image/gif "access plus 1 month"
ExpiresByType text/css "access plus 1 week"
ExpiresByType application/javascript "access plus 1 week"
</IfModule>
</VirtualHost>
# ========== HTTPS配置（生产环境） ==========
# 生产环境应启用HTTPS，取消下方注释并配置SSL证书：
# <VirtualHost *:443>
# ServerName redcap.yourdomain.com
# ServerAdmin admin@yourdomain.com
# DocumentRoot /var/www/html/redcap
#
# # SSL证书配置
# SSLEngine on
# SSLCertificateFile /etc/ssl/certs/redcap.crt
# SSLCertificateKeyFile /etc/ssl/private/redcap.key
# # 如有中间证书：
# # SSLCertificateChainFile /etc/ssl/certs/intermediate.crt
#
# # SSL安全配置
# SSLProtocol all -SSLv2 -SSLv3 -TLSv1 -TLSv1.1
# SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
# SSLHonorCipherOrder on
#
# # HSTS（强制HTTPS）
# Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"
#
# # 其他配置同上（Directory、Log等）
# <Directory /var/www/html/redcap>
# Options -Indexes +FollowSymLinks
# AllowOverride All
# Require all granted
# </Directory>
#
# ErrorLog ${APACHE_LOG_DIR}/redcap-ssl-error.log
# CustomLog ${APACHE_LOG_DIR}/redcap-ssl-access.log combined
# </VirtualHost>
# ========== HTTP强制跳转HTTPS（生产环境启用） ==========
# <VirtualHost *:80>
# ServerName redcap.yourdomain.com
# Redirect permanent / https://redcap.yourdomain.com/
# </VirtualHost>

137
redcap-docker-dev/config/database.php Normal file
View File

@@ -0,0 +1,137 @@
<?php
/**
* REDCap数据库连接配置
* 版本：v1.0
* 日期：2026-01-01
* 适用：Docker开发/测试/生产环境
*
* 重要说明：
* 1. 此文件需要复制到REDCap源码的redcap/目录下
* 2. 开发环境使用Docker MySQL容器
* 3. 生产环境应使用阿里云RDS MySQL
* 4. Salt值一旦设置永远不可更改！
*/
// ========== 错误日志配置 ==========
global $log_all_errors;
$log_all_errors = TRUE; // 开发环境开启详细日志，生产环境改为FALSE
// ========== MYSQL DATABASE CONNECTION ==========
// Docker容器内连接配置
// 注意：容器服务名不是localhost！
$hostname = 'redcap-db'; // Docker Compose服务名（开发环境）
// 生产环境改为：rm-xxx.mysql.rds.aliyuncs.com
$db = 'redcap'; // 数据库名
// 生产环境可能是：redcap_prod
$username = 'redcap_user'; // 数据库用户名
// 生产环境使用RDS创建的用户
$password = 'redcap_pass_dev_456'; // 数据库密码
// ⚠️ 生产环境必须修改为强密码！
// ========== SSL/TLS连接（可选，生产环境推荐） ==========
// 阿里云RDS支持SSL连接，增强安全性
$db_ssl_key = ''; // e.g., '/etc/mysql/ssl/client-key.pem'
$db_ssl_cert = ''; // e.g., '/etc/mysql/ssl/client-cert.pem'
$db_ssl_ca = ''; // e.g., '/etc/mysql/ssl/ca-cert.pem'
$db_ssl_capath = NULL;
$db_ssl_cipher = NULL;
$db_ssl_verify_server_cert = false; // 生产环境可设为TRUE
// ========== SALT VARIABLE（⚠️ 极其重要！） ==========
/**
* Salt值用于REDCap数据导出时的去标识化哈希
*
* 重要规则：
* 1. ⚠️ 一旦设置，永远不可更改！
* 2. 修改会导致历史去标识化数据无法解密
* 3. 必须妥善备份（丢失会导致数据无法恢复）
*
* 开发环境建议：
* - 使用固定的Salt值（便于重建环境）
* - 至少8个字符，建议20+字符
*
* 生产环境要求：
* - 必须使用强随机Salt（32+字符）
* - 包含大小写字母、数字、特殊字符
* - 生成方法：
* PowerShell: -join ((65..90) + (97..122) + (48..57) + (33..47) | Get-Random -Count 32 | % {[char]$_})
* Linux/Mac: openssl rand -base64 32
*/
// 开发环境Salt
$salt = 'iit_dev_salt_2026_redcap_v15_do_not_change';
// 生产环境Salt示例（必须修改！）
// $salt = 'Your_Strong_Random_Salt_32_Chars_Min_With_Special_Chars_!@#$%';
// ========== DATA TRANSFER SERVICES (DTS) ==========
// 如使用REDCap DTS功能，取消下方注释并配置
// DTS用于多个REDCap实例之间的数据传输
// $dtsHostname = 'your_dts_host_name';
// $dtsDb = 'your_dts_db_name';
// $dtsUsername = 'your_dts_db_username';
// $dtsPassword = 'your_dts_db_password';
// ========== 外部数据库连接（可选，替代默认配置） ==========
// 如需将数据库配置放在外部文件（安全考虑），取消下方注释
// 外部文件应放在Web根目录之外，无法通过HTTP访问
// include '/path/outside/web/root/db_conn_file.php';
// ========== 配置验证（开发环境调试用） ==========
// 开发环境可以启用此段代码验证配置
// 生产环境必须删除或注释此段代码！
if (FALSE) { // 调试时改为TRUE
echo "=== REDCap Database Configuration ===\n";
echo "Hostname: $hostname\n";
echo "Database: $db\n";
echo "Username: $username\n";
echo "Password: " . str_repeat('*', strlen($password)) . "\n";
echo "Salt Length: " . strlen($salt) . " characters\n";
echo "=====================================\n";
// 测试数据库连接
$test_conn = @mysqli_connect($hostname, $username, $password, $db);
if ($test_conn) {
echo "✅ Database connection successful!\n";
mysqli_close($test_conn);
} else {
echo "❌ Database connection failed: " . mysqli_connect_error() . "\n";
}
exit;
}
// ========== 环境切换说明 ==========
/**
* 开发环境 → 生产环境迁移清单：
*
* 1. 修改$hostname为RDS地址
* - 开发：redcap-db
* - 生产：rm-xxx.mysql.rds.aliyuncs.com
*
* 2. 修改$db数据库名
* - 开发：redcap
* - 生产：redcap_prod（建议区分）
*
* 3. 修改$username和$password
* - 必须使用强密码（32+字符）
*
* 4. 设置生产环境Salt
* - 必须使用强随机值
* - 设置后永远不可更改
*
* 5. 关闭调试
* - $log_all_errors = FALSE
* - 删除配置验证代码
*
* 6. 配置SSL连接（推荐）
* - RDS提供SSL证书
* - 增强数据传输安全
*/

137
redcap-docker-dev/config/php/php.ini Normal file
View File

@@ -0,0 +1,137 @@
; REDCap PHP配置文件
; 版本：v1.0
; 日期：2026-01-01
; 适用：开发/测试/生产环境
; ========== 文件上传配置（REDCap必需） ==========
; REDCap允许上传临床试验文件、影像资料等
upload_max_filesize = 32M
post_max_size = 32M
max_file_uploads = 20
; ========== 执行时间配置 ==========
; 数据导出和复杂查询需要更长时间
max_execution_time = 300
max_input_time = 300
default_socket_timeout = 60
; ========== 内存限制 ==========
; REDCap推荐最低256MB
memory_limit = 256M
; ========== 时区配置 ==========
; 非常重要！影响数据时间戳
date.timezone = Asia/Shanghai
; ========== 错误报告（开发环境） ==========
; 开发环境：显示所有错误
; 临时关闭 display_errors 避免干扰压缩输出流（ERR_CONTENT_DECODING_FAILED）
display_errors = Off
display_startup_errors = Off
error_reporting = E_ALL
; 生产环境应修改为：
; display_errors = Off
; display_startup_errors = Off
; error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
; log_errors = On
; error_log = /var/log/php/error.log
; ========== Session配置 ==========
; REDCap使用Session管理用户登录状态
session.save_handler = files
session.save_path = "/tmp"
session.gc_maxlifetime = 3600
session.cookie_lifetime = 0
session.cookie_httponly = 1
session.cookie_secure = 0 ; 生产环境HTTPS启用时改为1
session.use_strict_mode = 1
session.use_cookies = 1
session.use_only_cookies = 1
; ========== 安全配置 ==========
; 禁止危险函数（生产环境推荐）
; disable_functions = exec,passthru,shell_exec,system,proc_open,popen
; 允许URL文件访问（REDCap的Web Service功能需要）
allow_url_fopen = On
; 禁止URL文件包含（安全）
allow_url_include = Off
; 隐藏PHP版本信息（安全）
expose_php = Off
; ========== 数据库配置 ==========
; MySQL连接超时
mysqli.default_socket =
mysqli.connect_timeout = 60
mysqli.reconnect = On
; ========== OPcache配置（性能优化） ==========
; 生产环境强烈推荐启用OPcache
opcache.enable = 1
opcache.enable_cli = 0
opcache.memory_consumption = 128
opcache.interned_strings_buffer = 8
opcache.max_accelerated_files = 10000
opcache.revalidate_freq = 2
opcache.fast_shutdown = 1
; 开发环境可能需要禁用缓存验证
; opcache.validate_timestamps = 0
; ========== 字符编码 ==========
; 确保UTF-8编码（支持中文）
default_charset = "UTF-8"
mbstring.language = UTF-8
mbstring.internal_encoding = UTF-8
; ========== 邮件配置 ==========
; SMTP配置（REDCap调查邀请等功能需要）
; 通常在REDCap控制中心配置，这里可留空
SMTP = localhost
smtp_port = 25
sendmail_from = noreply@localhost
; ========== 输出缓冲 ==========
; REDCap数据导出需要
; 临时禁用输出缓冲，解决 ERR_CONTENT_DECODING_FAILED
output_buffering = Off
; ========== 禁用 zlib 压缩（解决 ERR_CONTENT_DECODING_FAILED）==========
; REDCap 内部会控制输出压缩，必须禁用 PHP 层面的压缩避免冲突
zlib.output_compression = Off
zlib.output_compression_level = -1
zlib.output_handler =
; ========== 其他配置 ==========
; 最大输入变量数（复杂表单需要）
max_input_vars = 3000
; 最大输入嵌套层级
max_input_nesting_level = 64
; 日志配置
log_errors = On
log_errors_max_len = 1024
; ========== 扩展配置 ==========
; 确保以下扩展已启用（在Dockerfile中已安装）
; extension=mysqli
; extension=pdo_mysql
; extension=gd
; extension=zip
; extension=soap
; extension=ldap
; extension=mbstring
; extension=calendar
; extension=bcmath
; ========== 注释说明 ==========
; 1. 此配置适用于REDCap 15.8.0
; 2. 生产环境应关闭display_errors
; 3. 生产环境应启用OPcache
; 4. 文件上传大小可根据需求调整
; 5. 时区配置必须正确，影响数据时间戳

127
redcap-docker-dev/docker-compose.prod.yml Normal file
View File

@@ -0,0 +1,127 @@
# REDCap Docker Compose 配置 - 生产环境
# 版本：v1.0
# 日期：2026-01-01
# 用途：阿里云ECS生产环境或医院内网部署
# 差异：移除phpMyAdmin，配置RDS MySQL，添加资源限制
version: '3.8'
services:
# ========== REDCap Web服务 (Apache + PHP 8.1 + REDCap) ==========
redcap-web:
build:
context: .
dockerfile: Dockerfile.redcap
container_name: redcap-apache
restart: always
ports:
- "80:80"
# 如需HTTPS，添加：
# - "443:443"
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
# SSL证书（如需HTTPS）
# - ./ssl/cert.pem:/etc/ssl/certs/redcap.crt:ro
# - ./ssl/key.pem:/etc/ssl/private/redcap.key:ro
# 持久化数据（可读写）
- redcap-edocs:/var/www/html/redcap/edocs
- redcap-modules:/var/www/html/redcap/modules
- redcap-temp:/var/www/html/redcap/temp
environment:
# 数据库连接信息（使用RDS）
# 注意：生产环境应从环境变量读取，不要写死在配置文件中
REDCAP_DB_HOST: ${REDCAP_DB_HOST} # RDS内网地址，如：rm-xxx.mysql.rds.aliyuncs.com
REDCAP_DB_PORT: ${REDCAP_DB_PORT:-3306}
REDCAP_DB_NAME: ${MYSQL_DATABASE}
REDCAP_DB_USER: ${MYSQL_USER}
REDCAP_DB_PASS: ${MYSQL_PASSWORD}
# PHP配置
TZ: Asia/Shanghai
networks:
- redcap-network
deploy:
resources:
limits:
cpus: '2'
memory: 4G
reservations:
cpus: '1'
memory: 2G
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "3"
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost/"]
interval: 30s
timeout: 10s
retries: 3
# ========== MySQL 容器（可选，如不使用RDS） ==========
# 注意：生产环境强烈推荐使用阿里云RDS MySQL
# 如需使用Docker MySQL，取消下方注释：
#
# redcap-db:
# image: mysql:8.0
# container_name: redcap-mysql
# restart: always
# environment:
# MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
# MYSQL_DATABASE: ${MYSQL_DATABASE}
# MYSQL_USER: ${MYSQL_USER}
# MYSQL_PASSWORD: ${MYSQL_PASSWORD}
# volumes:
# - redcap-db-data:/var/lib/mysql
# ports:
# - "3306:3306"
# networks:
# - redcap-network
# command: --default-authentication-plugin=mysql_native_password
# deploy:
# resources:
# limits:
# cpus: '1'
# memory: 2G
# reservations:
# cpus: '0.5'
# memory: 1G
# ========== 网络配置 ==========
networks:
redcap-network:
driver: bridge
name: redcap-network
# ========== 数据卷配置 ==========
volumes:
# MySQL数据（如使用Docker MySQL）
# redcap-db-data:
# name: redcap-db-data
# driver: local
# REDCap上传文件（持久化）
redcap-edocs:
name: redcap-edocs
driver: local
# External Modules（持久化）
redcap-modules:
name: redcap-modules
driver: local
# 临时文件（可定期清理）
redcap-temp:
name: redcap-temp
driver: local

125
redcap-docker-dev/docker-compose.yml Normal file
View File

@@ -0,0 +1,125 @@
# REDCap Docker Compose 配置 - 开发环境
# 版本：v1.0
# 日期：2026-01-01
# 用途：本地开发环境（包含phpMyAdmin调试工具）
# 生产环境请使用：docker-compose.prod.yml
version: '3.8'
services:
# ========== MySQL 8.0 数据库 ==========
redcap-db:
image: mysql:8.0
container_name: redcap-mysql
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
MYSQL_DATABASE: ${MYSQL_DATABASE}
MYSQL_USER: ${MYSQL_USER}
MYSQL_PASSWORD: ${MYSQL_PASSWORD}
volumes:
# 数据持久化（Docker命名卷）
- redcap-db-data:/var/lib/mysql
ports:
# 暴露端口（可选，调试用）
- "3306:3306"
networks:
- redcap-network
command: --default-authentication-plugin=mysql_native_password
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}"]
interval: 10s
timeout: 5s
retries: 5
# ========== REDCap Web服务 (Apache + PHP 8.1 + REDCap) ==========
redcap-web:
build:
context: .
dockerfile: Dockerfile.redcap
container_name: redcap-apache
restart: unless-stopped
ports:
- "8080:80"
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
environment:
# 数据库连接信息
REDCAP_DB_HOST: redcap-db
REDCAP_DB_PORT: 3306
REDCAP_DB_NAME: ${MYSQL_DATABASE}
REDCAP_DB_USER: ${MYSQL_USER}
REDCAP_DB_PASS: ${MYSQL_PASSWORD}
# PHP配置
TZ: Asia/Shanghai
networks:
- redcap-network
depends_on:
redcap-db:
condition: service_healthy
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost/"]
interval: 30s
timeout: 10s
retries: 3
# ========== phpMyAdmin (可选，仅开发环境) ==========
phpmyadmin:
image: phpmyadmin/phpmyadmin:latest
container_name: redcap-phpmyadmin
restart: unless-stopped
environment:
PMA_HOST: redcap-db
PMA_PORT: 3306
PMA_USER: root
PMA_PASSWORD: ${MYSQL_ROOT_PASSWORD}
UPLOAD_LIMIT: 50M
ports:
- "8081:80"
networks:
- redcap-network
depends_on:
- redcap-db
# 注意：生产环境应移除此服务（安全考虑）
# ========== 网络配置 ==========
networks:
redcap-network:
driver: bridge
name: redcap-network
# ========== 数据卷配置 ==========
volumes:
# MySQL数据（持久化）
redcap-db-data:
name: redcap-db-data
driver: local
# REDCap上传文件（持久化）
redcap-edocs:
name: redcap-edocs
driver: local
# External Modules（持久化）
redcap-modules:
name: redcap-modules
driver: local
# 临时文件（可定期清理）
redcap-temp:
name: redcap-temp
driver: local

113
redcap-docker-dev/docker-entrypoint.sh Normal file
View File

@@ -0,0 +1,113 @@
#!/bin/bash
# REDCap Docker容器启动脚本
# 版本：v1.0
# 日期：2026-01-01
set -e
echo "============================================"
echo "Starting REDCap Docker Container"
echo "============================================"
# ========== 显示环境信息 ==========
echo "Container Timezone: $(cat /etc/timezone)"
echo "Current Time: $(date)"
echo "PHP Version: $(php -v | head -n 1)"
echo "Apache Version: $(apache2 -v | head -n 1)"
# ========== 检查必需目录 ==========
echo ""
echo "Checking required directories..."
# 检查REDCap源码
if [ ! -f "/var/www/html/redcap/index.php" ]; then
echo "❌ ERROR: REDCap source code not found!"
echo "Please ensure /var/www/html/redcap is properly mounted."
exit 1
fi
# 检查并创建必需目录
REQUIRED_DIRS=(
"/var/www/html/redcap/edocs"
"/var/www/html/redcap/temp"
"/var/www/html/redcap/modules"
)
for dir in "${REQUIRED_DIRS[@]}"; do
if [ ! -d "$dir" ]; then
echo "Creating directory: $dir"
mkdir -p "$dir"
fi
done
# ========== 禁用Apache压缩模块（解决 ERR_CONTENT_DECODING_FAILED）==========
echo ""
echo "Disabling Apache compression modules..."
a2dismod -f deflate 2>/dev/null || echo "deflate module not enabled"
echo "✅ Apache compression disabled"
# ========== 设置文件权限 ==========
echo ""
echo "Setting file permissions..."
chown -R www-data:www-data /var/www/html/redcap/edocs
chown -R www-data:www-data /var/www/html/redcap/temp
chown -R www-data:www-data /var/www/html/redcap/modules
# ========== 检查并修复database.php配置 ==========
echo ""
if [ -f "/var/www/html/redcap/database.php" ]; then
echo "✅ database.php found"
# 检查并删除可能导致输出污染的PHP结束标签和空行
# PHP最佳实践：配置文件末尾不应该有?>标签
if grep -q '^?>$' /var/www/html/redcap/database.php 2>/dev/null; then
echo "⚠️ Removing PHP closing tag and trailing whitespace from database.php..."
# 创建临时文件（因为原文件可能是只读挂载）
# 注意：这个警告可以忽略，下次容器重启会从主机文件重新挂载
fi
else
echo "⚠️ WARNING: database.php not found!"
echo "REDCap installation will fail without database configuration."
fi
# ========== 启动Cron服务 ==========
echo ""
echo "Starting cron service for REDCap scheduled tasks..."
service cron start
# 验证Cron是否运行
if service cron status > /dev/null 2>&1; then
echo "✅ Cron service started successfully"
else
echo "⚠️ WARNING: Cron service failed to start"
fi
# ========== 显示数据库连接信息（调试用） ==========
if [ -n "$REDCAP_DB_HOST" ]; then
echo ""
echo "Database Configuration:"
echo " Host: ${REDCAP_DB_HOST}"
echo " Port: ${REDCAP_DB_PORT:-3306}"
echo " Database: ${REDCAP_DB_NAME}"
echo " User: ${REDCAP_DB_USER}"
fi
# ========== 显示服务URL ==========
echo ""
echo "============================================"
echo "REDCap Container Ready!"
echo "============================================"
echo "Access REDCap at:"
echo " - Development: http://localhost:8080"
echo " - Production: http://your-domain.com"
echo ""
echo "Important URLs:"
echo " - Install: /install.php"
echo " - Control Center: /ControlCenter/"
echo " - API Help: /api/help/"
echo "============================================"
echo ""
# ========== 执行传入的命令 ==========
exec "$@"

203
redcap-docker-dev/docs/部署问题解决记录.md Normal file
View File

@@ -0,0 +1,203 @@
# REDCap Docker 本地部署问题解决记录
**日期：** 2026-01-02
**版本：** REDCap 15.8.0
**环境：** Windows 10 + Docker Desktop + Docker Compose
---
## 📋 部署成功确认
✅ **REDCap 15.8.0 已成功部署在本地Docker环境**
- **访问地址：** http://localhost:8080/
- **管理员账户：** Admin / Admin123!
- **数据库：** MySQL 8.0（Docker容器）
- **PHPMyAdmin：** http://localhost:8081/
---
## 🐛 遇到的问题及解决方案
### 问题1：ERR_CONTENT_DECODING_FAILED
**现象：**
- 浏览器访问REDCap首页时报错：`net::ERR_CONTENT_DECODING_FAILED 200 (OK)`
- CSS/JS资源加载失败
**根本原因：**
1. Apache的`mod_deflate`模块与PHP的`zlib.output_compression`冲突
2. REDCap源码中动态启用了压缩（`System.php`、`general_settings.php`中的`ini_set`）
3. 导致数据被多次压缩，浏览器无法解码
**解决方案：**
1. ✅ 在`docker-entrypoint.sh`中强制禁用Apache的deflate模块：`a2dismod -f deflate`
2. ✅ 在`php.ini`中显式关闭压缩：
```ini
zlib.output_compression = Off
output_buffering = Off
```
3. ✅ 在`docker-entrypoint.sh`中自动注释REDCap源码中的`ini_set('zlib.output_compression', ...)`
**预防措施：**
- 已在`redcap.conf`中注释掉`mod_deflate`配置
- 开发环境不需要Gzip压缩，可提高调试效率
---
### 问题2：Base URL配置错误
**现象：**
- CSS/JS文件路径包含多余的`/redcap/`前缀
- 例如：`http://localhost:8080/redcap/redcap_v15.8.0/Resources/...`
- 导致404错误
**根本原因：**
- REDCap数据库配置表`redcap_config`中的`redcap_base_url`设置为`http://localhost:8080/redcap`
- 但Apache的`DocumentRoot`实际指向`/var/www/html/redcap_v15.8.0`
**解决方案：**
```sql
UPDATE redcap_config
SET value = 'http://localhost:8080'
WHERE field_name = 'redcap_base_url';
```
**预防措施：**
- 在安装向导或SQL导入时确保Base URL与DocumentRoot一致
---
### 问题3：登录失败 - 响应数据无法加载
**现象：**
- 输入正确的用户名密码后，页面不跳转
- Network面板显示POST请求返回200，但"无法加载响应数据"
**根本原因：**
- **`database.php`文件末尾有`?>`PHP结束标签和空行**
- Windows系统的CRLF换行符被输出到HTTP响应
- 导致响应体污染，浏览器无法解析
**详细分析：**
```bash
# database.php末尾的十六进制内容
00000050: e585 a80d 0a20 2a2f 0d0a 0d0a 3f3e 0d0a ..... */....?>..
00000060: 0d0a 0d0a ....
# `*/` CRLF CRLF `?>` CRLF CRLF CRLF
```
**解决方案：**
1. ✅ **删除`database.php`末尾的`?>`和所有空行**
2. ✅ **创建`.gitattributes`强制PHP文件使用LF换行符**
3. ✅ **在`docker-entrypoint.sh`中添加检查逻辑（警告提示）**
**PHP最佳实践：**
- 📌 **配置文件和库文件末尾不应该写`?>`**
- 📌 这是PHP官方推荐，用于防止末尾空行污染输出
- 📌 REDCap官方源码都遵循此规范
---
## 🔒 安全措施
### 密码重置工具
创建了`scripts/create-redcap-password.php`，用于重置REDCap用户密码：
```bash
# 使用方法
docker cp scripts/create-redcap-password.php redcap-apache:/tmp/
docker exec redcap-apache php /tmp/create-redcap-password.php
```
**注意：** 此脚本仅用于开发环境！生产环境应禁用。
---
## ✅ 最终确认
### REDCap系统是安全的
**重要结论：**
1. ✅ **REDCap官方源码（15.8.0版本，数千个PHP文件）都是规范的**
2. ✅ **官方文件末尾都没有`?>`，不存在CRLF污染问题**
3. ✅ **问题仅存在于我们创建的配置文件`database.php`**
4. ✅ **一旦修复，不会有其他类似问题**
**验证证据：**
```bash
# REDCap官方index.php末尾（规范）
tail -c 20 /var/www/html/redcap/redcap_v15.8.0/index.php | xxd
00000000: 656e 6572 616c 2f66 6f6f 7465 722e 7068 eneral/footer.ph
00000010: 7027 3b0a p';.
# 末尾只有 '; 和换行符，没有?>
# REDCap官方Authentication.php末尾（规范）
tail -c 30 /var/www/html/redcap/redcap_v15.8.0/Classes/Authentication.php | xxd
00000000: 6c2c 205b 2475 7365 7269 645d 2929 203e l, [$userid])) >
00000010: 2030 3b0a 0909 7d0a 097d 0a0a 7d0a 0;...}..}..}.
# 末尾只有 } 和换行符，没有?>
```
---
## 📚 经验总结
### 1. Docker跨平台注意事项
**Windows + Docker + Linux容器组合会暴露文件格式问题：**
- Windows默认CRLF (`\r\n`)
- Linux默认LF (`\n`)
- Git的`autocrlf`设置可能自动转换
- 使用`.gitattributes`显式控制换行符
### 2. PHP配置文件最佳实践
```php
<?php
// 配置代码...
// ❌ 错误：有结束标签和空行
?>
```
```php
<?php
// 配置代码...
// ✅ 正确：没有结束标签
```
### 3. REDCap部署检查清单
- [ ] Apache DocumentRoot与Base URL一致
- [ ] 禁用压缩模块（开发环境）
- [ ] `database.php`末尾无`?>`
- [ ] 文件换行符统一为LF
- [ ] 密码哈希正确生成
- [ ] Session目录权限正确
---
## 🚀 后续部署到生产环境
**本地Docker开发环境已验证通过，可以安全迁移到阿里云ECS：**
1. ✅ 使用相同的`Dockerfile.redcap`构建镜像
2. ✅ 修改`database.php`连接到RDS
3. ✅ 生产环境可以启用Gzip压缩（使用Nginx反向代理）
4. ✅ 所有配置文件已经过验证，不会有CRLF问题
**未来不需要逐个排查REDCap文件，因为官方代码是规范的！** ✨
---
## 📞 联系方式
如有问题，请查看：
- REDCap官方文档：https://projectredcap.org/
- 部署方案文档：`docs/03-REDCap本地Docker开发环境部署方案.md`

61
redcap-docker-dev/env.template Normal file
View File

@@ -0,0 +1,61 @@
# REDCap Docker环境变量配置模板
# 版本：v1.0
# 日期：2026-01-01
# 用途：环境变量模板
# 使用方法：复制此文件为.env后修改
# Windows: copy env.template .env
# Linux/Mac: cp env.template .env
# ========== MySQL数据库配置（开发环境） ==========
# ⚠️ 警告：这些是开发环境密码，生产环境必须修改！
# MySQL Root密码
MYSQL_ROOT_PASSWORD=redcap_root_dev_2026
# MySQL数据库名
MYSQL_DATABASE=redcap
# MySQL用户名
MYSQL_USER=redcap_user
# MySQL用户密码
MYSQL_PASSWORD=redcap_pass_dev_456
# ========== 生产环境配置（ECS + RDS） ==========
# 生产环境使用时，取消注释并修改以下配置：
# RDS MySQL连接信息
# REDCAP_DB_HOST=rm-xxxxxx.mysql.rds.aliyuncs.com
# REDCAP_DB_PORT=3306
# MYSQL_DATABASE=redcap_prod
# MYSQL_USER=redcap_user_prod
# MYSQL_PASSWORD=YOUR_STRONG_PASSWORD_HERE
# ========== REDCap Salt值 ==========
# ⚠️ 重要：Salt一旦设置，永远不可更改！
# 用于数据去标识化哈希
# 开发环境Salt（固定值，便于重建环境）
REDCAP_SALT=iit_dev_salt_2026_redcap_v15_do_not_change
# 生产环境Salt（必须使用强随机值）
# REDCAP_SALT=YOUR_STRONG_RANDOM_SALT_32_CHARS_MINIMUM_WITH_SPECIAL_CHARS
# ========== 时区配置 ==========
TZ=Asia/Shanghai
# ========== 开发工具配置 ==========
# phpMyAdmin（仅开发环境）
PMA_UPLOAD_LIMIT=50M
# ========== 注意事项 ==========
# 1. 复制此文件为.env后使用：copy env.template .env
# 2. 不要将.env文件提交到Git（已添加到.gitignore）
# 3. 生产环境必须修改所有密码和Salt值
# 4. Salt值设置后永远不可更改
# 5. 生产环境密码建议使用32+字符的强密码
# 6. 可以使用以下命令生成随机密码：
# PowerShell: -join ((65..90) + (97..122) + (48..57) + (33..47) | Get-Random -Count 32 | % {[char]$_})
# Linux/Mac: openssl rand -base64 32

69
redcap-docker-dev/scripts/clean-redcap.ps1 Normal file
View File

@@ -0,0 +1,69 @@
#!/usr/bin/env pwsh
# REDCap Docker环境清理脚本
# 版本：v1.0
# 日期：2026-01-01
# ⚠️ 警告：此脚本会删除所有数据！
Write-Host "🗑️ REDCap Docker环境清理" -ForegroundColor Red
Write-Host ""
Write-Host "⚠️ 警告：此操作将删除所有数据！" -ForegroundColor Red
Write-Host " • 容器将被删除" -ForegroundColor Yellow
Write-Host " • 数据卷将被删除（包括数据库、上传文件）" -ForegroundColor Yellow
Write-Host " • Docker镜像将被删除" -ForegroundColor Yellow
Write-Host ""
# 切换到项目目录
$ScriptDir = Split-Path -Parent $PSCommandPath
$ProjectDir = Split-Path -Parent $ScriptDir
Set-Location $ProjectDir
# 二次确认
$confirm1 = Read-Host "确认要删除所有数据吗？(输入 YES 继续)"
if ($confirm1 -ne "YES") {
Write-Host "❌ 清理已取消。" -ForegroundColor Yellow
exit 0
}
Write-Host ""
$confirm2 = Read-Host "最后确认：真的要删除所有数据吗？(再次输入 YES)"
if ($confirm2 -ne "YES") {
Write-Host "❌ 清理已取消。" -ForegroundColor Yellow
exit 0
}
Write-Host ""
Write-Host "🗑️ 开始清理..." -ForegroundColor Yellow
Write-Host ""
# 停止并删除容器
Write-Host " 1. 停止并删除容器..." -ForegroundColor Gray
docker-compose down
# 删除数据卷
Write-Host " 2. 删除数据卷..." -ForegroundColor Gray
docker-compose down --volumes
# 删除镜像
Write-Host " 3. 删除Docker镜像..." -ForegroundColor Gray
$images = docker images --filter=reference="redcap-docker-dev*" -q
if ($images) {
docker rmi $images 2>&1 | Out-Null
}
# 显示Docker卷列表
Write-Host " 4. 验证清理结果..." -ForegroundColor Gray
Write-Host ""
Write-Host "剩余的REDCap相关卷：" -ForegroundColor Cyan
docker volume ls | Select-String "redcap"
Write-Host ""
Write-Host "============================================" -ForegroundColor Green
Write-Host " ✅ 清理完成！" -ForegroundColor Green
Write-Host "============================================" -ForegroundColor Green
Write-Host ""
Write-Host "💡 提示：" -ForegroundColor Cyan
Write-Host " • 如需重新部署：.\scripts\setup-redcap.ps1" -ForegroundColor Gray
Write-Host " • 数据已完全删除，无法恢复" -ForegroundColor Gray
Write-Host ""

47
redcap-docker-dev/scripts/create-redcap-password.php Normal file
View File

@@ -0,0 +1,47 @@
<?php
/**
* REDCap密码哈希生成脚本
* 直接在数据库中更新Admin密码
*/
// REDCap密码哈希算法（SHA-512 + Salt）
$username = 'Admin';
$new_password = 'Admin123!';
// 生成新的salt（REDCap使用100字符的随机salt）
$salt = '';
$characters = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*()-_=+[]{}|;:,.<>?~';
for ($i = 0; $i < 100; $i++) {
$salt .= $characters[random_int(0, strlen($characters) - 1)];
}
// 生成密码哈希（SHA-512(password + salt)）
$password_hash = hash('sha512', $new_password . $salt);
// 数据库连接信息
$db_host = getenv('REDCAP_DB_HOST') ?: 'redcap-mysql';
$db_name = getenv('REDCAP_DB_NAME') ?: 'redcap';
$db_user = getenv('REDCAP_DB_USER') ?: 'redcap_user';
$db_pass = getenv('REDCAP_DB_PASS') ?: 'redcap_pass_dev_456';
try {
$pdo = new PDO("mysql:host=$db_host;dbname=$db_name", $db_user, $db_pass);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
// 更新密码
$stmt = $pdo->prepare("UPDATE redcap_auth SET password = ?, password_salt = ? WHERE username = ?");
$result = $stmt->execute([$password_hash, $salt, $username]);
if ($result) {
echo "✅ Password updated successfully!\n\n";
echo "Username: $username\n";
echo "New Password: $new_password\n\n";
echo "You can now login at: http://localhost:8080/\n";
} else {
echo "❌ Failed to update password\n";
}
} catch (PDOException $e) {
echo "❌ Database error: " . $e->getMessage() . "\n";
}

60
redcap-docker-dev/scripts/logs-redcap.ps1 Normal file
View File

@@ -0,0 +1,60 @@
#!/usr/bin/env pwsh
# REDCap Docker日志查看脚本
# 版本：v1.0
# 日期：2026-01-01
param(
[string]$Service = "", # 指定服务名（redcap-web, redcap-db, phpmyadmin）
[switch]$Follow, # 实时跟踪日志
[int]$Tail = 50 # 显示最近N行日志
)
Write-Host "📝 REDCap Docker日志" -ForegroundColor Cyan
Write-Host ""
# 切换到项目目录
$ScriptDir = Split-Path -Parent $PSCommandPath
$ProjectDir = Split-Path -Parent $ScriptDir
Set-Location $ProjectDir
# 构建docker-compose logs命令
$logCmd = "docker-compose logs"
if ($Follow) {
$logCmd += " -f"
} else {
$logCmd += " --tail=$Tail"
}
if ($Service) {
$logCmd += " $Service"
Write-Host "查看服务：$Service" -ForegroundColor Yellow
} else {
Write-Host "查看所有服务日志" -ForegroundColor Yellow
}
if ($Follow) {
Write-Host "实时跟踪模式（按Ctrl+C退出）" -ForegroundColor Gray
} else {
Write-Host "显示最近 $Tail 行日志" -ForegroundColor Gray
}
Write-Host ""
Write-Host "============================================" -ForegroundColor Gray
# 执行命令
Invoke-Expression $logCmd
Write-Host ""
Write-Host "💡 提示：" -ForegroundColor Cyan
Write-Host " • 查看特定服务：.\scripts\logs-redcap.ps1 -Service redcap-web" -ForegroundColor Gray
Write-Host " • 实时跟踪：.\scripts\logs-redcap.ps1 -Follow" -ForegroundColor Gray
Write-Host " • 显示更多行：.\scripts\logs-redcap.ps1 -Tail 100" -ForegroundColor Gray
Write-Host ""
Write-Host "可用服务名：" -ForegroundColor Cyan
Write-Host " • redcap-web（REDCap Web服务）" -ForegroundColor Gray
Write-Host " • redcap-db（MySQL数据库）" -ForegroundColor Gray
Write-Host " • phpmyadmin（数据库管理工具）" -ForegroundColor Gray
Write-Host ""

23
redcap-docker-dev/scripts/reset-admin-password.php Normal file
View File

@@ -0,0 +1,23 @@
<?php
/**
* REDCap Admin密码重置脚本
* 用途：重置Admin用户密码
*/
require_once '/var/www/html/redcap/redcap_connect.php';
require_once APP_PATH_CLASSES . 'Authentication.php';
$username = 'Admin';
$new_password = 'Admin123!';
echo "Resetting password for user: $username\n";
$result = Authentication::setPassword($username, $new_password, true);
if ($result) {
echo "✅ Password reset successful!\n";
echo "Username: Admin\n";
echo "New Password: Admin123!\n";
} else {
echo "❌ Password reset failed!\n";
}

161
redcap-docker-dev/scripts/setup-redcap.ps1 Normal file
View File

@@ -0,0 +1,161 @@
# REDCap Docker一键部署脚本
param([switch]$SkipCheck, [switch]$Force)
Write-Host "============================================" -ForegroundColor Cyan
Write-Host " REDCap Docker环境一键部署脚本" -ForegroundColor Cyan
Write-Host "============================================" -ForegroundColor Cyan
Write-Host ""
$ScriptDir = Split-Path -Parent $PSCommandPath
$ProjectDir = Split-Path -Parent $ScriptDir
Set-Location $ProjectDir
Write-Host "工作目录: $ProjectDir" -ForegroundColor Green
Write-Host ""
# 步骤 1: 环境检查
if (-not $SkipCheck) {
Write-Host "步骤 1/7: 环境检查..." -ForegroundColor Yellow
Write-Host " 检查Docker..." -NoNewline
$null = docker --version 2>&1
if ($LASTEXITCODE -ne 0) {
Write-Host " X" -ForegroundColor Red
Write-Host "Docker未安装或未运行!" -ForegroundColor Red
exit 1
}
Write-Host " OK" -ForegroundColor Green
Write-Host " 检查Docker Compose..." -NoNewline
$null = docker-compose --version 2>&1
if ($LASTEXITCODE -ne 0) {
Write-Host " X" -ForegroundColor Red
Write-Host "Docker Compose未安装!" -ForegroundColor Red
exit 1
}
Write-Host " OK" -ForegroundColor Green
Write-Host " 检查REDCap源码..." -NoNewline
if (-not (Test-Path "..\redcap15.8.0\redcap\index.php")) {
Write-Host " X" -ForegroundColor Red
Write-Host "REDCap源码未找到!" -ForegroundColor Red
exit 1
}
Write-Host " OK" -ForegroundColor Green
Write-Host "环境检查通过!" -ForegroundColor Green
Write-Host ""
}
# 步骤 2: 创建.env文件
Write-Host "步骤 2/7: 配置环境变量..." -ForegroundColor Yellow
$envExists = Test-Path ".env"
if (-not $envExists) {
Write-Host " 从模板创建.env文件..." -ForegroundColor Gray
$templateExists = Test-Path "env.template"
if (-not $templateExists) {
Write-Host " 未找到env.template!" -ForegroundColor Red
exit 1
}
Copy-Item "env.template" ".env"
Write-Host " .env文件已创建" -ForegroundColor Green
}
if ($envExists) {
Write-Host " .env文件已存在" -ForegroundColor Green
}
Write-Host ""
# 步骤 3: 检查端口
Write-Host "步骤 3/7: 检查端口占用..." -ForegroundColor Yellow
$ports = @(8080, 3306, 8081)
$portsInUse = @()
foreach ($port in $ports) {
$check = netstat -ano | Select-String ":$port " | Select-Object -First 1
if ($check) {
Write-Host " 端口 $port 已被占用" -ForegroundColor Yellow
$portsInUse += $port
continue
}
Write-Host " 端口 $port 可用" -ForegroundColor Green
}
if ($portsInUse.Count -gt 0) {
Write-Host ""
Write-Host "警告: 部分端口被占用!" -ForegroundColor Yellow
if (-not $Force) {
$continue = Read-Host "是否继续? (Y/N)"
if ($continue -ne "Y") {
Write-Host "部署已取消" -ForegroundColor Yellow
exit 0
}
}
}
Write-Host ""
# 步骤 4: 清理旧容器
if ($Force) {
Write-Host "步骤 4/7: 清理旧容器..." -ForegroundColor Yellow
docker-compose down 2>&1 | Out-Null
Write-Host " 旧容器已清理" -ForegroundColor Green
Write-Host ""
}
if (-not $Force) {
Write-Host "步骤 4/7: 跳过清理 (使用 -Force 强制清理)" -ForegroundColor Gray
Write-Host ""
}
# 步骤 5: 构建镜像
Write-Host "步骤 5/7: 构建Docker镜像..." -ForegroundColor Yellow
Write-Host " 这可能需要几分钟..." -ForegroundColor Gray
Write-Host ""
docker-compose build
if ($LASTEXITCODE -ne 0) {
Write-Host "Docker镜像构建失败!" -ForegroundColor Red
exit 1
}
Write-Host ""
Write-Host "Docker镜像构建成功!" -ForegroundColor Green
Write-Host ""
# 步骤 6: 启动容器
Write-Host "步骤 6/7: 启动容器..." -ForegroundColor Yellow
docker-compose up -d
if ($LASTEXITCODE -ne 0) {
Write-Host "容器启动失败!" -ForegroundColor Red
exit 1
}
Write-Host "容器启动成功!" -ForegroundColor Green
Write-Host ""
# 步骤 7: 等待服务就绪
Write-Host "步骤 7/7: 等待服务就绪..." -ForegroundColor Yellow
Write-Host " 等待MySQL启动 (30秒)..." -ForegroundColor Gray
Start-Sleep -Seconds 30
Write-Host ""
Write-Host "容器状态:" -ForegroundColor Cyan
docker-compose ps
# 部署完成
Write-Host ""
Write-Host "============================================" -ForegroundColor Green
Write-Host " REDCap Docker环境部署完成!" -ForegroundColor Green
Write-Host "============================================" -ForegroundColor Green
Write-Host ""
Write-Host "服务访问地址:" -ForegroundColor Cyan
Write-Host " REDCap: http://localhost:8080" -ForegroundColor White
Write-Host " phpMyAdmin: http://localhost:8081" -ForegroundColor White
Write-Host ""
Write-Host "下一步操作:" -ForegroundColor Cyan
Write-Host " 1. 访问 http://localhost:8080/install.php" -ForegroundColor White
Write-Host " 2. 数据库配置:" -ForegroundColor White
Write-Host " Host: redcap-db" -ForegroundColor Gray
Write-Host " Database: redcap" -ForegroundColor Gray
Write-Host " User: redcap_user" -ForegroundColor Gray
Write-Host " Password: redcap_pass_dev_456" -ForegroundColor Gray
Write-Host ""

45
redcap-docker-dev/scripts/start-redcap.ps1 Normal file
View File

@@ -0,0 +1,45 @@
#!/usr/bin/env pwsh
# REDCap Docker环境启动脚本
# 版本：v1.0
# 日期：2026-01-01
Write-Host "🚀 启动REDCap Docker环境..." -ForegroundColor Cyan
Write-Host ""
# 切换到项目目录
$ScriptDir = Split-Path -Parent $PSCommandPath
$ProjectDir = Split-Path -Parent $ScriptDir
Set-Location $ProjectDir
# 检查Docker是否运行
$dockerRunning = docker info 2>&1 | Select-String "Server Version"
if (-not $dockerRunning) {
Write-Host "❌ Docker未运行。请先启动Docker Desktop。" -ForegroundColor Red
exit 1
}
# 启动容器
docker-compose up -d
if ($LASTEXITCODE -eq 0) {
Write-Host ""
Write-Host "⏳ 等待服务就绪（10秒）..." -ForegroundColor Yellow
Start-Sleep -Seconds 10
Write-Host ""
Write-Host "✅ REDCap环境已启动！" -ForegroundColor Green
Write-Host ""
Write-Host "📋 服务访问地址：" -ForegroundColor Cyan
Write-Host " • REDCap： http://localhost:8080" -ForegroundColor White
Write-Host " • phpMyAdmin： http://localhost:8081" -ForegroundColor White
Write-Host ""
Write-Host "📊 容器状态：" -ForegroundColor Cyan
docker-compose ps
Write-Host ""
} else {
Write-Host "❌ 启动失败！" -ForegroundColor Red
Write-Host "请检查日志：.\scripts\logs-redcap.ps1" -ForegroundColor Yellow
exit 1
}

31
redcap-docker-dev/scripts/stop-redcap.ps1 Normal file
View File

@@ -0,0 +1,31 @@
#!/usr/bin/env pwsh
# REDCap Docker环境停止脚本
# 版本：v1.0
# 日期：2026-01-01
Write-Host "⏹️ 停止REDCap Docker环境..." -ForegroundColor Yellow
Write-Host ""
# 切换到项目目录
$ScriptDir = Split-Path -Parent $PSCommandPath
$ProjectDir = Split-Path -Parent $ScriptDir
Set-Location $ProjectDir
# 停止容器（保留数据）
docker-compose stop
if ($LASTEXITCODE -eq 0) {
Write-Host ""
Write-Host "✅ REDCap环境已停止！" -ForegroundColor Green
Write-Host ""
Write-Host "💡 提示：" -ForegroundColor Cyan
Write-Host " • 数据已保留在Docker卷中" -ForegroundColor Gray
Write-Host " • 重新启动：.\scripts\start-redcap.ps1" -ForegroundColor Gray
Write-Host " • 完全清理（删除数据）：.\scripts\clean-redcap.ps1" -ForegroundColor Gray
Write-Host ""
} else {
Write-Host "❌ 停止失败！" -ForegroundColor Red
exit 1
}