コマンドラインからownCloudのファイルバージョン履歴を削除する方法

ownCloudのコマンドラインでは、ファイルバージョンを削除することでストレージを解放できますが、適切なコマンドは「パージ」の意味によって異なります。ownCloudでは、設定された保持ポリシーに違反するバージョンのみを期限切れにしたり、1つまたは複数のアカウントの保存済みバージョンをすべて削除したり、システム全体のすべてのバージョンを削除したりできます。これらの選択肢は、元に戻せるかどうか、また適用範囲が大きく異なります。まず、サーバーがownCloud ServerかownCloud Infinite Scaleかを確認してください。これらは異なるコマンドラインツールを使用します。

以下のコマンドは、ownCloud Server 10.16および11.0の最新管理ドキュメントとInfinite Scale 8.2ガイドに基づいています（2026年10月6日確認）。パス、サービス名、アカウントIDはインストール環境によって異なるため、本番サーバーで実行する前に例を適宜修正してください。

目的に合った清掃方法を選択してください

定期的なストレージ管理には、保持ポリシーから始めてくださいversions:expire。versions:cleanup選択した履歴を今すぐ意図的に消去したい場合にのみ使用してください。

1. ownCloud製品とコマンドの場所を確認してください。

ownCloud Server の場合、PHP アプリケーションを実行しているホストまたはコンテナに接続し、occスクリプトが配置されている ownCloud インストール ディレクトリに移動します。一般的な Linux パターンは、Web サーバー アカウントとしてコマンドを実行することです。多くの場合、www-dataまたは次のようにwwwrunなります。

cd /var/www/owncloud
sudo -u www-data php occ status

ご使用のシステムに合わせて、実際のインストールパスとウェブサーバーアカウントを使用してください。rootocc権限で実行すると、ファイルの所有者が誤ったアカウントのままになる可能性があるため、ドキュメントに記載されているサービスアカウントを使用してください。バージョン管理アプリがfiles_versions有効になっていることを確認してください。このアプリが無効になっている場合、バージョンコマンドは使用できず、シングルユーザーメンテナンスモードでも使用できません。

ownCloud ServerがDockerで実行されている場合は、アプリケーションコンテナ内でコマンドを実行してください。たとえば、Compose構成ファイルを含むディレクトリから、デプロイメントでは を使用できます。 はComposeファイル内の実際のサービス名にdocker compose exec owncloud occ status置き換えてくださいowncloud。Infinite Scaleの例は使用しないでくださいocc。

2. 履歴の保持を強制するか、履歴を消去するかを決定する。

ポリシーベースのクリーンアップが必要な場合は、有効期限を使用してください。

versions:expireversions_retention_obligation設定に基づいてバージョンを評価しますconfig.php。ユーザーIDを指定しない場合、すべてのユーザーに適用されます。1つまたは複数のユーザーIDを指定することもできます。単一アカウントの場合、コマンドは次のとおりです。

sudo -u www-data php occ versions:expire alice

アカウントIDには、実際のIDを入力してください。インストール環境でアカウントが識別される方法が表示名やメールアドレスでない限り、表示名やメールアドレスは使用しないでください。すべてのアカウントで有効期限切れ処理を実行するには、を省略してくださいalice。このオプションは、設定された保持ルールを尊重します。つまり、最近のバージョンやその他の保持されているバージョンが必ずしも削除されるわけではありません。

ownCloud Server のドキュメントでは、autoデフォルトの保持パターンとして、時間ベースの代替パターンについても説明しています。特に組織に法的または運用上の保持要件がある場合は、有効期限を実行する前にポリシーを確認してください。通常の定期的な有効期限実行の場合、ownCloud はこれをバックグラウンド ジョブとして実行します。管理マニュアルでは、バックグラウンド ジョブにはシステム cron を使用することを推奨しています。有効期限を手動で呼び出すことは、意図的なメンテナンス実行には便利ですが、適切に構成されたスケジューラの代わりとして使用すべきではありません。

対象範囲内のすべてのバージョンを削除する場合は、クリーンアップを使用してください。

1つのアカウントに対して、以下を実行します。

sudo -u www-data php occ versions:cleanup alice

複数のアカウントの場合は、IDをスペースで区切って入力してください。

sudo -u www-data php occ versions:cleanup alice bob

IDが指定されていない場合、このコマンドはすべてのユーザーのすべてのバージョン管理されたファイルを削除します。

sudo -u www-data php occ versions:cleanup

復元時にバージョンが必要になる可能性がある場合は、まずバックアップを取り、実行前にアカウント ID を確認してください。記載されているコマンドは、files_versionsその範囲のバージョン データと関連フォルダを削除します。また、通常の保持期間を超えて残る可能性のある公開済みバージョンも削除します。ownCloud Server の にはサポートされている「プレビューのみ」フラグが文書化されていないversions:cleanupため、タイプミスや ID の省略は、意図したよりも大きな影響を与える可能性があります。

3. ownCloud ServerとInfinite Scaleの違いを理解する

ownCloud Infinite Scale (oCIS) は PHPocc versions:cleanupコマンドを使用しません。管理ドキュメントでは、リビジョンのクリーンアップは で行われると説明されていますocis revisions purge。このコマンドはデフォルトでドライランを実行し、リビジョンを削除せずに削除する内容を報告します。設定済みのユーザーストレージパスが必要です。この例では、プレースホルダーパスを使用します。

ocis revisions purge -p /base/path/storage/users

ドライランの結果を確認し、保存パスが正しいことを検証します。実際にその実行でリストされたリビジョンを削除するには、ドライランを明示的に無効にします。

ocis revisions purge --dry-run=false -p /base/path/storage/users

デフォルトでは、Infinite Scale コマンドはすべてのスペースのリビジョンを対象とします。--resource-id適切な ID が分かっている場合は、オプションを使用して操作をスペースまたは個々のファイルに絞り込むことができます。パスまたはスコープが不明な場合は、ドライランで停止し、デプロイメント構成で両方を確認してください。ドキュメントには、代替のグロビング モードを使用すると、大きなスペースで CPU とメモリの使用量が増加する可能性があると記載されています。変更の必要性を測定しない限り、デフォルトのままにしてください。

4. これ以上データを削除せずに結果を確認する

サーバーのクリーンアップ後、Webインターフェースで代表的なアカウントをいくつか確認し、各ファイルのバージョン履歴に古いエントリが表示されていないことを確認します。コマンドの出力で、処理されたユーザーを確認します。Infinite Scaleの場合は、パージ結果をドライランの出力と比較し、コマンドの完了ステータスを確認します。次に、ownCloudのクォータレポート、ローカルファイルシステム、または構成済みのオブジェクトストアなど、デプロイメントに関係するレイヤーでストレージの使用状況を確認します。

パージを完了するために、ファイルを手動で削除しないでくださいfiles_versions。ownCloud のサポートされているコマンドは、アプリケーションのメタデータと連携してバージョンクリーンアップを実行します。アプリケーションの背後にあるストレージオブジェクトを削除すると、レコードに矛盾が生じる可能性があります。また、ストレージバックエンドにスナップショット、レプリケーション、または独自の遅延削除機能がある場合、サーバーのディスク容量の解放数は削除されたバージョンの数と異なる場合があります。この点はバックエンドに依存するため、管理者またはプロバイダに確認する必要があります。

どちらのオプションを選択すべきでしょうか？

• versions:expire既存の保持ルールに基づいて継続的な割り当て管理を行うことが目標である場合に選択してください。
• versions:cleanup USER_ID既知のアカウントのすべての履歴を削除する必要があり、復元ポイントの喪失を許容できる場合は、「スコープ指定」を選択してください。
• versions:cleanupバックアップと範囲レビュー後に意図的にシステム全体をリセットする場合にのみ、「グローバル」を選択してください。
• oCIS でのみInfinite Scale パージ ワークフローを選択し、設定する前にデフォルトのドライランを確認してください--dry-run=false。

公式リファレンス: ownCloud Server OCC コマンド リファレンス、ownCloud Server ファイル バージョン管理と保持、ownCloud Server バックグラウンド ジョブ、およびInfinite Scale リビジョン クリーンアップ。

バージョンに関する注記：コマンドの動作と例は、2026年10月6日にownCloud Server 10.16/11.0およびInfinite Scale 8.2のドキュメントに基づいて検証されました。破壊的な操作を実行する前に、インストールされているリリースに対応するマニュアルを確認してください。