CSV で cPanel メールボックスを一括移行

Bulk Import では、多数の cPanel または独自 IMAP メールボックスを1バッチで移行できます。TrekMail の移行先メールボックスを作成し、旧プロバイダーの IMAP 設定を確認してから使用します。

CSV には移行元の認証情報が含まれます。作成者、保存場所、削除時期を計画してください。

移行元設定を収集する

旧プロバイダーの Email Accounts から Connect Devices、Configure Mail Client、または同等の画面を開き、安全な受信 IMAP 設定をコピーします。

• IMAP ホスト名
• ポート
• セキュリティ設定
• 完全なメールアドレスとメールボックスのパスワード

一般的なホスト一覧ではなく、プロバイダーが示す値を使います。cPanel のサーバーやプランによって名前と設定は異なります。

一括 CSV にユーザー名専用列はなく、各行の移行元アドレスでログインします。別の形式が必要なら、そのメールボックスは単体インポートを使うか、バッチに加える前にプロバイダーへ確認します。

移行先メールボックスと CSV を準備する

各 destination_email は同じアカウントに作成済みの TrekMail メールボックスでなければなりません。不足分はメールボックスの一括作成で先に作成します。

すべての移行元が同じサーバーを使う場合は3列形式を使います。

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

行ごとに異なる移行元サーバーを使う場合は6列形式を使います。

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

6列ファイルでは Each row has its own server settings を有効にします。CSV の規則、上限、引用符、テンプレートは一括移行の CSV 形式を参照してください。

サポートチケット、メール、リポジトリ、共有フォルダーにファイルを置かないでください。結果確認後に一時的なローカルコピーを削除します。

バッチを開始する

1. Import > Bulk Import を開き、Other を選びます。
2. CSV を貼り付けるかアップロードします。
3. 3列形式では共通の IMAP ホスト、ポート、セキュリティを Advanced settings に入力します。6列形式では行別設定を有効にします。
4. Preview & validate を選びます。CSV 構造、移行元設定、移行先、重複マッピングが検査されますが、まだ全移行元へログインしません。
5. 無効な行を修正して再度プレビューします。
6. フォルダー戦略を選びます。
   • Preserve folder tree は独自フォルダーを含む構造全体を保持します。
   • Flatten to INBOX は元フォルダーを記録した単一の Inbox アーカイブを作ります。
   • Only INBOX + Sent は意図的に限定した移行です。
7. 明確な理由がなければ Skip duplicates を維持します。任意のバッチ名を加え、Start を選びます。

1アカウントで有効にできる一括バッチは1つです。上限は Starter が100行、Pro が300行、Agency が1,000行です。ファイルは 2 MB 以下です。

監視と復旧

詳細ページにはメールボックス別結果と合計が表示されます。状態は queued、running、paused、completed、completed with errors、cancelled のいずれかです。

• 行が失敗： メッセージを読み、旧パスワードまたは接続設定を修正して、利用可能なら Continue incomplete を使います。
• バッチが一時停止： 移行先ストレージを確認し、準備後に Resume を選びます。完全な失敗を避けるため、使用率 90% で停止します。
• 停止が必要： Cancel all を選び、新しい処理の前に完了済みと部分完了の状態を確認します。
• 記録が必要： Download CSV で各行の現在の状態を取得します。

移行元と移行先のフォルダーを抽出確認するまで、旧メールボックスを削除したり MX レコードを変更したりしないでください。後日の追加入力には Skip duplicates を選んだ新規バッチを使います。

よくある問題

移行先メールボックスが見つからない

TrekMail で作成し、CSV のアドレスを修正して再プレビューします。バッチを開始する同じ TrekMail アカウントに属する必要があります。

認証または接続の失敗

旧プロバイダーの設定からホスト、ポート、セキュリティ、移行元アドレス、パスワードを再度コピーします。接続のためだけに暗号化を無効にしないでください。アプリパスワードが必要なら通常のパスワードの代わりに使います。

完了後に一部メールがない

まずフォルダー戦略、任意の日付フィルター、重複設定を確認し、両側のフォルダー名を比較します。部分的な結果なら、最初からやり直さずその行を続行します。