如何設定 Kopano WebApp 檔案預覽器和 MDM 插件

在文件所述的設定中，您無需安裝單獨的「FileViewer」軟體包即可啟用 Kopano WebApp 的文件預覽器，但 MDM 是一個單獨的插件，必須安裝並連接到 Z-Push。這一點很重要：WebApp 管理員手冊透過文件介紹了預覽器的使用方法ENABLE_FILE_PREVIEWER，而 MDM 手冊則介紹了專用的軟體包、設定檔及其相依性。安裝錯誤的“Files”插件將無法啟用預覽器。

本指南適用於現有 Kopano WebApp 部署的管理員。 Kopano 發布的 WebApp 和 MDM 手冊是舊版文檔，因此在更改生產環境之前，請務必確認其套件名稱和設定與您正在執行的 WebApp、PHP、Z-Push 和作業系統版本完全匹配。以下步驟說明了文件中提到的路徑以及如何安全地進行驗證。

您指的是文件預覽，還是 Kopano Files 外掛？

當使用者需要在 WebApp 中預覽受支援的文件附件時，請使用內建的文件預覽器設定。文件中記錄的管理員選項是 `--presender-set-up` ENABLE_FILE_PREVIEWER；它控制是否向使用者提供預覽器設定。 WebApp 手冊並未將其描述為需要透過套件管理器安裝的單獨文件檢視器軟體套件。

Kopano Files 有所不同。它新增了一個檔案區域，用於瀏覽和管理外部儲存帳戶，例如 WebDAV 或其他已配置的後端。它可能需要單獨的軟體包和後端配置。如果您的目標是預覽附件，請從預覽器設定入手，而不是 Kopano Files。如果您的目標是將共享儲存連接到 WebApp，請參閱文末連結的單獨的文件手冊。

MDM 的功能是什麼？它在什麼情況下有用？

Kopano 的行動裝置管理外掛程式可為透過 Z-Push 與 Kopano 同步的行動裝置提供資訊和操作。根據部署情況，使用者可以查看設備詳細資訊並使用諸如重新同步、移除、刷新或擦除等操作。當使用者或管理員需要在 Web 應用中使用這些裝置控制功能時，此外掛程式非常有用；它並非 Z-Push 的替代品，也不會自動建立行動裝置同步。

Kopano MDM 手冊列出了 Z-Push 2.0 或更高版本以及 PHP SOAP 支援作為依賴項。如果 Z-Push 運行在與 WebApp 不同的主機上，則 MDM 配置必須指向該 Z-Push 伺服器。在安裝任何元件之前，請確認 Z-Push 端點、已安裝的 PHP 執行時間環境以及軟體包相容性，確保與您的環境相符。

如何啟用文件預覽功能？

首先找到目前安裝所使用的活動 Web 應用程式config.php。在基於軟體包的部署中，它通常位於 `/etc/webapp/webapp/` 目錄下/etc/kopano/webapp/，但容器和自訂安裝可能會將配置掛載到其他位置。在編輯設定檔之前請先備份，如果該設定已存在，請避免建立第二個定義。

在目前設定中，找到ENABLE_FILE_PREVIEWER. Kopano WebApp 管理手冊文件中true提到，該配置會向使用者顯示啟用文件預覽器的選項，false也會隱藏該選項並停用所有使用者的預覽功能。例如：

define("ENABLE_FILE_PREVIEWER", true);

如果該行已存在，請修改其值，而不是新增重複項define()。保持周圍的 PHP 語法不變。如果不存在該行，請使用與已安裝的 Web 應用程式套件相符的範本或設定指南，而不是將整個範例設定複製到生產文件中。

儲存後，使用 Web 應用程式執行所依賴的 PHP 解釋器檢查 PHP 語法錯誤。例如，如果設定檔位於標準套件路徑下：

php -l /etc/kopano/webapp/config.php

語法檢查僅驗證 PHP 解析是否正確；它無法確認運行中的網站是否已載入該設定。請以測試使用者身分登錄，開啟 Web 應用程式設置，並確認文件預覽選項可用。啟用該選項，套用更改，然後開啟一個您的 Web 應用程式支援的附件類型。如果該控制項缺失，請確認您已編輯目前配置，Web 應用程式插件和設定可用，且軟體包升級或容器掛載沒有提供其他設定檔。

如何安裝MDM插件？

請使用與伺服器版本和發行版相同的 Kopano WebApp 版本和發行版所建置的 MDM 軟體包。 Kopano MDM 手冊中提供了一個名為 `<debian-family-package-name>` 的 Debian 系列軟體包kopano-webapp-plugins-mdm以及一個適用於基於 RPM 的發行版的 RPM 軟體包。手冊下方展示了 Debian 的安裝模式；請將佔位符替換為您從可信任的相容軟體包來源取得的實際軟體包版本：

sudo dpkg -i ./kopano-webapp-plugins-mdm_<version>.deb

請勿直接輸入尖括號佔位符。如果軟體包安裝報告存在未解決的依賴項，請使用發行版的常規軟體包管理流程從受信任的軟體倉庫解決這些依賴項，然後確認已安裝的 MDM 軟體包和 WebApp 版本是否相容。避免下載隨機的軟體包版本或混用不同版本來滿足依賴關係。

請確認 Web 應用程式使用的 PHP 環境中已啟用 PHP SOAP 擴充功能。快速檢查方法如下：

php -m | grep -i '^soap$'

如果沒有輸出，請安裝並啟用與 WebApp 使用的 PHP 版本和 Web 伺服器執行階段相符的 SOAP 擴充功能。 CLI PHP 檢查可能與 PHP-FPM 或 Apache 的 PHP 模組有所不同，因此如果命令顯示 SOAP 存在但 MDM 仍會報告缺少 SOAP 函數，請比較 Web 伺服器設定。

應該如何設定MDM伺服器連線？

已發布的 MDM 手冊將其設定放在 . 中/etc/kopano/webapp/config-mdm.php。請備份該文件，然後檢查文件中記錄的選項：

PLUGIN_MDM_USER_DEFAULT_ENABLE_MDM控制插件是否預設對使用者啟用；手冊中列出的預設值為false。
PLUGIN_MDM_SERVER標識 Z-Push 伺服器；文檔中記錄的預設值為localhost。
PLUGIN_MDM_SERVER_SSLtrue當連線使用 SSL/TLS 時，應設定為 true ；文件中記錄的預設值為 false false。

如果 WebApp 和 Z-Push 位於不同的主機上，請將預設伺服器設定替換為部署所需的實際 Z-Push 位置。使用正確的協定和主機名，並在該端點使用 HTTPS 時啟用 SSL 選項。不要為了讓外掛程式回應而公開端點；請確保可以透過預期的網路路徑和有效的憑證存取該端點。保留已安裝檔案使用的 PHP 語法。

預設設定未必適用於所有組織。您可以允許使用者自行啟用 MDM，或者如果您的策略允許，也可以預設啟用 MDM。如果您的 Web 應用程式設定全域停用了插件或封鎖了 MDM 插件，請先解決該中心設定；單獨變更 MDM 的預設設定不會覆蓋在 Web 應用程式層級明確停用的插件。

如何在使用者帳戶中啟用 MDM？

安裝並配置軟體包後，登入 WebApp 並開啟“設定”，然後選擇“插件”標籤。選擇 MDM 並套用變更。 MDM 手冊指出，設備概覽會顯示在「設定」中的單獨 MDM 選項卡里，其中包含設備資訊、上次同步時間和設備 ID。如果插件未列出，請先確認軟體包檔案已安裝在 WebApp 目前插件目錄中，且全域插件設定未將其隱藏或停用。

使用已通過 Z-Push 同步設備的帳戶進行測試。如果裝置清單為空，請檢查該帳戶是否擁有 Z-Push 裝置、MDM 伺服器設定是否指向正確的 Z-Push 服務，以及 Web 應用程式進程是否可以使用 PHP SOAP。在更改無關的伺服器設定之前，請查看測試請求前後 Web 應用程式和 Z-Push 的日誌。

在使用Wipe or Remove之前您應該了解哪些內容？

將 MDM 操作視為操作控制，而非無害的刷新按鈕。 Kopano 的 MDM 手冊警告稱，「擦除」操作會刪除設備上的所有數據，並建議謹慎使用。在向使用者開放「擦除」功能之前，請使用非關鍵設備測試該接口，並了解組織的恢復流程。在呼叫「擦除」功能前，請確認目標裝置 ID 和使用者。

移除操作也會產生後果：手冊指出，從清單中移除裝置意味著使用者必須在手機上移除並重新連接帳戶，裝置才能再次顯示。重新同步會要求再次同步；刷新會更新顯示的裝置清單。請勿將「擦除」作為設備同步速度緩慢的常規故障排除步驟。

如何驗證這兩個功能？

對於文件預覽，請確認用戶可以看到並啟用該設置，然後打開受支援的附件而無需先下載。對於 MDM，請確認測試用戶可以看到預期的設備信息，並且上次同步的詳細信息與已知通過 Z-Push 同步的設備相匹配。首先測試風險較低的操作，例如刷新或重新同步。在驗證其影響之前，請根據貴組織的策略保持擦除功能停用或受到限制。

如果預覽控制項缺失，請重新檢查目前 Web 應用程式的設定和使用者設定。如果 MDM 缺失或未顯示任何設備，請驗證軟體包相容性、PHP SOAP、MDM 配置路徑、Z-Push 主機以及全域插件限制。 Kopano 發布的手冊描述了設定名稱和軟體包模式，但並未保證與所有當前發行版和 PHP 版本相容；請以伺服器版本對應的軟體包文件為準。