透過恢復正確的檔案清除 Nextcloud 完整性警告

若要清除 Nextcloud 的「某些文件未通過完整性檢查」警告，請先開啟「管理設定」→「概覽」→「無效文件清單…」，然後僅恢復或刪除報告中列出的檔案。請勿編輯signature.json或停用此檢查：完整性錯誤可能表示更新不完整、意外進行了自訂，或存在需要調查的意外檔案。

修改文件前請閱讀報告

警告訊息會顯示在管理員概覽頁面上。 Nextcloud 的程式碼簽署文件中介紹了兩個有用的操作：查看無效文件清單和觸發重新掃描。此報告會按元件（例如core應用程式）將問題分組，並提供錯誤類型和檔案路徑。目前的 Nextcloud 35 管理手冊也記錄了這些操作以及occ完整性命令。

• INVALID_HASH檔案與其簽名中記錄的雜湊值不同。這可能是由於本地編輯、升級過程中不完整的替換或意外修改造成的。
• MISSING_FILE：缺少已簽署文件。該文件可能被意外刪除，或在更新過程中遺漏。
• EXTRA_FILE安裝目錄中存在某個文件，但它不屬於已簽署文件集。該文件可能是本機文件、舊版遺留的文件，或需要進行安全審查的文件。
• EXCEPTION驗證器無法驗證簽名，例如，因為缺少必要的簽名資料或簽名資料無效。請檢查指定的應用程式及其來源。

這些標籤描述的是檢查結果，而非原因。額外的檔案並不一定意味著惡意，哈希值不匹配也不代表系統已被入侵。請記錄元件、路徑和錯誤訊息，並將其與您的部署方法和最近的變更進行比較。

進行針對性的檢查

如果您擁有 shell 存取權限，請occ從 Nextcloud 安裝目錄以 Web 伺服器使用者身分執行命令。正確的帳戶和 PHP 命令可能會因作業系統、容器映像、Snap 或託管服務提供者而異。在常見的 Debian 或 Ubuntu Apache 安裝中，Nextcloud 位於 `<path>`，/var/www/nextcloudWeb 使用者為 `<username>` www-data，請使用下列指令：

cd /var/www/nextcloud
sudo -E -u www-data php occ integrity:check-core
sudo -E -u www-data php occ integrity:check-app calendar

請將此處替換calendar為報表中顯示的應用程式標識符。核心檢查會驗證 Nextcloud 伺服器檔案；應用程式檢查會驗證一個指定的應用程式。 Nextcloud 35 手冊中也提供occ integrity:check-app --all了檢查已安裝應用的文件。檢查成功可能不會產生任何輸出；-v請在需要確認時使用。如果您的安裝是容器化的或由軟體包管理的，請使用其文件中記錄的方法來呼叫occ其實際的 Web 用戶，而不是盲目複製這些路徑。

從可信任來源恢復文件

核心文件

對於INVALID_HASH或MISSING_FILE更低版本core，請使用目前已安裝的 Nextcloud 版本。從官方下載來源取得乾淨的歸檔文件，或從已知有效的備份或部署工件中還原相符的文件。取代檔案前，請比較已安裝的版本，並保留特定網站的設定和資料目錄。如果在升級中斷後多個核心檔案損壞，請修復部署或重新執行該安裝類型的支援升級流程，而不是隨機取代單一檔案。

對於文件EXTRA_FILE，請檢查路徑並確定其創建者。如果某個本機檔案並非 Nextcloud 安裝的一部分，請將其移出 Nextcloud 程式碼目錄；如果該檔案可能包含所需的自訂程式碼，請先保留一份副本。如果文件不熟悉或可疑，請保留該文件以進行調查，並在刪除前查看訪問日誌和部署歷史記錄。切勿為了消除警告而隨意刪除文件。

應用程式檔案

對於已簽署但文件被修改或缺少的應用，請從官方 Nextcloud 應用程式商店或應用程式維護者的可信任發布管道重新安裝相同相容版本的應用程式。如果應用程式目錄包含本機更改，請先備份應用程式目錄。如果是自訂應用程式或未簽名應用，完整性訊息可能反映其簽章狀態或實作方式；請諮詢開發者，而不是自行偽造簽章資料。 Nextcloud 文件指出不要修改應用的signature.json. 程式碼簽署機制。核心應用程式和應用程式的程式碼簽章提供了一種檢測更改和不完整升級的方法，因此更改已記錄的雜湊值會破壞此機制。

使用 FTP 傳輸取代檔案時，Nextcloud 特別建議使用二進位傳輸模式。文字模式轉換可能會改變位元組順序，從而導致新的雜湊值不匹配。

重新掃描並確認結果

1. 再次執行符合的核心或應用程式完整性指令，或返回管理設定→概述並選擇重新掃描…。
2. 確認受影響的元件不再出現在無效文件清單中。如果您使用的是命令列介面 (CLI)，則通過的應用檢查不會產生任何輸出；或者，詳細的檢查結果會確認這一點。
3. 重新載入概覽頁面，確認警告已消失。如果警告仍然存在，請開啟更新後的報告；報告可能指向其他文件或不同的元件。

如果立即再次出現相同的錯誤，請調查部署流程、自訂設定或已掛載的磁碟區是否正在還原已變更的檔案。對於簽名異常，請檢查應用程式支援的版本並諮詢其維護人員。如果報告指出存在您無法解釋的核心文件，請將其視為安全性和部署問題，並在繼續操作之前檢查可信任備份和伺服器日誌。

請參閱 Nextcloud 官方程式碼簽署和完整性文件、Nextcloud 35 完整性命令參考以及Nextcloud 官方伺服器版本存檔。