如何自動清理 Nextcloud 回收站中已刪除的文件

Nextcloud 已經包含了自動清理已刪除檔案所需的元件，因此大多數管理員無需編寫自訂 shell 腳本。根據目前的 Nextcloud 35 管理文檔，建議的做法仍然是將定義的回收站保留策略與可靠的後台作業執行相結合。需要注意的是，預設auto策略並非「30 天後刪除所有內容」。它會將已刪除的項目保留至少 30 天，然後在需要空間時將其清理。

如果您的目標是實現可預測的清理，請明確設定最大保留期限，並確保 Nextcloud 後台作業透過系統 cron 運行。以下步驟僅使用 Nextcloud 官方文件中記錄的行為，並解釋了何時適用occ trashbin:expire這些命令。trashbin:cleanup

自動垃圾桶清理功能究竟能做什麼

啟用「已刪除檔案」套用（files_trashbin）後，使用者刪除的檔案會移至回收站，而不是立即刪除。這為用戶提供了一個恢復窗口，但這些已刪除的項目仍然會佔用儲存空間。 Nextcloud 透過設定trashbin_retention_obligation來控制這些文件的保留時間config/config.php。

目前Nextcloud 回收站配置文件定義了以下策略形式：

環境	意義	非常合身
`auto`	物品至少保留 30 天；之後，當需要騰出空間時，即可移除符合條件的物品。	小型安裝，對預設行為感到滿意。
`D, auto`	物品至少保留 D 天，然後根據空間大小進行清理。	你需要設定一個最短的恢復視窗期，但不需要設定一個嚴格的刪除截止日期。
`auto, D`	保證在 D 天後刪除，同時允許更早進行空間驅動的清理。	您希望設定最長保存期限，但當儲存壓力增加時，可以容忍提前刪除。
`D1, D2`	物品至少保留 D1 天，超過 D2 天後刪除。	您既需要設定最短恢復期，也需要設定最長保留年限。
`disabled`	關閉自動回收站過期功能。	只有在有意無限期保留數據，並且以其他方式管理儲存成長的情況下才需要這樣做。

還有一條儲存規則需要注意：如果由於刪除文件導致用戶配額超出，Nextcloud 可能會忽略保留設置，直接清理已刪除文件，直到配額滿足為止。因此，不應將保留設定視為不可更改的備份保證。

第一步：在變更任何內容之前，請先選擇保留策略。

確定回收站在您的環境中的用途。如果使用者經常需要恢復誤刪的文件，請為他們設定一個合理的最小恢復期限。如果您優先考慮的是限時儲存或資料保留策略，則也需要定義一個最大恢復期限。

例如，此設定允許隨時進行基於空間的清理，但保證刪除超過 30 天的檔案：

'trashbin_retention_obligation' => 'auto, 30',

如果您希望已刪除的檔案至少保留 30 天，並在 30 天後刪除，請改用有界策略：

'trashbin_retention_obligation' => '30, 30',

選擇符合您恢復需求的值。較短的恢復期限可以更快地節省儲存空間，但會減少使用者恢復檔案的時間。較長的恢復期限可以提供更長的恢復時間，但可能會增加磁碟使用量。

步驟 2：在 config.php 中設定 trashbin_retention_obligation

開啟 Nextcloud 設定文件，通常位於config/config.php安裝目錄下。新增或變更數組中的設定$CONFIG。一個典型範例是：

<?php
$CONFIG = array (
  // Other Nextcloud settings...
  'trashbin_retention_obligation' => 'auto, 30',
);

不要編輯無關的值，並注意不要在工單或螢幕截圖中暴露內容，config.php因為它可能包含敏感的伺服器配置。

您也可以透過 Nextcloud 的命令列工具檢查有效配置，而不是將檔案內容複製到故障排除訊息中。

步驟 3：使用系統 cron 來執行可靠的背景作業

只有當 Nextcloud 後台任務實際運作時，保留策略才能發揮作用。 Nextcloud 的後台任務文件建議在生產環境中使用作業系統自帶的 cron 任務。 AJAX 是預設模式，但它依賴頁面訪問量，可靠性最低。

www-data在典型的使用Web 伺服器帳戶的Linux 系統中，編輯該帳戶的 crontab 檔案：

crontab -u www-data -e

cron.php然後每五分鐘運行一次 Nextcloud ：

*/5 * * * * php -f /var/www/nextcloud/cron.php

請替換/var/www/nextcloud為您的實際安裝路徑。某些系統需要完整的 PHP CLI 路徑，例如/usr/bin/php。

您也可以使用以下命令明確選擇 cron 模式：

sudo -E -u www-data php /var/www/nextcloud/occ background:cron

Nextcloud 文件中提到，回收站過期後台作業每 30 分鐘執行一次。cron.php每 5 分鐘調用一次並不意味著回收站每 5 分鐘清空一次；而是指調度程序有更頻繁的機會運行到期作業。

步驟 4：驗證調度程序是否正常運作

配置 cron 任務後，請先驗證作業系統中的相關條目：

crontab -u www-data -l

然後檢查 Nextcloud 的管理設置，查看後台作業狀態。頁面應該顯示作業最近有運作過。如果顯示的上次運行時間持續變長，請先修復 cron 配置，然後再診斷保留策略的問題。

在 Nextcloud 35 中，文件中occ也包含後台作業檢查指令，例如`cron -l` background-job:list、background-job:running`cron -l` 和 `cron background-job:history-l`。這些命令可以幫助您驗證作業是否正在處理，而不僅僅是假設 cron 處於活動狀態。

步驟 5：使用 trashbin:expire 進行基於策略的手動運行

如果您配置了自訂保留期限，則可以使用下列命令手動套用該原則：

sudo -E -u www-data php /var/www/nextcloud/occ trashbin:expire

目前Nextcloud 文件和回收站命令參考文件指出了一個重要的限制：trashbin:expire僅在配置了自訂保留期限時才會執行手動過期操作。在預設auto策略下，此指令會顯示一資訊性訊息後退出，而不執行任何操作，因為自動過期會由後台作業處理。

如果您特意想要為 Nextcloud 添加一個單獨的系統定時任務trashbin:expire，Nextcloud 文件中提供了一種方法，可以先停用該應用程式內建的回收站過期後台任務：

sudo -E -u www-data php /var/www/nextcloud/occ config:app:set --value=no files_trashbin background_job_expire_trash

然後您可以occ trashbin:expire --quiet自行安排任務。這是一個進階選項。對於大多數安裝而言，啟用內建的過期任務並執行 Nextcloud 的常規cron.php排程會更簡單，也更容易維護。

不要將 trashbin:expire 與 trashbin:cleanup 混淆

名稱相似，但指令效果截然不同。前者trashbin:expire會刪除符合已配置保留策略的項目。trashbin:cleanup後者會永久刪除您指定使用者的回收站內容。

例如：

sudo -E -u www-data php /var/www/nextcloud/occ trashbin:cleanup --all-users

這是一個破壞性的、針對所有使用者的清除操作。當您需要有意清空所有使用者的回收站時，它很有用，但通常不適用於基於保留策略的例行自動化，因為它會忽略您設計的復原視窗。除非您確實需要永久性、無條件的清除，否則不要將針對所有使用者的清理命令新增至 cron 任務。

步驟 6：檢查並控制 Nextcloud 35 上的回收站大小

Nextcloud 35 的目前命令文件包含trashbin:size一個命令，管理員可以使用該命令全域或按使用者檢查或設定回收站的目標大小。若要查看目前的全域值：

sudo -E -u www-data php /var/www/nextcloud/occ trashbin:size

查看特定使用者的有效目標：

sudo -E -u www-data php /var/www/nextcloud/occ trashbin:size --user USER_ID

當儲存容量是主要考慮因素時，配置的目標大小可以作為基於使用年限的保留策略的補充。 Nextcloud 指出，更改全域預設大小會立即觸發現有回收站的清理，因此請將大小變更視為一項實際操作，而不僅僅是一個無關緊要的顯示設定。

如何判斷自動清理功能是否正常運作

後台作業狀態顯示最近運作狀況。
作業系統 crontab 中包含預期的cron.php條目。
您配置的trashbin_retention_obligation策略與您預期的策略相符。
如果設定了最大使用期限，舊的垃圾物品最終會根據設定的最大使用期限消失。
trashbin:expire配置自訂策略時，其行為與文件所述一致。
磁碟或配額使用量意外停止成長，因為過期的已刪除檔案不再無限期保留。

如果舊文件保留時間超出預期，首先請確認您的策略是否確實設定了最大值。預設auto設定無法保證在第 30 天準時刪除檔案。接下來，請檢查後台作業。只有在完成這些檢查後，您才應該調查權限、儲存後端或應用程式日誌。

適用於大多數自架伺服器的實用配置

對於典型的自託管實例，一個合理的起點是每五分鐘使用系統定時任務 (cron) 並明確定義最大回收期限。例如，'auto, 30'在正常情況下，這可以為用戶提供大約一個月的回收時間，同時確保專案不會無限期地保留。如果使用者必須始終擁有完整的恢復窗口，無論儲存壓力如何，則應使用有界最小和最大回收期限策略'30, 30'。

請將備份文件與回收站分開。回收站是用戶復原功能，具有配額和保留策略；它不能取代獨立的備份策略。