명령줄을 사용하여 ownCloud 파일 버전 기록을 삭제하는 방법

ownCloud의 명령줄을 사용하면 파일 버전을 삭제하여 저장 공간을 확보할 수 있지만, "삭제"의 의미에 따라 적절한 명령이 달라집니다. ownCloud에서 설정된 보존 정책을 위반하는 버전만 만료시키거나, 하나 이상의 계정에 저장된 모든 버전을 삭제하거나, 시스템 전체의 모든 버전을 삭제할 수 있습니다. 이러한 옵션은 복구 가능성과 삭제 범위 측면에서 큰 차이가 있습니다. 먼저 서버가 ownCloud Server 인지 ownCloud Infinite Scale 인지 확인하십시오 . 두 유형은 서로 다른 명령줄 도구를 사용합니다.

아래 명령어는 현재 ownCloud Server 10.16 및 11.0 관리 문서와 Infinite Scale 8.2 가이드를 기반으로 작성되었으며, 2026년 10월 6일 기준으로 확인되었습니다. 경로, 서비스 이름 및 계정 ID는 설치 환경에 따라 다를 수 있으므로, 프로덕션 서버에서 실행하기 전에 예제를 수정하십시오.

목표에 맞는 청소 방법을 선택하세요.

방법	제거되는 것	가장 적합한	주요 절충점
`versions:expire`ownCloud 서버에서	설정된 보존 규칙에 따라 만료된 것으로 간주되는 버전	정기 유지보수 및 할당량 관리	이 기능은 정책이 적용되는 버전을 보존하므로 전체 삭제만큼 즉시 공간을 확보하지 못할 수 있습니다.
`versions:cleanup USER_ID`ownCloud 서버에서	지정된 계정 또는 계정들에 대한 모든 저장된 버전	특정 계정의 기록 삭제	해당 사용자는 게시된 버전을 포함하여 이전 버전을 복원할 수 있는 기능을 잃게 됩니다.
`versions:cleanup`사용자 ID 없음	모든 ownCloud 서버 사용자를 위한 모든 저장된 버전	계획된 조직 전체의 재설정	이는 광범위한 파괴 작전이며, 문서화된 명령에는 미리보기 옵션이 없습니다.
`ocis revisions purge`무한한 규모로	기본적으로 모든 공간에서 수정이 이루어지거나, 지정된 경우 더 좁은 리소스 범위에서 수정이 이루어집니다.	Infinite Scale 배포 환경에서 수정 사항 정리가 필요합니다.	시뮬레이션 실행 동작 및 저장 경로 옵션은 ownCloud Server의 `occ`명령과 다릅니다.

반복적인 저장 공간 관리를 위해서는 보존 정책부터 시작하세요 versions:expire. versions:cleanup선택한 기록을 지금 바로 삭제하려는 경우에만 사용하세요.

1. 사용 중인 ownCloud 제품과 명령 위치를 확인하세요.

ownCloud 서버의 경우, PHP 애플리케이션이 실행되는 호스트 또는 컨테이너에 연결한 다음 occ스크립트가 있는 ownCloud 설치 디렉터리로 이동합니다. 일반적인 Linux 패턴은 웹 서버 계정(종종 www-data또는 wwwrun) 으로 명령을 실행하는 것입니다.

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

시스템의 실제 설치 경로와 웹 서버 계정을 사용하십시오. occ루트 권한으로 실행하면 파일 소유자가 잘못된 계정으로 남을 수 있으므로 문서화된 서비스 계정을 사용하십시오. 버전 관리 앱이 files_versions활성화되어 있는지 확인하십시오. 해당 앱이 비활성화된 경우 버전 명령을 사용할 수 없으며, 단일 사용자 유지 관리 모드에서도 사용할 수 없습니다.

ownCloud 디렉터리의 터미널에서 www-data 사용자로 occ status 명령어를 입력합니다. — 이 `occ status`명령어는 버전 정리를 하기 전에 ownCloud 서버 설치를 확인합니다.

ownCloud 서버가 Docker에서 실행되는 경우 애플리케이션 컨테이너 내부에서 명령을 실행하십시오. 예를 들어, Compose 구성 파일이 있는 디렉터리에서 배포 시 ` <service name="infinite scale">` 명령어를 사용할 수 있습니다. 여기서 `<service name="infinite scale">`은 Compose 파일에 있는 실제 서비스 이름으로 docker compose exec owncloud occ status바꿔야 합니다 owncloud. 무한 확장(Infinite Scale) 예제는 사용하지 마십시오 occ.

2. 기록 보존을 강제할지 또는 삭제할지 결정합니다.

정책 기반 정리를 원할 때 만료 기능을 사용하세요.

versions:expireversions_retention_obligation설정값에 따라 버전을 평가합니다 config.php. 사용자 ID가 없으면 모든 사용자에게 적용됩니다. 하나 이상의 사용자 ID를 나열할 수도 있습니다. 단일 계정의 경우 명령은 다음과 같습니다.

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

실제 계정 ID를 입력하십시오. 사용자의 표시 이름이나 이메일 주소는 설치 환경에서 계정 식별에 사용되는 방식이 아닌 한 사용하지 마십시오. 모든 계정에 대해 만료 프로세스를 실행하려면 를 생략하십시오 alice. 이 옵션을 선택하면 구성된 보존 규칙이 적용되므로 최근 버전이나 보존된 버전은 삭제되지 않을 수 있습니다.

터미널 화면에는 alice 계정에 한정된 ownCloud 버전 만료(versions:expire) 명령이 표시됩니다. — 이 `versions:expire`명령은 구성된 보존 정책을 지정된 계정 하나에 적용합니다.

ownCloud 서버 설명서에는 auto기본 보존 패턴과 시간 기반 대안이 설명되어 있습니다. 특히 조직에 법적 또는 운영상의 보존 요건이 있는 경우, 만료를 실행하기 전에 정책을 검토하십시오. 일반적인 정기 만료의 경우 ownCloud는 백그라운드 작업으로 실행합니다. 관리 설명서에서는 백그라운드 작업에 시스템 cron 사용을 권장합니다. 수동으로 만료를 실행하는 것은 의도적인 유지 관리 작업에 유용하지만, 올바르게 구성된 스케줄러를 대체해서는 안 됩니다.

범위 내의 모든 버전을 삭제하려는 경우 정리 기능을 사용하십시오.

계정 하나당 다음 명령을 실행하세요.

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

터미널 화면에는 alice 계정에 대해 실행된 ownCloud 버전 정리 명령이 표시됩니다. — 계정 ID를 전달하면 전체 기록 정리 작업이 해당 사용자에게만 적용됩니다.

복구에 버전이 필요할 수 있는 경우 먼저 백업을 수행하고 실행 전에 계정 ID를 확인하십시오. 문서화된 명령은 files_versions해당 범위 내의 버전 데이터와 관련 폴더를 삭제합니다. 또한 일반적인 보존 기간을 넘어 계속 남아 있는 게시된 버전도 제거합니다. ownCloud Server에는 "미리 보기 전용" 플래그가 지원되지 않으므로 versions:cleanup오타나 ID 누락으로 인해 의도치 않은 큰 문제가 발생할 수 있습니다.

3. ownCloud 서버와 무한 확장의 차이점을 이해하세요

ownCloud Infinite Scale(oCIS)은 PHP 명령어를 사용하지 않습니다 occ versions:cleanup. 관리 문서에는 리비전 정리를 위한 명령어가 설명되어 있습니다 ocis revisions purge. 이 명령어는 기본적으로 리비전을 삭제하지 않고 제거할 항목을 보고하는 드라이 런(dry run)을 실행합니다. 구성된 사용자 스토리지 경로가 필요하며, 이 예제에서는 자리 표시자 경로를 사용합니다.

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 및 메모리 사용량을 증가시킬 수 있으므로, 변경이 필요한 경우가 아니면 기본 설정을 유지하는 것이 좋습니다.

터미널에 ownCloud 서버 버전:cleanup 명령어가 표시되고 계정 ID가 나타나지 않습니다. 이는 전체 삭제가 진행 중임을 나타냅니다. — 사용자 ID가 없으면 `versions:cleanup`모든 ownCloud 서버 사용자를 대상으로 합니다.

4. 추가 데이터 삭제 없이 결과를 확인합니다.

서버 정리 후 웹 인터페이스에서 몇 개의 대표 계정을 확인하여 각 파일의 버전 기록에 이전 항목이 더 이상 표시되지 않는지 확인합니다. 처리된 사용자에 대한 명령 출력을 확인합니다. Infinite Scale의 경우, 삭제 결과를 사전 실행 결과와 비교하고 명령 완료 상태를 검토합니다. 그런 다음 배포 환경에 중요한 계층(ownCloud 할당량 보고, 로컬 파일 시스템 또는 구성된 객체 저장소)에서 스토리지 사용량을 확인합니다.

삭제 작업을 "완료"하기 위해 파일을 수동으로 제거하지 마십시오 files_versions. ownCloud에서 지원하는 명령은 애플리케이션 메타데이터와 연동하여 버전 정리를 수행합니다. 애플리케이션 삭제 후 스토리지 객체를 수동으로 삭제하면 기록이 일관되지 않을 수 있습니다. 또한 스토리지 백엔드에 스냅샷, 복제 또는 지연 삭제 기능이 있는 경우 서버 디스크 공간 회수량이 제거된 버전 수와 다를 수 있습니다. 이 부분은 백엔드에 따라 다르므로 관리자 또는 공급업체에 문의해야 합니다.

어떤 옵션을 사용해야 할까요?

versions:expire기존 유지 규칙을 활용한 지속적인 할당량 관리가 목표인 경우를 선택하세요 .
versions:cleanup USER_ID알려진 계정의 모든 기록을 삭제해야 하고 복원 지점 손실을 감수할 경우 '범위 지정'을 선택하세요 .
versions:cleanup백업 및 범위 검토 후 의도적인 시스템 전체 초기화를 수행하려면 '전역' 옵션만 선택하십시오 .
oCIS에서만 무한 스케일 제거 워크플로를 선택--dry-run=false 하고 설정하기 전에 기본 드라이 런을 검토하십시오 .

공식 참조: ownCloud 서버 OCC 명령 참조 , ownCloud 서버 파일 버전 관리 및 보존 , ownCloud 서버 백그라운드 작업 및 Infinite Scale 개정 정리 .

버전 참고: 명령 동작 및 예제는 2026년 10월 6일에 ownCloud Server 10.16/11.0 및 Infinite Scale 8.2 설명서를 기준으로 확인되었습니다. 파괴적인 작업을 실행하기 전에 설치된 릴리스에 해당하는 설명서를 확인하십시오.