Nextcloud 미리보기 생성기의 높은 CPU 사용량 문제 해결: 미리보기 생성기 설정

간단히 말하자면 , 미리보기 생성기 앱을 설치하고 활성화한 다음, 신중하게 범위를 정하여 처음 한 번 생성하고, 그 후에는 사용량이 occ preview:pre-generate적은 시간대에 생성을 예약하세요. 또한 미리보기 크기와 Nextcloud가 한 번에 생성하는 새 미리보기 개수를 제한하세요. 이 앱은 사용자가 파일을 여는 순간부터 작업을 처리하도록 설정되어 있으며, CPU 사용량에 엄격한 제한을 두지 않으므로 디스크 사용량이 증가할 수 있습니다.

이 설정은 특히 사진이나 문서 라이브러리가 많이 저장된 소규모 서버에서 썸네일 표시로 인해 탐색 중 CPU 사용량이 급증하는 자체 호스팅 Nextcloud 서버에 적합합니다. 하지만 인스턴스에서 서버 측 암호화를 사용하는 경우에는 유용성이 떨어집니다. 미리보기 생성기 프로젝트에서는 암호화를 알려진 비호환성 요소로 명시하고 있습니다. 관리형 호스팅, Nextcloud AIO, Docker 및 패키지 설치는 각각 다른 명령 경로를 사용하므로 배포 환경에 맞게 명령어를 수정해야 합니다. 임의로 지정한 디렉터리에서 명령어를 실행하지 마십시오.

현재 앱 사용 설명서에서는 앱을 설치 및 활성화하고, preview:generate-all한 번 실행한 후, preview:pre-generate나중에 파일 변경 시 실행되도록 예약하는 것을 권장합니다. 첫 번째 명령은 대규모 라이브러리에서 상당한 부하를 줄 수 있습니다. 사용자 또는 폴더 하나와 워커 하나로 시작하십시오. 미리 보기 생성기 프로젝트의 README와 명령 옵션을 확인 하고 Nextcloud 앱 스토어 에서 사용 중인 Nextcloud 버전에 맞는 릴리스를 선택하십시오 .

1. 이것이 올바른 해결책인지 확인하십시오.

먼저 CPU 사용률이 언제 급증하는지 파악하십시오. 사용자가 사진이 많은 폴더나 미리보기가 필요한 문서를 열 때 CPU 사용률이 급증한다면, 미리보기 생성 기능을 통해 해당 작업을 예약된 작업으로 전환할 수 있습니다. 아무도 웹 브라우징을 하지 않을 때에도 CPU 사용률이 높거나, 다른 서비스와 동시에 CPU 사용률이 급증하는 경우에는 미리보기 생성 기능이 원인을 해결하지 못할 수 있습니다. 설정을 변경하기 전에 프로세스 모니터와 Nextcloud 로그를 확인하십시오.

미리보기 생성기는 추가되거나 변경된 파일을 기록하고 백그라운드 작업으로 처리합니다. 기존 미리보기가 있으면 이후 요청 시 처리 속도가 빨라지지만, 예약된 작업이 처리하기 전에 누락된 미리보기를 필요에 따라 생성할 수도 있습니다. 즉, 큐가 밀린 작업이 처리될 때 앱이 사용자에게 표시되는 트래픽 급증 현상을 줄여줍니다. 하지만 CPU 사용량 급증이 전혀 없다고 보장할 수는 없습니다. 또한, 미리보기 제공 속도를 높이는 대신 저장 공간을 일부 사용합니다. 사용자가 파일을 자주 열람하지 않는 소규모 도서관이라면 Nextcloud의 온디맨드 방식이 적합할 수 있습니다.

2. 호환되는 앱 버전을 설치하세요.

Nextcloud 관리자 계정으로 로그인하고 앱 영역을 열어 Preview Generator를 찾아 설치 및 활성화하세요. 진행하기 전에 App Store에서 설치된 Nextcloud 주요 버전에 맞는 안정적인 릴리스를 제공하는지 확인하세요. App Store에서 호환되지 않는다고 표시된 버전에 최신 앱 폴더를 수동으로 복사하지 마세요.

셸 액세스 권한이 있는 관리자는 해당 명령어를 통해 앱을 확인하거나 활성화할 수 있습니다 occ. 일반적인 패키지 설치 명령어는 아래와 같습니다. PHP 바이너리와 Nextcloud 경로를 호스트 환경에 맞게 변경하십시오. Docker 또는 AIO 환경을 사용하는 경우, 해당 배포 환경에 맞는 컨테이너 명령어 또는 스케줄러 지침을 사용하십시오.

sudo -u www-data php /var/www/nextcloud/occ app:enable previewgenerator

3. Nextcloud의 백그라운드 작업을 Cron으로 설정합니다.

Nextcloud 관리 설정에서 백그라운드 작업 모드로 Cron을 선택 하고 일반 Nextcloud 시스템 cron이 실제로 실행 중인지 확인하십시오. 앱의 README 파일에 따르면 내장된 미리보기 백그라운드 작업에는 Cron 모드가 필요하며, Webcron 및 AJAX 모드는 해당 장시간 실행 작업에 지원되지 않습니다. 일반 cron에 문제가 있는 경우, 이 앱만 설치한다고 해서 작업 대기열이 계속 진행되지는 않습니다.

Nextcloud의 일반 cron.php 스케줄과 앱에서 선택적으로 사용할 수 있는 전용 preview:pre-generate스케줄을 혼동하지 마세요. 둘은 별개의 메커니즘입니다. 앱에 내장된 백그라운드 작업 또는 전용 시스템 cron 명령어를 사용할 수 있습니다. 전용 명령어를 선택하는 경우, 동일한 큐에 대해 두 가지 경로가 모두 실행되는 것을 방지하기 위해 내장된 미리 보기 백그라운드 작업을 비활성화하는 것이 좋습니다.

4. 첫 번째 대량 실행 전에 미리 보기 작업량을 줄이십시오.

CPU 사용량이 많은 미리보기 생성 작업의 경우, 동시에 실행되는 새 미리보기 수를 줄이세요. Nextcloud 35 구성 참조에서 preview_concurrency_new동시 새 미리보기 생성 수를 제어하는 ​​설정이 나와 있습니다. 기본값은 4이며, 설명서에서는 CPU 코어 수보다 크지 않도록 권장합니다. 소규모 호스트의 경우 2와 같은 값으로 테스트해 보고, 서버가 응답하지 않으면 1로 설정해 보세요. 이렇게 하면 동시 작업량이 제한되지만, 단일 대용량 이미지나 비디오는 여전히 상당한 CPU 자원을 소모할 수 있습니다.

미리보기 크기도 중요합니다. Nextcloud 35 문서의 기본 최대 너비와 높이는 4096픽셀입니다. 이 값을 낮추면 처리 preview_max_x및 메모리 사용량을 줄일 수 있지만 미리보기 크기가 작아질 수 있습니다. 설정 파일을 백업하고 기존 PHP 배열에 설정을 병합하세요. 파일을 코드 조각으로 덮어쓰지 마십시오. 예를 들어 관리자는 두 값을 모두 2048로 설정하고 파일 및 사진 보기에서 품질을 테스트할 수 있습니다.preview_max_yconfig/config.php

이 앱은 여러 가지 크기 변형을 생성할 수 있습니다. README 파일에는 일반적인 파일, 사진 및 활동 사용에 적합한 축소 크기 프로필이 제공됩니다. 정사각형 크기 64 256, 전체 너비-높이 크기 256 4096, 그리고 빈 크기를 선택할 수 widthSizes있으며 heightSizes, 이 경우 해당 변형 그룹을 건너뛰도록 설정할 수 있습니다. 이러한 설정은 사용자가 주로 사용하는 앱에 적합한 경우에만 사용하십시오. 추억 타임라인이나 다른 앱에는 추가 크기가 필요할 수 있습니다. 프로젝트에서는 미리 보기 크기가 허용된 크기 규칙을 준수해야 하며 구성된 최대값을 초과할 수 없다고 명시하고 있습니다. Nextcloud의 미리 보기 크기 및 품질 설정 과 릴리스별 구성 참조를 확인하십시오 .

5. 먼저 소량으로 기존 미리보기를 생성합니다.

앱을 활성화하고 제한 사항을 설정한 후에는 전체 인스턴스가 아닌 테스트 폴더 또는 특정 사용자를 대상으로 초기 생성기를 실행하세요. 이 앱은 사용자 ID 또는 경로별 필터링을 지원하며, 명령은 작업자 수를 지정할 수 있습니다. 첫 실행 시에는 작업자 수를 1개로 설정하여 안전하게 테스트하세요.

sudo -u www-data php /var/www/nextcloud/occ preview:generate-all --workers=1 --path="/alice/files/Photos"

alice`<path>`, `<Nextcloud 설치 경로>`, `<Nextcloud 설치 경로>`를 서버의 실제 값으로 바꾸 십시오. 경로 옵션은 `<Nextcloud 설치 경로>` 형식을 사용합니다 /[username]/files/[folder path]. 경로와 사용자 필터를 생략하면 명령이 전체 라이브러리를 탐색할 수 있습니다. 사용자 활동이 적은 시간에 배치 작업을 실행하고 CPU, 메모리 및 디스크 공간 사용량을 모니터링하며 서버가 불안정해지면 중지하고 다시 평가하십시오. 효과를 측정하기 전까지는 더 빨리 완료하기 위해 작업자 수를 늘리지 마십시오.

6. 새로 추가되거나 변경된 파일의 일정을 예약합니다.

테스트 배치 작업이 정상적으로 완료되면 preview:pre-generate시스템 cron 스케줄에 추가하세요. 앱의 README 파일에는 10분 간격 실행을 예시로 제시하고 있지만, 필수 사항은 아닙니다. 업로드 용량과 사용 가능한 유휴 시간을 고려하여 적절한 간격을 선택하세요. 예를 들어, 웹 서버 계정으로 관리되는 crontab 파일에는 설치 환경에 맞게 경로를 조정하여 다음과 같은 줄을 추가할 수 있습니다.

*/10 * * * * cd /var/www/nextcloud && /usr/bin/php -f occ preview:pre-generate

이 전용 시스템 cron을 사용하는 경우, 프로젝트에서 권장하는 대로 앱에 내장된 미리보기 백그라운드 작업을 비활성화하십시오. 문서화된 앱 설정은 다음과 같습니다.

sudo -u www-data php /var/www/nextcloud/occ config:app:set --value=true --type=boolean previewgenerator job_disabled

Nextcloud의 일반 cron.php 작업은 활성화된 상태로 유지하세요. 컨테이너 및 호스팅 플랫폼의 경우, 컨테이너 cron 항목에 호스트 경로를 입력하는 대신 해당 플랫폼에서 지원하는 스케줄러를 사용하십시오. 앱이 암호화된 상태로 설치된 경우, 여기서 작업을 중단하고 관리자 또는 호스팅 제공업체에 문의하십시오. 현재 프로젝트에서는 해당 구성을 지원하지 않는 것으로 명시하고 있습니다.

7. 대기열을 모니터링하고 개선 사항을 확인합니다.

실행하여 occ preview:queue-stats사전 생성 대기열과 오래된 미리보기를 확인하십시오. 예약된 실행 사이에 대기열이 줄어드는 것은 워커가 처리 속도를 따라잡고 있음을 나타냅니다. 대기열이 지속적으로 증가하는 경우 사용자가 구성된 작업 처리 속도보다 더 빠르게 파일을 추가하고 있는 것입니다. 추가 CPU 부하가 허용 가능한 수준인지 확인한 후 실행 빈도 또는 허용된 작업 제한을 신중하게 늘리십시오. 앱은 실행당 작업 실행 시간 및 미리보기에 대한 제한을 제공합니다. README 파일에 따르면 0은 무제한을 의미하므로 리소스가 제한된 호스트에서는 0을 임의로 선택하지 마십시오.

배포 전후의 비슷한 시간대에 CPU 사용량 최고치를 비교한 다음, 일반 사용자처럼 대표적인 사진 폴더와 문서 미리보기를 열어보세요. 썸네일이 제대로 표시되고, 페이지 로딩 속도가 정상이며, 예약된 일괄 처리 후 CPU 사용량이 안정되는지 확인합니다. 대기열 진행률이 적절하고 주간 CPU 사용량 프로필이 안정화되면 바람직한 결과입니다. 백로그가 지속적으로 증가하거나 사용자 세션 속도가 느려지는 경우, 일정, 크기 프로필 또는 기본 미리보기 제공업체를 다시 검토해야 합니다.

중요 제한 사항 및 안전한 정화

일부 미리보기 유형은 서버 측 프로그램에 의존합니다. Nextcloud 설명서에는 비디오 미리보기에는 FFmpeg, 오피스 문서 미리보기에는 LibreOffice가 필요하다고 명시되어 있습니다. 이러한 형식은 일반 이미지 썸네일과 다르게 동작할 수 있으며, 지원 여부는 서비스 제공업체의 구성에 따라 달라집니다. 서비스 제공업체를 변경하거나 서비스를 추가하기 전에 동시 접속 사용자 수를 줄이고 제한된 파일 세트로 테스트하는 것부터 시작하십시오.

미리보기 크기나 지원되는 파일 형식을 변경하고 캐시된 미리보기를 삭제해야 하는 경우, Nextcloud 31 이상 버전 occ preview:cleanup에서는 프로젝트 README에 설명된 대로 이를 위한 기능을 제공합니다. 생성된 모든 미리보기 파일이 삭제된 후, Nextcloud는 사용자가 파일에 접근할 때마다 필요에 따라 미리보기를 생성합니다. 이로 인해 CPU 사용량이 일시적으로 급증할 수 있습니다. 따라서 필요한 경우 백업을 생성하고, 정기적으로 정리 작업을 예약하며, 앱 데이터 미리보기 디렉토리를 수동으로 삭제하는 것을 피하는 것이 좋습니다. 미리보기 생성기 README에는 .nomedia특정 폴더 및 하위 폴더를 건너뛰는 방법에 대한 설명도 포함되어 있습니다.

실제로, 프리뷰 생성기는 느린 온디맨드 프리뷰로 인해 가시적인 부하 피크가 발생하고, 백그라운드 작업을 예약할 수 있으며, 캐시된 크기를 저장할 디스크 공간이 충분한 경우에 적합합니다. 적절한 동시 실행 제한, 실제 표시 요구 사항에 맞는 프리뷰 크기, 그리고 테스트 우선 대량 실행을 함께 사용하면 더욱 효과적입니다. 인스턴스가 암호화되었거나, 셸 스케줄링 없이 관리되거나, 프리뷰 요청과 무관한 이유로 CPU 사용량이 많은 경우에는 배포 전에 이러한 제약 조건을 검토해야 합니다.

공식 참고 자료

• Nextcloud 미리보기 생성기 README
• Nextcloud 앱 스토어: 미리보기 생성기 릴리스
• Nextcloud 관리 설명서: 구성 미리보기
• Nextcloud 관리 설명서: 구성 매개변수
• Nextcloud 관리 설명서: 서버 튜닝
• Nextcloud 관리 매뉴얼: OCC 미리보기 정리