- Краткое описание
- a powerful, custom-built extension designed to seamlessly transfer your aaPanel environments
Enhanced AApanel Migrate is a powerful, custom-built extension designed to seamlessly transfer your aaPanel environments from one server to another. Built with stability and large-scale data transfers in mind, it overcomes the limitations of traditional migration tools by introducing chunked transfers, deep API integration, and intelligent overwrite capabilities.
Key Features
Smart Overwrite & Merge: Unlike default tools that halt when a site or database already exists, this plugin features a "Force Overwrite / Merge" option. It intelligently merges files and overwrites database tables without breaking the migration flow.
Chunked Data Transfer: Designed for unstable networks and massive files. The system uploads files in 2MB chunks, preventing PHP timeouts and Nginx file-size limits.
Real-Time Speed & Progress Monitoring: Utilizes a dedicated background tracker (speed.json) to provide a live UI progress bar, showing exactly what is happening, transfer speeds, and active logs.
Isolated Backup Structuring: Safely compresses your sites and databases (.tar.gz and .sql.gz) into a dedicated backup/ directory before transfer, ensuring your live production files are untouched.
Secure API Authentication: Connects directly to the target server using aaPanel's native API token system, bypassing the need for root SSH keys.
Prerequisites
Before you begin, ensure you have the following ready:
Source Server: aaPanel installed (this is where you will install the plugin).
Target Server: aaPanel installed.
API Access: On your Target Server, go to Settings > API. Enable the API and generate a token.
IP Whitelist: Add your Source Server's IP address to the API whitelist on the Target Server.
Installation Guide
You can install the plugin using either the aaPanel GUI or the command line.
Method A: UI Installation (Recommended)
Compress your iEnhancd_migrate folder into a .zip archive.
Log in to your Source Server's aaPanel dashboard.
Navigate to the App Store and click on Third-party plugins.
Click Import, select your .zip file, and upload it. The panel will automatically extract and install it.
Method B: CLI Installation
Upload the iEnhancd_migrate folder to /www/server/panel/plugin/ on your Source Server.
Connect to your Source Server via SSH.
Run the following commands to execute the installation script:
Bash
cd /www/server/panel/plugin/iEnhancd_migrate
bash install.sh install
The script will automatically set the correct permissions (755, root:root) and reload the panel.
How to Use (Step-by-Step Migration)
Once installed, open Enhanced AApanel Migrate from your App Store dashboard. The migration process is broken down into four simple steps:
Step 1: API Credentials
Target URL: Enter the aaPanel URL of your destination server (e.g., http://192.168.1.100:8888).
API Token: Paste the 32-character API key generated from your target server.
Click Next. The plugin will test the connection.
Step 2: Environment Check
The plugin will compare your Source and Target environments.
It verifies if Web Servers (Nginx/Apache) and MySQL databases are installed on both ends to prevent compatibility errors.
Click Next to proceed.
Step 3: Select & Merge
Select Data: Choose which Web Sites, FTP accounts, and Databases you wish to migrate. You can select all or pick specific ones.
Force Overwrite / Merge: If you have already attempted a migration or manually created sites on the target server, check this box. It tells the system to bypass "Resource Exists" errors and merge the new data directly into the existing paths.
Click Start Migration.
Step 4: Migration & Real-Time Tracking
A progress bar will appear showing the overall completion percentage.
The terminal window below the progress bar will stream live logs, showing exactly which files are being compressed, transferred, and extracted.
Important: Do not close the browser tab during the "Compressing" or "Transferring" phases.
Once finished, you will see a "Migration Complete!" screen. You can click Download Log to save a record of the transfer.
Troubleshooting & Logs
If a migration fails or stalls, the plugin provides completely transparent logging:
UI Logs: The terminal window in Step 4 displays real-time errors.
Master Log File: Located at /www/server/panel/logs/iEnhancd_migrate.log. This records every step of the migration process.
Error Log File: Located at /www/server/panel/logs/iEnhancd_migrate_err.log. This catches critical Python backend crashes.
Resetting a Stalled UI: If the UI becomes unresponsive, you can safely click "Stop Migration" to kill the background worker and reset the tracking files (speed.json and sync_info.json).
Key Features
Smart Overwrite & Merge: Unlike default tools that halt when a site or database already exists, this plugin features a "Force Overwrite / Merge" option. It intelligently merges files and overwrites database tables without breaking the migration flow.
Chunked Data Transfer: Designed for unstable networks and massive files. The system uploads files in 2MB chunks, preventing PHP timeouts and Nginx file-size limits.
Real-Time Speed & Progress Monitoring: Utilizes a dedicated background tracker (speed.json) to provide a live UI progress bar, showing exactly what is happening, transfer speeds, and active logs.
Isolated Backup Structuring: Safely compresses your sites and databases (.tar.gz and .sql.gz) into a dedicated backup/ directory before transfer, ensuring your live production files are untouched.
Secure API Authentication: Connects directly to the target server using aaPanel's native API token system, bypassing the need for root SSH keys.
Prerequisites
Before you begin, ensure you have the following ready:
Source Server: aaPanel installed (this is where you will install the plugin).
Target Server: aaPanel installed.
API Access: On your Target Server, go to Settings > API. Enable the API and generate a token.
IP Whitelist: Add your Source Server's IP address to the API whitelist on the Target Server.
Installation Guide
You can install the plugin using either the aaPanel GUI or the command line.
Method A: UI Installation (Recommended)
Compress your iEnhancd_migrate folder into a .zip archive.
Log in to your Source Server's aaPanel dashboard.
Navigate to the App Store and click on Third-party plugins.
Click Import, select your .zip file, and upload it. The panel will automatically extract and install it.
Method B: CLI Installation
Upload the iEnhancd_migrate folder to /www/server/panel/plugin/ on your Source Server.
Connect to your Source Server via SSH.
Run the following commands to execute the installation script:
Bash
cd /www/server/panel/plugin/iEnhancd_migrate
bash install.sh install
The script will automatically set the correct permissions (755, root:root) and reload the panel.
How to Use (Step-by-Step Migration)
Once installed, open Enhanced AApanel Migrate from your App Store dashboard. The migration process is broken down into four simple steps:
Step 1: API Credentials
Target URL: Enter the aaPanel URL of your destination server (e.g., http://192.168.1.100:8888).
API Token: Paste the 32-character API key generated from your target server.
Click Next. The plugin will test the connection.
Step 2: Environment Check
The plugin will compare your Source and Target environments.
It verifies if Web Servers (Nginx/Apache) and MySQL databases are installed on both ends to prevent compatibility errors.
Click Next to proceed.
Step 3: Select & Merge
Select Data: Choose which Web Sites, FTP accounts, and Databases you wish to migrate. You can select all or pick specific ones.
Force Overwrite / Merge: If you have already attempted a migration or manually created sites on the target server, check this box. It tells the system to bypass "Resource Exists" errors and merge the new data directly into the existing paths.
Click Start Migration.
Step 4: Migration & Real-Time Tracking
A progress bar will appear showing the overall completion percentage.
The terminal window below the progress bar will stream live logs, showing exactly which files are being compressed, transferred, and extracted.
Important: Do not close the browser tab during the "Compressing" or "Transferring" phases.
Once finished, you will see a "Migration Complete!" screen. You can click Download Log to save a record of the transfer.
Troubleshooting & Logs
If a migration fails or stalls, the plugin provides completely transparent logging:
UI Logs: The terminal window in Step 4 displays real-time errors.
Master Log File: Located at /www/server/panel/logs/iEnhancd_migrate.log. This records every step of the migration process.
Error Log File: Located at /www/server/panel/logs/iEnhancd_migrate_err.log. This catches critical Python backend crashes.
Resetting a Stalled UI: If the UI becomes unresponsive, you can safely click "Stop Migration" to kill the background worker and reset the tracking files (speed.json and sync_info.json).
