Nextcloudの削除済みファイルをゴミ箱から自動的に削除する方法

Nextcloudには削除済みファイルを自動的にクリーンアップするために必要な機能が既に含まれているため、ほとんどの管理者はカスタムシェルスクリプトを作成する必要はありません。現在のNextcloud 35の管理ドキュメントでは、推奨されるアプローチは、定義されたゴミ箱保持ポリシーと信頼性の高いバックグラウンドジョブの実行を組み合わせることです。重要な点は、デフォルトのautoポリシーが「30日後にすべてを削除する」というものではないということです。削除されたアイテムは少なくとも30日間保持され、その後、空き容量が必要になったときにクリーンアップの対象となります。

クリーンアップを予測可能にしたい場合は、最大保持期間を明示的に設定し、Nextcloud のバックグラウンド ジョブがシステムの cron で実行されるようにしてください。以下の手順では、Nextcloud が公式に文書化した動作のみを使用し、コマンドocc trashbin:expireとtrashbin:cleanupコマンドが適切な場合についても説明します。

自動ゴミ箱清掃の実際の動作

削除済みファイルアプリ（files_trashbin）が有効になっている場合、ユーザーが削除したファイルはすぐに削除されるのではなく、ゴミ箱に移動されます。これにより、ユーザーは復元する猶予期間を得られますが、削除されたアイテムはストレージを消費し続けます。Nextcloud は、trashbin_retention_obligation設定でそれらの存続期間を制御しますconfig/config.php。

現在のNextcloudのごみ箱設定に関するドキュメントでは、以下のポリシー形式が定義されています。

もう一つ注意すべきストレージに関するルールがあります。削除されたファイルによってユーザーの割り当て容量を超過した場合、Nextcloudは保持設定を無視して、割り当て容量が満たされるまで不要なファイルを削除してしまう可能性があります。そのため、保持設定は不変のバックアップ保証として扱うべきではありません。

ステップ1：変更を加える前に保持ポリシーを選択してください

環境におけるゴミ箱の用途を明確にしましょう。ユーザーが誤って削除したファイルを復元することが多い場合は、復元可能な最小期間を設定してください。ストレージ容量の制限やデータ保持ポリシーの策定を優先する場合は、最大期間も設定しましょう。

例えば、この設定では、いつでも容量ベースのクリーンアップを実行できますが、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ウェブサーバーアカウントを使用する一般的なLinuxインストール環境では、そのアカウントのcrontabを編集します。

crontab -u www-data -e

次に、Nextcloud をcron.php5 分ごとに実行します。

*/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分ごとに実行されると説明されています。5cron.php分ごとに呼び出されるということは、ゴミ箱が5分ごとに完全に空になるという意味ではなく、スケジューラが期限切れのジョブを頻繁に実行する機会を得るという意味です。

ステップ4：スケジューラが正常に動作していることを確認する

cronの設定後、まずオペレーティングシステムのエントリを確認してください。

crontab -u www-data -l

次に、Nextcloudの管理設定でバックグラウンドジョブのステータスを確認してください。ページには、ジョブが最近実行されたことが表示されるはずです。表示される最終実行時刻がどんどん古くなっていく場合は、保持ポリシーを診断する前にcronを修正してください。

Nextcloud 35 では、ドキュメントに記載されているコマンドに、、、などoccのバックグラウンド ジョブ検査コマンドも含まれています。これらは、cron がアクティブであると単に想定するのではなく、ジョブが処理されていることを確認する必要がある場合に役立ちます。background-job:listbackground-job:runningbackground-job:history

ステップ5：ポリシーベースの手動実行にはtrashbin:expireを使用する

カスタム保持期間を設定した場合は、以下の方法でそのポリシーを手動で適用できます。

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

Nextcloudのファイルおよびゴミ箱コマンドに関する現在のリファレンスには、重要な制限事項が記載されています。trashbin:expireそれは、カスタム保持期間が設定されている場合にのみ、手動での有効期限切れ処理が実行されるというものです。デフォルトのautoポリシーでは、自動有効期限切れ処理はバックグラウンドジョブによって行われるため、コマンドは情報メッセージを表示して終了し、何も実行されません。

意図的に別のシステム cron エントリが必要な場合は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日後に正確に削除されるとは限りません。次に、バックグラウンドジョブを確認してください。これらの確認が終わってから、アクセス許可、ストレージバックエンド、またはアプリケーションログを調査するようにしてください。

ほとんどのセルフホスト型サーバーに適した実用的な構成

一般的なセルフホスト型インスタンスの場合、適切な出発点としては、5分ごとにシステムcronを使用して、明確な最大ゴミ箱保持期間を定義することです。たとえば、'auto, 30'通常の条件下では、アイテムが永久に残らないようにしながら、ユーザーに約1か月の保持期間を提供します。ストレージ負荷に関係なく、ユーザーが常に完全なリカバリウィンドウを必要とする場合は、代わりに、などの制限付き最小値と最大値ポリシーを使用してください'30, 30'。

バックアップデータはゴミ箱とは別に保管してください。ゴミ箱は、容量制限と保持期間が設定されたユーザー復旧機能であり、独立したバックアップ戦略の代替となるものではありません。

Nextcloudの公式リファレンス

• 削除済みアイテム（ゴミ箱） — Nextcloud 管理者マニュアル
• バックグラウンドジョブ — Nextcloud 管理マニュアル
• ファイルとゴミ箱に関するOCCコマンド — Nextcloud管理マニュアル
• 削除されたファイル — Nextcloudユーザーマニュアル