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

核心成果:
- 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:
2026-01-02 10:02:46 +08:00
parent dac3cecf78
commit 38d9bf99d6
25 changed files with 3990 additions and 0 deletions

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