Roundcube Webmail 升级指南：从备份到数据库迁移的完整流程

Roundcube Webmail 升级指南：从备份到数据库迁移的完整流程

roundcubemail The Roundcube Webmail suite 项目地址: https://gitcode.com/gh_mirrors/ro/roundcubemail

前言

Roundcube Webmail 作为一款广泛使用的开源网页邮件客户端，其版本升级过程需要谨慎操作以确保数据安全和功能完整性。本文将详细介绍从旧版本升级到新版本的全流程，包括自动脚本升级和手动升级两种方式，以及升级后的必要检查工作。

升级前的准备工作

重要提示：在执行任何升级操作前，必须完成以下准备工作：

1. 完整备份现有安装：包括所有程序文件、配置文件和插件
2. 数据库备份：导出完整的数据库结构和数据
3. 记录当前配置：特别是 config/config.inc.php 中的自定义设置

自动升级方案（推荐）

对于基于 Unix 的系统，Roundcube 提供了便捷的升级脚本，这是最推荐的升级方式。

自动升级步骤

1. 下载新版本：将新版 Roundcube 解压到临时目录（不要直接覆盖现有安装）
2. 执行升级脚本：

   ./bin/installto.sh <目标安装路径>
   

3. 脚本自动完成：
   • 复制所有新文件到目标位置
   • 检查并更新配置文件
   • 更新数据库架构

注意事项

• 文件权限：确保文件拥有正确的所有者和组权限
• MySQL/MariaDB 用户：若使用较旧版本（MySQL <5.7.7 或 MariaDB <10.2.2），需配置：

  innodb_large_prefix=1
  innodb_file_per_table=1
  innodb_file_format=Barracuda
  

手动升级方案

当无法使用自动脚本时（如无 shell 访问权限或非 Unix 系统），需手动执行升级。

手动升级步骤

1. 替换核心文件：

   • bin/
   • SQL/
   • public_html/
   • program/
   • installer/

2. 更新默认配置文件：

   • config/defaults.inc.php
   • config/mimetypes.php

3. 同步资源文件（使用 rsync）：

   • skins/
   • plugins/
   • vendor/

4. 更新依赖项：

   • 通过 Composer 更新：php composer.phar update --no-dev
   • 如需 LDAP 支持，需在 composer.json 中将 LDAP 库从 "suggest" 移至 "require"
   • 更新 JavaScript 依赖：bin/install-jsdeps.sh

5. 执行数据库更新：

   • 命令行方式：./bin/update.sh
   • 或通过网页界面访问 installer.php（需临时启用 enable_installer）

6. 禁用安装程序：完成后务必设置 enable_installer=false

升级后的必要检查

1. 系统要求验证：对照 INSTALL 文件检查系统环境
2. 地址簿重建索引：执行 /bin/indexcontacts.sh
3. 文件夹命名空间检查：特别是从 0.6-beta 之前版本升级的用户
4. 清理临时文件：从 1.4.0 之前版本升级需手动清理 temp_dir 中的旧文件

特殊场景处理

SQLite 数据库升级

从 0.9 之前版本升级时，需将 SQLite v2 数据库转换为 v3 格式：

sqlite OLD.DB .dump | sqlite3 NEW.DB

仅更新数据库架构

如需单独更新数据库架构，可使用：

./bin/updatedb.sh --package=roundcube --dir=SQL

最佳实践建议

1. 测试环境先行：先在测试环境验证升级过程
2. 分阶段升级：对于大版本跨越，考虑逐步升级而非直接跳至最新版
3. 监控日志：升级后密切观察系统日志和错误日志
4. 用户通知：提前告知用户可能的服务中断

通过遵循本指南，您可以安全、高效地完成 Roundcube Webmail 的升级工作，确保邮件服务的持续稳定运行。

roundcubemail The Roundcube Webmail suite 项目地址: https://gitcode.com/gh_mirrors/ro/roundcubemail