如何將 Zimbra 9 升級到 Zimbra 10 (Daffodil) 的逐步指南

Zimbra 9 已不再受支援作為生產郵件平台的目標版本。截至 2026 年 10 月，Zimbra 9.0 已停止維護，Zimbra 10.0 也已過支援期，目前活躍的 Daffodil 分支版本為 Zimbra 10.1。因此，目前的 Zimbra 9 升級計劃通常應以受支援的 Zimbra 10.1 版本為目標，而不是止步於 10.0。截至撰寫本文時，Zimbra 10.1.21 已於 2026 年 9 月 24 日發布。在安排生產環境升級工作之前，請務必查看 Zimbra 10.1.21 的官方版本說明，因為修補程式要求和已知問題可能會變更。

在標準安裝環境下，升級本身可能很簡單，但正確的方法取決於您的作業系統、拓撲結構、NG 模組、自訂身份驗證、許可和對停機時間的容忍度。本指南不僅關注命令，也關注這些選擇，以便您可以選擇適合環境的路徑，而不是強制每次部署都執行相同的流程。

在投入生產之前選擇升級策略

方法	優勢	權衡取捨	最佳匹配
就地升級	保留現有伺服器身分、資料路徑和大部分配置。 Zimbra 官方文件支援單節點和多節點部署的就地升級。	需要預留維護視窗期，留給重新設計舊作業系統或儲存佈局的空間較小。	運作良好且支援的作業系統，採用傳統的 Zimbra 9 配置。
滾動式多伺服器升級	透過按控制順序升級角色，可以減少大範圍的服務中斷。	需要加強協調。混合版本郵件儲存行為和代理登入伺服器配置需要特別注意。	服務連續性至關重要的大型多節點環境。
Zimbra 10.1 全新安裝與遷移	允許您遷移到更新的受支援作業系統、新的儲存或重新設計的拓撲結構，而無需繼承所有舊版相依性。	需要製定遷移計劃、臨時容量、DNS/切換工作以及更多驗證。	較舊的作業系統、重大硬體更新、大量客製化或您不想就地升級的部署。

Zimbra 目前的文件列出了就地升級和捲動升級路徑，包括包含 NG 模組的環境，但它引導 NG 模組使用者使用專門的遷移資源。如果安裝程式偵測到 NG 模組，請勿隨意忽略此檢查：安裝程式會警告，繼續操作可能會刪除 NG 軟體包及其相關資料。請先查看官方的 Daffodil 升級說明和相應的 NG 遷移指南。

步驟 1：記錄目前 Zimbra 版本和服務狀態

首先建立基線。以zimbra使用者身分登入，並記錄已安裝的版本以及目前服務狀態：

su - zimbra
zmcontrol -v
zmcontrol status

Zimbra 升級前，終端機會顯示 zmcontrol 版本和服務狀態檢查結果。 — 在變更軟體包之前，請記錄目前版本和服務狀態。所示終端僅為範例命令視圖，並非實際生產伺服器的擷取結果。

如果服務已經發生故障，請在進行重大升級之前解決問題。升級時才發現 LDAP、郵箱、MTA 或代理問題早於維護窗口期就已經存在，這非常不明智。此外，還要清點自訂 Zimlet、外部身份驗證、整合、證書、中繼規則、腳本以及任何本地變更/opt/zimbra。

步驟二：執行資料庫完整性檢查並確認備份

Zimbra 特別指出，zmdbintegrityreport升級前進行此檢查非常有用，因為在主版本變更期間，預先存在的 MariaDB 損壞可能會更難診斷。請zimbra在儲存節點上以使用者身分執行此命令：

su - zimbra
zmdbintegrityreport

Zimbra 10 升級前 zmdbintegrityreport 完成的終端示意圖 — 升級前執行資料庫完整性報告，並調查錯誤，而不是將升級視為修復過程。

Zimbra 指出，此報告的生成時間可能從幾分鐘到一小時不等，具體取決於資料庫大小和儲存效能。對於大型郵件存儲，請勿在最後一刻安排此報告的產生。

接下來，請使用適合您的版本和環境的備份方法，建立一個完整的、可還原的備份。備份只有在您知道備份位置、備份成功完成且擁有切實可行的復原計畫的情況下才有用。 Zimbra 建議在進行重大升級作業之前進行一次完整備份，並在升級後再次進行完整備份，因為資料庫架構可能會發生變化。

此外，請分別備份 SAML 和 SPNEGO 的自訂設定。 Zimbra 警告稱，這些自訂設定可能會在升級過程中被覆蓋。如果您依賴自訂的salocal.cf.inSpamAssassin 規則或其他本機維護的文件，請查看目前版本說明，確認哪些文件可能會被替換，並在升級前儲存備份。

步驟 3：對於多伺服器部署，請遵循角色順序

單一伺服器安裝完成預檢查後即可直接執行安裝程式。多伺服器部署則需要遵循一定的順序。 Zimbra 官方文件中規定的順序是：首先是 LDAP 主伺服器，然後是 LDAP 副本伺服器、MTA 伺服器、代理伺服器、許可證守護程式服務、OnlyOffice 伺服器，最後是郵件儲存伺服器。

終端風格的清單，顯示了從 LDAP 主伺服器到郵件儲存伺服器的 Zimbra 多重伺服器升級順序 — 對於多伺服器環境，在維護視窗期間保持已記錄的角色順序可見，以免依賴服務升級順序錯亂。

在進行其他角色配置之前，必須先升級並執行 LDAP 主伺服器。在滾動升級期間，Zimbra 還警告說，當 Zimbra 10 和更早版本的郵件儲存共存時，zimbraReverseProxyUpstreamLoginServers郵件儲存中應該只包含 Zimbra 10 郵箱伺服器；否則，使用 Zimbra 10 郵件儲存的使用者可能會遇到 Modern Web App 登入問題。

第四步：檢查作業系統、可用空間和許可證

不要想當然地認為 Zimbra 9 伺服器的作業系統在 2026 年仍然是一個合適的選擇。 Zimbra 目前的文件顯示，其支援的平台已更新，包括 RHEL/Rocky/Oracle Linux 9 和 Ubuntu 22.04，而對 Ubuntu 24.04 的支援已在 Zimbra 10.1.17 版本中正式發布。 Zimbra 10.1.21 的發行說明也指出，從下一個版本開始，將不再支援 Ubuntu 18.04。如果您的 Zimbra 9 主機運行在較舊的平台上，那麼全新安裝並遷移可能比同時進行 Zimbra 的重大變更和作業系統遷移更為明智。

運行安裝程式前，請確認可用儲存空間。 Zimbra 的安裝程式會檢查可用空間，如果空間不足，則會停止運作。

Linux 終端機顯示 Zimbra 安裝路徑的磁碟空間檢查訊息 — 檢查存放 Zimbra 資料和軟體的檔案系統上的可用儲存空間；所示數字僅供參考，並非容量規劃指南。

Zimbra 10.1 也更改了許可方式。舊license.xml格式的授權金鑰不再受 10.1 版本支援。安裝或升級前，您需要使用新的 18-26 位元字母數字混合授權金鑰。請在維護視窗期之前從 Zimbra 取得正確的金鑰。 Zimbra官方下載頁面明確提醒使用者在開始之前必須擁有新的 v10.1 授權金鑰。

步驟 5：下載正確的 Zimbra 10.1 版本

從 Zimbra 官方下載區下載與您的作業系統和 CPU 架構相符的軟體包。請勿重複使用為其他發行版所建置的軟體包。將壓縮包保存在工作目錄中，例如 `/etc/zimbra/bin` /var/tmp。

如果 Zimbra 發布了您下載的軟體包的校驗和，請在解壓縮存檔之前驗證該校驗和。本地校驗和的計算方式如下：

sha256sum zcs.tgz

終端機顯示 Zimbra 安裝包的 SHA-256 校驗和計算結果 — 在本機運算軟體包校驗和，並將其與您選擇的確切下載的已發佈值進行比較。

圖中所示的校驗和並非發布校驗和。請僅使用實際軟體包提供的校驗和。

步驟 6：解壓縮檔案並啟動升級安裝程序

Zimbra 官方文件中記錄的就地升級流程無需您在升級前手動停止服務。安裝程式會根據需要停止和啟動服務。root下載完成後，解壓縮壓縮包，進入解壓縮後的目錄，然後執行以下指令install.sh：

cd /var/tmp
tar xzvf zcs.tgz
cd <expanded-directory>
./install.sh

終端機圖示顯示了 tar 解壓縮過程，隨後執行 Zimbra 的 install.sh 腳本。 — 解壓縮 Zimbra 壓縮包，進入壓縮包目錄，並以 root 使用者身分執行 install.sh 腳本。目錄名稱會因下載的版本而異。

Zimbra 建議在終端機復用器（例如）內執行升級，screen尤其是在遠端 SSH 會話中，因此即使連線中斷也不會終止長時間的升級：

screen ./install.sh

終端機中運行的 Zimbra install.sh 會話示意圖 — 使用 screen 會話可以降低因 SSH 斷開連線而導致升級過程終止的風險。

步驟 7：認真回答安裝程序提示

安裝程式會偵測現有的 Zimbra 安裝，並顯示升級路徑。 Zimbra 目前的說明指出，當提示時，請接受使用 Zimbra 軟體包儲存庫，然後確認是否要升級。在單節點 10.1 版本升級中，zimbra-license-daemon必須安裝該軟體包；拒絕安裝會導致升級無法繼續。

在回答最後一個提示之前，請檢查軟體包清單。只有在確認備份、許可證、軟體包來源、儲存和維護通訊都已就緒後The system will be modified. Continue? [N]，才能輸入命令Y。安裝程式隨後會停止舊服務、取代軟體包、恢復配置、執行升級工作並重新啟動服務。大型環境的安裝時間可能比小型測試系統長得多。

如果您使用離線/手動許可證，請按照 Zimbra 最新升級指南中的特定啟動路徑進行操作。請勿將線上許可的說明複製到離線環境中。同樣，當涉及啟動檢查時，郵箱節點指南也會有所不同，因此請使用特定版本的文檔，而不是從先前版本複製的舊命令。

步驟 8：驗證服務、版本、郵件流和用戶端存取權限

安裝程式完成後，切換回使用者zimbra並檢查服務狀態和已安裝的版本：

su - zimbra
zmcontrol status
zmcontrol -v

升級後，終端圖顯示 Zimbra 服務處於運作狀態。 — 升級後驗證首先要檢查服務狀態，但服務清單顯示為綠色只是第一步。

然後測試使用者實際依賴的行為：入站和出站 SMTP、內部傳遞、如果啟用了 IMAP/POP、現代和經典 Web 應用程式登入、委派郵箱、日曆操作、行動同步、如果獲得許可的 Outlook 連接、外部身份驗證、Zimlet、備份、監控以及任何使用 Zimbra SOAP 或 EWS 介面的應用程式。

請勿跳過特定版本升級後的操作。 Zimbra 10.1.19 及更高版本的發行說明中特別提到，對於從 10.0.x、9.0.x 或 8.8.15 版本升級的客戶，需要更新 SNMP 緩解措施。對於 2026 年的生產環境升級，請閱讀最新的修補說明，並在主要升級完成後套用任何必要的緩解措施。 Zimbra 10.1.21 還包含影響經典 Web 用戶端、WebDAV 驗證、密碼復原、OpenJDK、NGINX 和整合功能的安全修復，這也是不建議停留在過時的 10.0 版本的另一個原因。

何時該改變方向而不是繼續原地踏步？

就地升級的優點在於更換的零件較少，但這並非一定意味著風險更低。如果出現以下任何一種情況，則應重新考慮升級方案：

目前作業系統已過時或 Zimbra 支援即將結束。
資料庫完整性檢查報告了您無法解釋的錯誤。
您擁有 NG 模組，但尚未驗證支援的遷移過程。
SAML、SPNEGO、Zimlets、防毒/反垃圾郵件客製化或第三方整合是業務關鍵型功能，尚未針對 10.1 進行測試。
同時，您也正在更改儲存架構、主機名稱、網路設計或硬體。
在維護窗口期之前，您無法獲得所需的 10.1 許可證。

在這些情況下，並行運行的 Zimbra 10.1 環境以及受控遷移可能需要更多準備工作，但可以提供更清晰的回滾邊界，並為底層平台的現代化提供更好的機會。

實用升級清單

確認 Zimbra 9 的確切版本和目前服務運作狀況。
請查看最新的 10.1 版本說明和官方升級指南。
在儲存節點上運行zmdbintegrityreport並解決錯誤。
建立並驗證完整備份；儲存自訂身份驗證和過濾配置。
確認目標作業系統支援目標 10.1 版本。
取得新的 10.1 許可證密鑰；不要依賴舊的license.xml。
檢查磁碟容量並下載正確的平台軟體包。
對於多伺服器部署，請依照文件中規定的角色順序進行操作。
screen在終端機或等效的持久終端會話中執行安裝程式。
驗證服務、版本、郵件流、Web用戶端、身份驗證、整合和監控。
應用特定版本的升級後緩解措施，並建立新的完整備份。

結論

對於運行在支援作業系統上且配置常規的 Zimbra 9 伺服器，直接升級到目前的 Zimbra 10.1 Daffodil 分支通常是最直接的方法。但對於老舊的作業系統、複雜的下一代模組部署，或是需要進行重大基礎架構變更的伺服器，即使全新安裝和遷移需要更多的工作，也能提供更清晰的運作邊界。

關鍵的品質檢查並非僅僅在於升級是否install.sh完成。一次成功的升級意味著伺服器已更新至受支援的 10.1 版本補丁，所有必需的服務運行正常，郵件流和用戶訪問均按預期工作，自訂集成已重新測試，許可證已激活，版本特定的緩解措施已完成，並且您擁有最新的升級後備份。在規劃升級時，請務必開啟官方的 Zimbra Daffodil 升級指南、最新的 10.1.21 版本說明以及官方的多伺服器文檔，因為這些資源的優先順序高於舊的命令片段。