- 摘要
- Enhanced AApanel Migrate streamlines aaPanel environment transfers with chunked data transfer, real-time monitoring, and intelligent overwrite features. Securely migrate sites and databases without downtime using native API authentication. Ready to install via GUI or CLI; follow step-by-step instructions for seamless migration process.
增强AA面板迁移是一款强大的定制扩展，旨在无缝地将您的aaPanel环境从一台服务器转移到另一台。它考虑到稳定性以及大规模数据传输的需求，通过引入分块传输、深度API集成和智能覆盖能力来克服传统迁移工具的局限性。
关键特性
智能覆盖与合并：不同于默认工具在站点或数据库已存在时停止操作，此插件提供了一个“强制覆盖/合并”选项。它能够智能地合并文件并覆盖数据库表单，而不会中断迁移流程。
分块数据传输：专为不稳定网络和大型文件设计。系统以2MB的块大小上传文件，防止PHP超时以及Nginx文件大小限制。
实时速度与进度监控：利用一个专门的后台追踪器（speed.json）来提供实时UI进度条，显示正在进行的操作、传输速度及活跃日志。
隔离备份结构化：在转移前安全地压缩您的站点和数据库文件（.tar.gz 和 .sql.gz），确保生产环境文件不受影响。
安全API身份验证：直接通过aaPanel的原生API令牌系统连接到目标服务器，绕过需要root SSH密钥的需求。
安装指南
您可以使用aa面板GUI或命令行来安装插件。
方法A：UI安装（推荐）
将iEnhancd_migrate文件夹压缩成一个.zip文件。
登录到源服务器的aa面板控制台。
转至应用商店并点击第三方插件。
点击导入，选择您的.zip文件，并上传。面板会自动解压并安装它。
方法B：CLI安装
将iEnhancd_migrate文件夹上传到源服务器的/www/server/panel/plugin/目录下。
通过SSH连接到源服务器。
运行以下命令来执行安装脚本：
```bash
cd /www/server/panel/plugin/iEnhancd_migrate
bash install.sh install
```
该脚本会自动设置正确的权限（755，root:root）并重新加载面板。
使用方法（逐步迁移）
一旦安装完成，从您的应用商店控制台打开增强AA面板迁移。迁移过程被分解为四个简单的步骤：http://192.168.1.100:8888点击下一步。插件将测试连接。
步骤2：环境检查
插件将在两端比较源和目标环境。
它会验证Web服务器（Nginx/Apache）和MySQL数据库是否已安装，以防止兼容性错误。
点击下一步继续。
步骤3：选择并合并
选择数据：选择您希望迁移的网站、FTP帐户和数据库。您可以选择全部或挑选特定的。
强制覆盖/合并：如果您已经尝试过迁移或者在目标服务器上手动创建了站点，请勾选此选项。这告诉系统跳过“资源已存在”错误，并直接将新数据合并到现有的路径中。
点击开始迁移。
步骤4：迁移及实时跟踪
进度条将显示整体完成的百分比。
进度条下方的终端窗口将实时流式传输日志，显示正在压缩、传输和解包的具体文件。
重要提示：在“压缩”或“传输”阶段不要关闭浏览器标签页。
完成后，您会看到一个“迁移完成！”屏幕。您可以点击下载日志来保存转移记录。
故障排查及日志
如果迁移失败或停滞，插件提供了完全透明的日志：
UI 日志：步骤4中的终端窗口实时显示错误信息。
主日志文件：位于/www/server/panel/logs/iEnhancd_migrate.log。此记录了迁移过程的每一步。
错误日志文件：位于/www/server/panel/logs/iEnhancd_migrate_err.log。此记录了关键的Python后端崩溃情况。
重置停滞UI：如果UI变得无响应，您可以安全地点击“停止迁移”来终止后台工作进程，并重置跟踪文件（speed.json和sync_info.json）。
关键特性
智能覆盖与合并：不同于默认工具在站点或数据库已存在时停止操作，此插件提供了一个“强制覆盖/合并”选项。它能够智能地合并文件并覆盖数据库表单，而不会中断迁移流程。
分块数据传输：专为不稳定网络和大型文件设计。系统以2MB的块大小上传文件，防止PHP超时以及Nginx文件大小限制。
实时速度与进度监控：利用一个专门的后台追踪器（speed.json）来提供实时UI进度条，显示正在进行的操作、传输速度及活跃日志。
隔离备份结构化：在转移前安全地压缩您的站点和数据库文件（.tar.gz 和 .sql.gz），确保生产环境文件不受影响。
安全API身份验证：直接通过aaPanel的原生API令牌系统连接到目标服务器，绕过需要root SSH密钥的需求。
安装指南
您可以使用aa面板GUI或命令行来安装插件。
方法A：UI安装（推荐）
将iEnhancd_migrate文件夹压缩成一个.zip文件。
登录到源服务器的aa面板控制台。
转至应用商店并点击第三方插件。
点击导入，选择您的.zip文件，并上传。面板会自动解压并安装它。
方法B：CLI安装
将iEnhancd_migrate文件夹上传到源服务器的/www/server/panel/plugin/目录下。
通过SSH连接到源服务器。
运行以下命令来执行安装脚本：
```bash
cd /www/server/panel/plugin/iEnhancd_migrate
bash install.sh install
```
该脚本会自动设置正确的权限（755，root:root）并重新加载面板。
使用方法（逐步迁移）
一旦安装完成，从您的应用商店控制台打开增强AA面板迁移。迁移过程被分解为四个简单的步骤：http://192.168.1.100:8888点击下一步。插件将测试连接。
步骤2：环境检查
插件将在两端比较源和目标环境。
它会验证Web服务器（Nginx/Apache）和MySQL数据库是否已安装，以防止兼容性错误。
点击下一步继续。
步骤3：选择并合并
选择数据：选择您希望迁移的网站、FTP帐户和数据库。您可以选择全部或挑选特定的。
强制覆盖/合并：如果您已经尝试过迁移或者在目标服务器上手动创建了站点，请勾选此选项。这告诉系统跳过“资源已存在”错误，并直接将新数据合并到现有的路径中。
点击开始迁移。
步骤4：迁移及实时跟踪
进度条将显示整体完成的百分比。
进度条下方的终端窗口将实时流式传输日志，显示正在压缩、传输和解包的具体文件。
重要提示：在“压缩”或“传输”阶段不要关闭浏览器标签页。
完成后，您会看到一个“迁移完成！”屏幕。您可以点击下载日志来保存转移记录。
故障排查及日志
如果迁移失败或停滞，插件提供了完全透明的日志：
UI 日志：步骤4中的终端窗口实时显示错误信息。
主日志文件：位于/www/server/panel/logs/iEnhancd_migrate.log。此记录了迁移过程的每一步。
错误日志文件：位于/www/server/panel/logs/iEnhancd_migrate_err.log。此记录了关键的Python后端崩溃情况。
重置停滞UI：如果UI变得无响应，您可以安全地点击“停止迁移”来终止后台工作进程，并重置跟踪文件（speed.json和sync_info.json）。
