如何使用 Zextras Backup 或 imapsync 將 Zimbra 信箱移轉到新伺服器

對於完整的 Zimbra 到 Zimbra 遷移，如果您需要遷移電子郵件以外的郵箱數據，請使用受支援的 Zextras Backup 遷移工作流程。如果兩台伺服器都透過 IMAP 公開帳戶，且您的移轉範圍是郵件、資料夾和標記，請使用 imapsync。 Zextras表示其舊版 Zextras Migration Tool 已不再可用。其 Zimbra 遷移指南建議管理員使用 Zextras Backup。 Imapsync 是一個用於複製 IMAP 郵箱的獨立命令列選項；它不能取代 Zimbra 感知的日曆、聯絡人、共用或帳戶設定的遷移。

這種差異決定了您需要在新伺服器上進行多少配置和測試。在變更 MX 記錄或允許使用者在目標伺服器上工作之前，請確認來源伺服器和目標伺服器的版本、授權、驗證、儲存以及您必須保留的確切資料。

文件已於 2026 年 10 月 6 日核實。官方 imapsync 網站列出的版本為 2.314。 Zextras 的遷移文章指出舊版遷移工具已不可用，並介紹了一種 Zextras 備份方案。 Zextras 的頁面和範例與版本相關；在正式運行之前，請根據您已安裝的 Zextras 和 Zimbra 版本進行驗證。

1. 選擇符合您所需資料的路徑

Zextras 發布的 Zimbra 遷移指南列出了其備份工作流程可以遷移的電子郵件和資料夾、聯絡人、日曆、任務、共用、首選項、簽名、身分以及部分網域或服務等級資料。指南還指出，該工作流程不會遷移伺服器配置、LDAP 配置、MTA 或代理配置以及自訂品牌。特定遷移範圍取決於產品版本和設置，因此請將此列表視為範圍清單，並在目前文件中核實每個必需項目。

Imapsync 透過 IMAP 協定工作。它可以複製郵箱資料夾和郵件，並能同步目標伺服器支援的郵件標記。但它不會傳輸 Zimbra 伺服器的 LDAP 目錄、帳戶首選項、日曆、通訊錄、共用資源或伺服器設定。如果您需要這些內容，請考慮使用其他支援的匯出/匯入方法，或選擇 Zextras 方案。

請勿基於舊的 Zextras 遷移工具制定新的遷移計劃：Zextras 遷移指南已明確指出該工具不再可用。此外，請勿在未對照最新的 Zimbra imapsync 常見問題解答的情況下，直接從已存檔的 Zimbra 頁面複製過時的 IMAP 配置建議；該常見問題解答已明確指出，舊的 Zimbra imapsync 指南已過時。

2. 在複製資料之前，請準備好兩台伺服器。

在設定目標伺服器之前，請先清點以下資源：網域名稱、帳戶、別名、配額、郵件匣大小、使用者密碼或重設方案、共用資料夾、行事曆、聯絡人、通訊群組清單、保留需求以及使用者依賴的伺服器功能。確定每個階段接收新郵件的主機。將此清單作為遷移後的檢查清單。

• 確認平台支援。請確認目標系統已安裝、運作正常，並且與您的遷移路徑支援的 Zimbra/Zextras 組合相容。對於 Zextras Backup，供應商的 Zimbra 工作流程要求目標系統運行 Zextras Backup，來源系統運行 Zextras Backup 或 Zimbra Suite Plus。使用此功能前，請先與供應商確認您的授權。
• 檢查容量。估算目標位置即時郵件儲存、暫存來源備份或匯出以及目標備份所需的空間。 Zextras 遷移指南警告說，目標位置可能需要容納所有這三者；不要僅根據使用者可見的郵箱總數來確定容量。
• 備份並測試復原作業。保留一份單獨的可恢復來源備份。對於 Zextras 遷移，請遵循已安裝版本的檢查和備份流程。對於 imapsync，請先在目標位置使用測試郵箱；imapsync 的教學強調，在修改目標位置的同時，來源位置的資料會被讀取。
• 測試連線性和身份驗證。確認管理員或測試使用者可以使用預期的安全連線存取兩個 IMAP 端點。不要僅僅因為舊指南建議啟用明文身份驗證；請使用 Zimbra 版本支援的 TLS/SSL 和身份驗證設定。
• 規劃 DNS 和郵件流。如果 MX 記錄將發生更改，請在 DNS 提供者允許的情況下提前降低其 TTL 值，然後在過渡期間保留舊伺服器，以便監控和協調延遲或快取的郵件投遞情況。

3. 使用 Zextras Backup 進行 Zimbra 相容的遷移

此路徑專為需要在 Zimbra 系統之間遷移且需要 IMAP 郵件以外功能的管理員而設計。它並非一個通用的單一命令：來源產品和目標產品版本、備份路徑佈局、權限、儲存以及遷移順序都至關重要。 Zextras 的指南指出，zimbra除非另有明確說明，否則其 CLI 命令應以使用者身分執行。

建立並傳輸來源備份

請依照適用於您已安裝版本的最新 Zextras Backup 指南進行操作。 Zextras Zimbra 備份指南首先會進行原始碼完整性檢查和深度 SmartScan。其範例命令如下所示；在執行此命令前，請根據您的版本驗證命令語法和任何所需的維護步驟：

zxsuite backup doSmartScan start deep true

匯出來源資料後，將所需的備份資料傳輸到目標端的暫存目錄。 Zextras 提供了rsync一種傳輸方式，並建議在來源端保持活動狀態時重複傳輸，以便後續傳輸僅移動已變更的資料。目標暫存路徑必須對 Zimbra 使用者可讀，且不應與目標端的活動 Zextras 備份路徑混淆。保護傳輸通道並保留每次傳輸的日誌。

在目標位置進行設定和恢復

Zextras 文件介紹了一種僅用於設定的匯入方式，它會建立網域、服務等級和帳戶，但不會匯入郵件內容。這只是一個設定階段，並非完整的郵件恢復：

zxsuite backup doExternalRestore /path/for/data/ provisioning_only TRUE

配置完成後，執行完整的外部恢復，並根據目標伺服器上的測試結果選擇適當的並發設定。 Zextras 提供concurrent_accounts了一個參數，建議進行效能測試，而不是假設一個數值適用於所有伺服器。根據需要重複來源備份傳輸和相應的增量恢復，以收集遷移期間所做的變更。在驗證使用者和郵件流之前，請保持來源伺服器可用。

供應商提供了分階段和一次性兩種恢復方案，它們的順序可能取決於切換計劃。請使用適用於您已安裝版本的復原步驟，切勿混用不同版本的指令。在復原過程中，請勿編輯或刪除已匯入的備份資料或對應檔案。

4. 當您的郵件範圍是 IMAP 郵件時，請使用 imapsync。

當來源郵箱和目標郵箱都可透過 IMAP 訪問，且您希望在不安裝 Zimbra 專用遷移產品的情況下複製郵件和資料夾時，Imapsync 非常有用。它適用於 Linux、Windows 和 macOS。以下範例使用佔位符，並非真實的伺服器名稱或憑證。請將密碼儲存在受保護的腳本或其他經批准的密鑰處理方法中；切勿將其發佈在工單、共享 shell 歷史記錄或文章中。

首先建立一個來源郵箱和一個測試目標郵箱。使用模擬運行來測試登入功能並檢查資料夾映射，而無需寫入目標郵箱。 Imapsync 的官方教學展示了以下僅針對初始資料夾檢查的選項：

imapsync \
  --host1 SOURCE_IMAP --user1 USER --password1 SOURCE_SECRET \
  --host2 DEST_IMAP   --user2 USER --password2 DEST_SECRET \
  --automap --justfolders --dry

請使用貴組織的安全憑證工作流程取代佔位符。確認來源主機和目標主機是否正確，兩次登入是否均成功，以及「已傳送郵件」、「草稿」和「已刪除郵件」等資料夾是否會對應到正確的目標名稱。如果映射錯誤，請在複製郵件之前進行更正。

測試正確後，移除--justfolders並--dry執行實際的郵箱複製。--automap僅當建議的映射與您的資料夾名稱相符時才保留：

imapsync \
  --host1 SOURCE_IMAP --user1 USER --password1 SOURCE_SECRET \
  --host2 DEST_IMAP   --user2 USER --password2 DEST_SECRET \
  --automap

如果您有很多用戶，請透過受控腳本對每個郵箱執行已測試的命令。請查閱官方的imapsync 教學課程和最佳實踐--delete1，以了解特定於平台的語法和選項。除非您有意要刪除來源端郵件並已在臨時目標位置測試過結果，否則請避免使用諸如 `--delete` 或 `--delete` 之類的破壞性標誌--delete2。遷移副本不應意外刪除來源郵件或目標端資料。

5. 運行最終增量同步並切換郵件流

無論採用哪種方式，初始同步過程都可能需要一些時間，在此期間使用者仍可繼續工作。建議在切換臨近時安排最終同步。使用 imapsync 時，請重新執行相同的已測試指令：該工具專為增量同步而設計，通常會跳過已同步的郵件。盡可能在最終同步過程中保持來源郵箱不變。如果使用者已在使用兩台伺服器，請分別解決這些差異；imapsync 並非雙向合併工具。

對於 Zextras Backup，請按照特定版本的分階段匯入流程操作，並重複所需的備份傳輸/復原步驟，以取得自上次操作以來的變更。請勿假設僅配置匯入會包含郵件、行事曆或聯絡人；它會建立帳戶結構，但會跳過郵件信箱內容。

當目標伺服器準備好接收郵件時，請根據您的 DNS 和代理設定變更 MX 記錄和任何相關的 Webmail 記錄。保持舊伺服器運行，並在 DNS 快取過期和郵件延遲到達期間監控兩個系統。使用已記錄的維護窗口，並告知使用者在每個階段應該登入舊伺服器還是新伺服器。

6. 在停用舊伺服器之前，請先驗證新伺服器。

測試一組具有代表性的小型、大型、近期和較舊的郵箱。比較資料夾清單和郵件數量，開啟附附件的郵件，檢查已讀/未讀和已標記狀態，並確認已傳送郵件出現在預期資料夾中。向目標位址傳送和傳送郵件，然後確認公用 MX 查詢和伺服器日誌顯示郵件已送達預期主機。

對於 Zextras 遷移，請分別測試日曆、聯絡人、任務、共用、身分、簽名、使用者首選項以及包含在遷移範圍內的任何網域或服務等級設定。 Zextras 文件中提供了共享一致性檢查zxsuite backup doCheckShares；僅在需要且已安裝的版本支援時才使用相應的修復程序。重新檢查使用者存取權限和密碼行為。

在利害關係人批准結果且保留期限結束之前，請保留來源伺服器和可復原的備份。不要因為目標伺服器接受登入就取消舊主機。只有在郵件路由、使用者存取權限、非郵件資料和回溯記錄全部確認無誤後，才能關閉項目。

來源

• Zextras：如何使用 Zextras Backup 遷移 Zimbra 伺服器
• Zextras Suite 備份文檔
• imapsync 官方網站和發布訊息
• 官方 imapsync 教程
• Zimbra 官方 imapsync 常見問題解答
• 官方 imapsync 最佳實踐