Массовая миграция ящиков cPanel через CSV

Bulk Import переносит множество ящиков cPanel или других пользовательских IMAP-ящиков одним пакетом. Используйте его после создания ящиков назначения TrekMail и проверки настроек IMAP старого провайдера.

Миграция выполняется через CSV с учетными данными исходных ящиков. Заранее решите, кто создаст файл, где он будет храниться и когда будет удален.

Сбор исходных настроек

Откройте у старого провайдера Email Accounts, затем Connect Devices, Configure Mail Client или аналогичный раздел. Скопируйте безопасные настройки входящего IMAP:

• имя хоста IMAP;
• порт;
• параметр безопасности; и
• полный адрес и пароль ящика.

Используйте значения провайдера, а не общий список хостов. Серверы и тарифы cPanel могут использовать разные имена и настройки.

В массовом CSV нет отдельного поля имени пользователя. Вход выполняется по исходному адресу каждой строки. Если нужен иной формат, используйте одиночный импорт или уточните формат у провайдера до добавления ящика в пакет.

Подготовка ящиков назначения и CSV

Каждый destination_email уже должен быть ящиком TrekMail в вашей учетной записи. Создайте недостающие через Массовое создание ящиков.

Если все исходные ящики используют один сервер, применяйте простой формат из трех столбцов:

source_email,source_password,destination_email
alice@old-example.com,password-for-alice,alice@new-example.com
bob@old-example.com,password-for-bob,bob@new-example.com

Если строки используют разные серверы, применяйте формат из шести столбцов:

source_email,source_password,destination_email,source_host,source_port,source_security
alice@site-one.example,password-for-alice,alice@new-example.com,mail.site-one.example,993,ssl
bob@site-two.example,password-for-bob,bob@new-example.com,mail.site-two.example,993,ssl

Для шести столбцов включите Each row has its own server settings. Все правила, лимиты, кавычки и шаблоны описаны в Формате CSV массовой миграции.

Не помещайте файл в обращения поддержки, письма, репозитории и общие папки. После проверки удалите временную локальную копию.

Запуск пакета

1. Откройте Import > Bulk Import и выберите Other.
2. Вставьте или загрузите CSV.
3. Для простого формата укажите общий хост, порт и безопасность IMAP в Advanced settings. Для шести столбцов включите настройки сервера для каждой строки.
4. Выберите Preview & validate. Предпросмотр проверяет структуру CSV, исходные настройки, ящики назначения и дублирующиеся сопоставления. Вход во все исходные ящики пока не выполняется.
5. Исправьте недопустимые строки и повторите предпросмотр.
6. Выберите стратегию папок:
   • Preserve folder tree для полной исходной структуры, включая пользовательские папки.
   • Flatten to INBOX для единого архива Inbox с указанием исходной папки.
   • Only INBOX + Sent для намеренно ограниченного переноса.
7. Оставьте Skip duplicates, если нет ясной причины изменить настройку. При желании задайте имя пакета и выберите Start.

У учетной записи может быть один активный массовый пакет. Максимум: 100 строк на Starter, 300 на Pro и 1,000 на Agency. Файл не может превышать 2 MB.

Наблюдение и восстановление

Страница пакета показывает результат каждого ящика и итоги. Статус может быть queued, running, paused, completed, completed with errors или cancelled.

• Ошибка строки: прочитайте сообщение, исправьте пароль старого ящика или соединение и используйте Continue incomplete, когда оно доступно.
• Пакет приостановлен: проверьте хранилище назначения и выберите Resume, когда оно готово. Пакеты приостанавливаются при 90% заполнения, чтобы избежать полного сбоя.
• Нужно остановиться: выберите Cancel all, затем проверьте завершенные и частично завершенные ящики перед новым запуском.
• Нужен отчет: используйте Download CSV для текущего статуса каждой строки.

Не удаляйте старые ящики и не меняйте записи MX, пока не проверите выборку исходных и целевых папок. Для последующего переноса создайте новый пакет с Skip duplicates.

Частые проблемы

Ящик назначения не найден

Создайте его в TrekMail, исправьте адрес CSV и повторите предпросмотр. Он должен принадлежать той же учетной записи TrekMail, которая запускает пакет.

Ошибка аутентификации или подключения

Снова откройте настройки почтового клиента у старого провайдера и скопируйте хост, порт, безопасность, исходный адрес и пароль. Не отключайте шифрование только ради подключения. Если нужен пароль приложения, используйте его вместо обычного пароля.

После завершения не хватает писем

Сначала проверьте стратегию папок, необязательный фильтр даты и настройку дубликатов. Затем сравните имена папок. При частичном результате продолжите эту строку, а не начинайте импорт заново.

Связанные статьи

• Миграция из cPanel (один ящик)
• Массовая миграция почты
• Формат CSV массовой миграции
• Массовое создание ящиков
• Мониторинг импортов и обработка ошибок
• Обязательные записи DNS