GitHub_Trending/re/redmine版本升级指南：从2.x到最新版迁移步骤
项目地址: https://gitcode.com/GitHub_Trending/re/redmine 你是否曾因担心数据丢失而推迟Redmine升级？还在手动复制配置文件时频频出错？本文将通过10个清晰步骤，带普通用户安全完成从2.x到最新版的迁移，全程无需复杂命令行操作。
一、升级准备清单
1.1 环境检查
- Ruby版本：确保服务器已安装2.7+或3.x版本（推荐3.1+）
- 数据库兼容性：MySQL需5.7.7+，PostgreSQL需10+，SQLite需3.8.7+
- 依赖工具：已安装Git、ImageMagick和Node.js（用于资产编译）
1.2 必备备份
在开始前必须完成两项备份：
# 数据库备份示例（MySQL）
mysqldump -u 用户名 -p 数据库名 > redmine_backup_$(date +%Y%m%d).sql
# 文件备份（Linux）
cp -r files/ files_backup_$(date +%Y%m%d)/
官方备份指南：doc/INSTALL
二、分步升级流程
2.1 下载与解压
# 创建新目录并下载最新版
mkdir -p /opt/redmine_new && cd /opt/redmine_new
wget https://www.redmine.org/releases/redmine-latest.tar.gz
tar xzf redmine-latest.tar.gz --strip-components=1
2.2 配置文件迁移
需复制的核心配置文件： | 原路径 | 新路径 | 作用 | |--------|--------|------| | config/database.yml | config/database.yml | 数据库连接信息 | | config/configuration.yml | config/configuration.yml | 邮件/存储配置 | | files/ | files/ | 附件存储目录 |
2.3 插件与主题处理
# 仅复制兼容新版的插件
cp -r /opt/redmine_old/plugins/* /opt/redmine_new/plugins/
# 删除已知不兼容插件（如legacy_*系列）
rm -rf /opt/redmine_new/plugins/legacy_*
插件兼容性列表：plugins/README
2.4 依赖安装
# 安装基础依赖
bundle install --without development test
# 如无ImageMagick，添加rmagick排除
bundle install --without development test rmagick
2.5 数据库迁移
# 执行架构升级
bundle exec rake db:migrate RAILS_ENV=production
# 更新插件数据表
bundle exec rake redmine:plugins:migrate RAILS_ENV=production
2.6 安全设置
# 生成新密钥（2.x版本必须执行）
rm -f config/initializers/secret_token.rb
bundle exec rake generate_secret_token
2.7 资产编译
# 预编译静态资源
bundle exec rake assets:precompile RAILS_ENV=production
2.8 缓存清理
bundle exec rake tmp:cache:clear tmp:sessions:clear
2.9 服务重启
# Passenger示例
touch tmp/restart.txt
# 独立服务器示例
systemctl restart redmine
2.10 权限验证
登录系统后访问 管理 → 角色与权限，确认新功能权限已正确应用：
- 检查「工时记录」「看板视图」等功能权限
- 验证自定义字段是否正常显示
三、常见问题解决
3.1 数据库连接错误
若提示Access denied for user：
- 检查config/database.yml中的密码是否正确
- 确认数据库用户有足够权限：
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine_user'@'localhost';
3.2 插件冲突
升级后若无法启动，可重命名plugins目录排查：
mv plugins plugins_old && mkdir plugins
# 逐个恢复插件测试
四、升级后优化建议
- 启用缓存：编辑config/configuration.yml添加Redis缓存配置
- 定期备份：设置crontab任务自动执行lib/tasks/redmine.rake中的备份任务
- 监控日志：关注log/production.log中的异常信息
五、迁移流程回顾
完成这些步骤后，你的Redmine已成功升级至最新版，可享受新特性如交互式甘特图、自定义工作流等功能。如有复杂场景需求，可参考官方完整指南doc/UPGRADING。
提示：升级后建议保留旧版本目录7天，确认无误后再删除以释放空间。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
