恢復 Collabora CODE 設定而不遺失部署更改

Collabora CODE 容器在重建後可能會使用預設設定重啟，或者伺服器故障可能導致您無法取得其配置的有效副本。請備份coolwsd.xml提供設定的活動文件和部署文件。將它們還原到相同的持久化來源，然後在使用者復原編輯之前驗證檔案和服務。

主文件通常是… /etc/coolwsd/coolwsd.xml。軟體包、Docker 和 Helm 安裝的資料來源各不相同，因此在複製任何內容之前，請先確定部署方式。

1. 尋找活動配置來源

使用軟體套件安裝時，請檢查 hosts 檔案。在 Docker 中，請檢查執行容器內部的 hosts 文件，並確認是否有 hosts 檔案或目錄掛載到該檔案上。同時，請保留 Compose 檔案、引用的環境變數檔案或 Helm 配置：這些檔案中提供的啟動選項不一定會儲存在 XML 檔案中。

sudo ls -l /etc/coolwsd/coolwsd.xml
docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'
docker exec collabora-code ls -l /etc/coolwsd/coolwsd.xml

請將此處替換collabora-code為您的實際容器名稱。 Collabora 的配置和 Docker 文件描述了這些部署路徑，其上游 Helm chart 也公開了 chart 層級的設定。請閱讀您所用版本的文件；不同版本之間的預設設定和部署行為可能會有所不同。

2. 備份 XML 和部署文件

將一份帶有日期標記的備份檔案儲存在受限目錄中。設定資訊可能外洩允許的 WOPI 主機、代理行為、證書路徑或管理設定。請將備份檔案視為敏感的操作資料。

對於軟體包安裝，請保留檔案元資料：

sudo install -d -m 700 /var/backups/collabora/$(date +%F)
sudo cp -a /etc/coolwsd/coolwsd.xml \
  /var/backups/collabora/$(date +%F)/coolwsd.xml
sudo stat /var/backups/collabora/$(date +%F)/coolwsd.xml

對於 Docker，將容器中的 live 檔案複製到主機：

mkdir -p ~/backups/collabora/$(date +%F)
docker cp collabora-code:/etc/coolwsd/coolwsd.xml \
  ~/backups/collabora/$(date +%F)/coolwsd.xml
chmod 600 ~/backups/collabora/$(date +%F)/coolwsd.xml

如果綁定掛載提供了文件，也請備份其主機端來源文件；該文件會在容器重新啟動時覆蓋容器內的編輯。將 Compose 檔案及其所有引用的.env檔案保存在同一個受保護的備份集中。對於 Helm，請儲存確切的 values 檔案和發布標識，以及使用現有金鑰處理流程單獨管理的 Secrets 或 ConfigMaps。

3. 確保備份可重現

記錄 CODE 鏡像標籤或軟體包版本、容器名稱、掛載點和備份日期。軟體包安裝可以cp -a用於保留元資料。容器檔案所有權可能與主機不同，因此不要假設主機擁有者或模式適用於每個鏡像版本。

對於 Compose 版本，請確定掛載的是檔案還是整個目錄/etc/coolwsd。目錄掛載可能會隱藏鏡像中包含的檔案；不完整的目錄可能會導致預期檔案無法使用。備份 CODE 所依賴的掛載目錄中的所有檔案。單獨保存環境變數設定並保護敏感資訊。

對於 Helm，不要依賴編輯已產生的 Pod：升級操作可能會重新建立它。請保留 chart 值以及任何外部 Secret 或 ConfigMap。 Collabora 的上游 chart 支援透過值來管理配置內容，因此其聲明的來源可能比從正在運行的 Pod 複製的配置更具權威性。

4. 恢復到持久源

停止程式碼運行或利用維護視窗。替換目前文件前請先儲存。對於軟體包安裝，請恢復所選備份，並保留該軟體包所需的所有權和權限：

sudo systemctl stop coolwsd
sudo cp -a /etc/coolwsd/coolwsd.xml \
  /etc/coolwsd/coolwsd.xml.before-restore
sudo cp /var/backups/collabora/2026-10-09/coolwsd.xml \
  /etc/coolwsd/coolwsd.xml
sudo chown root:cool /etc/coolwsd/coolwsd.xml
sudo chmod 640 /etc/coolwsd/coolwsd.xml
sudo systemctl start coolwsd

範例擁有者和群組可能與您的軟體包不符。請檢查現有文件stat並保留其預期的所有權和權限，而不是盲目地應用範例值。對於綁定掛載的容器，請恢復主機檔案並按照 Compose 重新啟動或重新建立流程進行操作。如果自訂鏡像或 Helm 值提供了配置，請更新該來源並重新部署；編輯一次性容器的變更不會保留。

在進行主要版本變更後恢復配置之前，請務必檢查配置。不同版本之間的選項可能會有所變化，因此請將已儲存的檔案與目標版本的範本和遷移說明進行比較。還原 XML 檔案不會還原憑證、私鑰、自訂字體或反向代理配置，除非這些內容已單獨備份。

5. 重新開啟編輯介面前請先確認。

檢查檔案是否存在、服務是否可讀取，以及是否為格式正確的 XML 檔案。如果已安裝，xmllint則檢查語法：

xmllint --noout /etc/coolwsd/coolwsd.xml

這僅確認 XML 語法正確；並未證明您的程式碼版本支援所有選項。請檢查日誌以查找解析錯誤，並確認服務仍在執行。對於容器，請檢查docker compose ps最近的日誌。對於軟體包，請檢查systemctl status coolwsd系統日誌。

最後，透過常用的 WOPI 主機開啟文檔，並確認其可以載入和儲存。如果 CODE 啟動但文件無法載入，請將恢復的允許清單、外部主機名稱、TLS 終止和代理設定與部署環境進行比較。如果啟動失敗，請回滾到恢復前的副本，並在重試之前比較文件。

• 確認備份版本與部署版本是否一致。
• 確認掛載點或 Helm 值指向已復原的來源。
• 確認 XML 解析和服務啟動成功。
• 測試透過連接的儲存平台開啟和儲存檔案。

官方參考資料

• Collabora Online 設定文檔
• Collabora CODE Docker映像文檔
• Collabora 上游 Helm 圖表值
• Docker 綁定掛載文檔