修復 Nextcloud“某些文件未通過完整性檢查”警告

更新或手動變更後，您可能會開啟 Nextcloud 的管理概覽頁面，看到「某些文件未通過完整性檢查」的提示。此警告可能令人擔憂，但它並非指單一的通用故障。 Nextcloud 會檢查已安裝的伺服器和應用程式程式碼是否與其預期的簽章檔案相符。文件變更或缺失、出現意外文件或應用程式簽署問題都可能觸發此警報。重新掃描會報告目前狀態，但不會修復文件。

截至撰寫本文時，Nextcloud 官方下載頁面列出的最新版本為 Server 35.0.0，發布日期為 2026 年 9 月 16 日。目前的管理文件仍然指導管理員檢查無效文件報告，修復特定問題，然後再次掃描。以下步驟遵循此既定流程；具體選單措詞可能因版本或託管方案而異。

1. 在更改任何內容之前，請先閱讀無效文件報告。

以管理員身分登入，開啟「管理設定」>「概覽」。在完整性警告中，選擇「無效檔案清單…」（標籤可能略有不同）。將報告儲存或複製到私密位置，以便在修復後進行比較。該報告會識別應用程式或核心區域，並列出諸如「錯誤INVALID_HASH」、 「錯誤」 MISSING_FILE、EXTRA_FILE「錯誤」和「錯誤」等條件EXCEPTION。

在替換伺服器檔案之前，請備份 Nextcloud 設定、資料庫和所有自訂應用程式程式碼。請勿編輯檔案signature.json、產生替換簽名以消除警告，或僅因為檔案名稱出現在報告中就刪除檔案。此檢查旨在保護程式碼的真實性，並可能發現需要調查的意外文件。

2. 將錯誤類型與正確的修復方法配對

這些標籤僅供診斷參考，並非攻擊的證據，也並非安裝安全的證明。開發人員的本機編輯、複製的備份檔案、不完整的部署以及未經授權的程式碼都可能導致不同的結果。如果您無法解釋意外出現的 PHP 檔案或核心檔案更改，請保留報告並進行調查，然後再刪除或覆寫它。

3. 從 Nextcloud 的原始版本還原核心文件

如果報告中提及的檔案位於 `<path>` 下core，例如 `<filename> index.php` 或version.php`<filename>`，請先檢查升級是否中途停止，或部署程序是否更改了程式碼。請在管理概覽中或透過常規部署記錄確認已安裝的版本。請勿從其他 Nextcloud 版本複製檔案：其雜湊值與伺服器上安裝的版本不符。

盡可能使用官方支援的更新程序完成中斷的升級。如果必須手動恢復文件，請從 Nextcloud 官方下載頁面下載匹配的伺服器歸檔文件，使用已發布的校驗和或 PGP 簽名驗證歸檔文件，然後根據 Nextcloud 的升級說明僅替換受影響的應用程式程式碼檔案。請保留config/資料目錄以及任何本地維護的應用程式或主題。請遵循適用於您安裝方式的備份和維護模式流程；Docker、Snap、虛擬設備和託管主機可能需要各自的更新流程。

Nextcloud 的完整性指南針對無效的核心雜湊值給出了相同的原則：恢復正確的文件，然後重新掃描。如果透過 FTP 傳輸文件，指南特別提醒使用二進位傳輸模式。避免為了圖方便而停用簽名驗證並執行更新。手動安裝的未經驗證的歸檔文件可能會引入新的完整性和安全問題。

4. 仔細檢查額外文件和自訂變更。

條目EXTRA_FILE可能是殘留的臨時檔案、編輯器備份、自訂腳本或您無法識別的內容。請檢查其完整路徑、時間戳記、擁有者和部署歷史記錄。如果是合法的自訂工具，請將其移出 Nextcloud 服務代碼目錄，並在適當情況下透過支援的應用程式或單獨的服務公開。如果是過時的備份，請在保留所有必要資訊後再刪除。如果最近出現無法解釋的可執行文件或 PHP 文件，請將其視為安全調查：保留證據、審查訪問日誌和 Web 伺服器日誌，並遵循您的事件回應流程，而不是簡單地刪除警告。

對於INVALID_HASH您有意編輯的核心文件中的錯誤，可持續的修復方法是恢復已簽署的核心文件，並將自訂行為移至受支援的應用程式、主題或已記錄的擴充點。請勿變更預期雜湊值或修改發布元資料以使檢查通過。自訂 Nextcloud 發行版在程式碼簽署文件中有單獨的發布分支注意事項；更改此設定適用於自訂發行版的維護者，而非標準安裝的常規修復。

5. 修復應用程式簽名或應用程式文件

如果報告中提及了應用程式目錄，請確定其應用程式 ID，並判斷該應用程式是已更新、手動複製還是已在本機修改。使用 Nextcloud 的應用程式介面或您的部署方法，從可信任來源更新或重新安裝相容版本。請先備份套用特定的資料和配置，並檢查其與您的 Nextcloud 主要版本是否相容。對於自訂或內部開發的應用，請向其維護者索取已簽署的軟體包或已修正的版本。 Nextcloud 要求透過其應用程式商店發布的應用程式進行程式碼簽署；其他應用程式類別的簽名要求和執行方式可能有所不同，因此請使用相關的開發者文檔，而不是自行建立本機簽章。

請勿使用隨機壓縮包覆蓋應用程式目錄，也不signature.json要從其他版本複製應用程式目錄。簽名描述了特定的程式碼；混合使用來自不同版本的檔案可能會導致其他錯誤。如果您需要移除應用程序，請使用官方支援的應用程式管理流程，並確認移除作業不會遺失貴組織所需的資料。

6. 運行新的完整性檢查

修復報告的文件後，返回「管理設定」>「概覽」，然後選擇「重新掃描…」。等待掃描完成，然後重新開啟無效文件清單。如果您透過 SSH 管理伺服器，Nextcloud 35 文件中提供了從 Nextcloud 安裝目錄執行以下命令的說明：

sudo -E -u www-data php occ integrity:check-core
sudo -E -u www-data php occ integrity:check-app calendar
sudo -E -u www-data php occ integrity:check-app --all

請將此處替換calendar為報告中顯示的應用程式 ID。該www-data帳戶在基於 Debian 或 Ubuntu 的安裝中很常見，但您的 Web 伺服器使用者和 PHP 執行檔可能有所不同。請使用適用於您系統的正確帳戶和 PHP 環境；對於容器安裝，請在對應的容器內執行等效命令。目前的 OCC 手冊指出，成功的應用程式檢查可能不會產生任何輸出，除非請求詳細模式，而失敗則會列出詳細資訊。

如何判斷警告是否已修復

重新開啟管理概覽，確認完整性警告在新掃描後是否消失。如果警告仍然存在，請將新報告與已儲存的副本進行比較：路徑相同表示底層檔案未恢復或使用了錯誤的版本；路徑不同則可能存在其他問題。再次執行相關的核心或套用檢查，並查看 Nextcloud 日誌中是否有簽名錯誤。同時，確認實例能夠正常完成登入、文件瀏覽、上傳和下載操作。

如果在部署後警告再次出現，請檢查是否有重寫已簽署程式碼樹內檔案的自動化腳本、外掛程式或手動維護腳本。如果完整性報告顯示無錯誤，但使用者仍看到錯誤，則原始問題可能由其他原因引起，需要單獨進行故障排除。對於託管的 Nextcloud，請將完整的報告和已安裝的版本傳送給服務提供者；切勿包含密碼、私密金鑰或使用者檔案內容。

有關版本特定詳細信息，請參閱Nextcloud 程式碼簽名和完整性文件、OCC 完整性檢查參考、Nextcloud 更新程式手冊和官方下載頁面。