如何在 Collabora CODE 中停用遙測和外部連接

簡而言之： Collabora Online 開發版 (CODE) 沒有提供管理員必須關閉的通用遙測開關，因此無需進行常規分析。 Collabora 表示，自架的 Online 版本不需要遙測或分析回呼。需要控制的出站活動是其他活動：定期更新檢查、可選整合、監控端點以及取得遠端資料的文件功能。停用您不使用的選用功能，然後強制執行出站允許列表，同時保持與儲存伺服器的 WOPI 連線。

這適用於自託管的 CODE，例如與 Nextcloud 或 ownCloud 整合的實例。完全阻止出站流量可能會導致文件載入和儲存失敗，因為 CODE 需要連接到其 WOPI 主機。以下組態名稱已於 2026 年 10 月 6 日根據 Collabora 的上游範本進行檢查；打包方式和預設值可能因版本而異。

什麼才算遙測資料或外部連線？

遙測資料通常指發送給供應商的產品使用或診斷資料。 Collabora 聲稱其自託管的線上產品不需要遙測資料、分析回呼或外部服務連線。上游coolwsd.xml範本中沒有顯示全域遙測資料收集器或「回傳」開關。

它會定期進行版本檢查：fetch_update_check預設為 10 小時。將其設為00 可關閉此檢查。此選項allow_update_popup控制更新通知是否顯示在編輯器中；將其設為0 會false隱藏通知，但這並不能取代停用檢查本身。如果您的版本支援這兩個選項，請同時設定它們。

其他連接則由功能驅動。它們可以包括已配置的外部顯示器、遠端拼字或語法服務、DeepL 翻譯、AI 提供者、遠端字體配置以及文件請求的外部資料。上游模板指出，預設情況下禁用遠端 LanguageTool 或 Duden API；DeepL 也預設為停用。在查看 AI 或整合選項時，請使用與您的 CODE 版本一同提供的設定。

第一步：確定必要目的地和可選目的地

在變更網路之前，請先繪製編輯工作流程圖。例如，假設 Nextcloud 位於 `<your_website_name>` cloud.example.com，CODE 位於 `<your_website_name> office.example.com`。瀏覽器從 CODE 載入編輯器，同時 CODE 伺服器也透過 WOPI 與 Nextcloud 通訊以取得並儲存文件。請保留伺服器之間的路由、您安裝所使用的協定和端口，以及部署所需的任何 DNS 或代理服務。

然後清點有效配置中的可選服務。尋找<monitors>明確配置的監控位址。檢查遠端拼字檢查、DeepL、AI、遠端字體配置和遠端設定 URL。移除未包含在已核准工作流程中的自訂端點。如果需要自訂端點，請在建立對應的網路例外之前記錄其主機名稱和用途。

另請檢查lok_allow。它控制編輯後的文件可以使用哪些主機作為外部資料來源，包括用於插入圖形或電子表格函數（例如）的 URL WEBSERVICE()。它並非通用防火牆。上游配置說明中允許的 WOPI 和 POST 主機也可能被視為允許的資料來源，因此請確保此策略與網路出口控制區分開來。

步驟 2：停用定期更新檢查

對於 Collabora CODE 容器，請透過其環境變數設定選項extra_params。將它們合併到現有值中；保留安裝所依賴的任何當前 TLS 終止、反向代理或主機設定。固定一個已核准的適用於您環境的 CODE 鏡像標籤，而不是依賴會移動的latest標籤。

services:
  collabora:
    image: collabora/code:<approved-tag>
    environment:
      extra_params: >-
        --o:fetch_update_check=0
        --o:allow_update_popup=false

這是一個範例 Docker Compose 片段，並非完整的部署。請保留您現有的網域限制、管理員憑證、TLS 設定和代理程式配置。在 Kubernetes 中，上游 Helm Chart 公開collabora.extra_params並支援自訂coolwsd.xml內容；請使用您已安裝的 Chart 版本的 values 檔案和說明。

如果直接管理 XML 文件，請將值放在其主<config>元素內：

<fetch_update_check>0</fetch_update_check>
<allow_update_popup>false</allow_update_popup>

除非該文件是持久化的，否則請勿在運行中的容器內進行手動編輯。重新啟動、鏡像更新或編排部署都可能導致該檔案被取代。請變更持久的 Compose、Helm 或已掛載的配置來源，並依照常規流程重新建立或部署程式碼。

步驟 3：關閉未使用的整合並限製文件獲取

如果您不使用外部監控服務，請<monitors>留空。上游檔案包含一個註解的範例監控器；附註解的條目僅為範例，並非活動連線。如果不再需要，請刪除本機新增的活動監控器條目。

除非使用者依賴遠端拼字和語法檢查、DeepL 以及 AI 提供者功能，否則請保持停用狀態。遠端語言檢查會將選取的文件文字傳送至已設定的服務，因此啟用此功能會對連線性和資料處理產生影響。如果需要集成，請僅允許其已批准的端點通過出口策略。

對於文件要求的遠端內容，請移除公用主機<lok_allow>，僅保留使用者所需的目標位置。請勿移除 WOPI 路由。 WOPI 是正常編輯所需的儲存連線。另請注意，過寬的私有網路條目可能會允許從超出預期範圍的內部主機取得文件；請根據您的網路佈局和 CODE 版本限制，縮小條目範圍。

步驟 4：在程式碼外部強制執行出站規則

應用程式設定會停用特定行為；但它們並不能保證作業系統或進程無法開啟任何其他連線。為了加強邊界保護，請在主機防火牆、容器網路、Kubernetes 網路策略或外部防火牆上套用出站規則。對 CODE 預設啟用拒絕，然後僅允許 WOPI 目標和明確批准的依賴項。允許 DNS 透過平台使用的網路服務進行存取。

在上面的範例中，CODE 可能被允許存取cloud.example.com為 WOPI 配置的方案和端口，而其他無關的公共目標則會被拒絕。當儲存主機位於負載平衡器之後或位址會變更時，應避免依賴硬編碼的 IP 位址。維護一個目標群組或使用受控的出口代理更易於管理。確保容器的代理配置保持一致。

保持入站和出站路徑分離。瀏覽器必須能夠存取已發佈的 CODE 端點，儲存伺服器可能需要存取 CODE 以進行發現或文件會話。允許 CODE 呼叫 WOPI 的出站策略不會建立這些入站路由。同樣，更改策略lok_allow並不會停用所有類型的出站連線。

步驟 5：重新啟動並驗證策略

重新啟動或部署程式碼，以便載入有效配置。檢查啟動日誌，查看已載入的組態值以及忽略設定的警告。然後透過常規儲存整合開啟一個可編輯的測試文檔，進行更改，儲存，關閉，再重新開啟。文件應該會保留更改。

啟動和編輯期間，請檢查防火牆、代理程式或網路原則日誌。應允許預期的 WOPI 流量。
確認您計劃封鎖的外部目標已被拒絕。僅憑靜默日誌無法證明所有可能的路由都已被封鎖。
在前一次更新檢查間隔過後，檢查 CODE 容器是否嘗試進行更新查找。如果更新彈出視窗也被停用，請確認是否消失。
測試使用者所需的所有功能，包括遠端字體、翻譯、語言輔助工具、文件連結以及檢索外部資料的公式。僅恢復所需功能所需的特定已核准目標位置。

如果文件無法開啟或儲存，請先檢查 DNS 和伺服器間的 WOPI 路由。如果只有外部影像或電子表格公式出現問題，則應將其lok_allow與防火牆策略分開檢查。阻止公共資料來源但 WOPI 仍然正常運作是預期結果；阻止儲存操作則表示出站策略過於寬泛。

停用這些連線能夠保證什麼，又不能保證什麼？

關閉更新檢查和未使用的整合會減少 CODE 的預期出站活動。預設拒絕的網路策略提供了強制執行邊界。這兩種方法都無法控制來自主機、容器執行時間、編排平台、反向代理程式或監控代理程式的獨立流量。如果要求涵蓋整個伺服器，則也需要審核這些元件。

配置預設值可能會在不同版本之間發生變化，整合也可能會新增新的設定。在正式發布之前，請將您綁定鏡像中包含的模板與目前的上游模板進行比較，並在預發布環境中進行測試。主要參考資料包括 Collabora 的上游 coolwsd.xml 配置範本、其官方 Helm Chart 值以及關於自架部署和外部服務的聲明。