Nextcloud 업로드 용량 제한(2GB) 해결 방법: 대용량 파일 업로드 허용

Nextcloud 업로드가 2GB에서 멈추는 경우는 대개 Nextcloud 전체 설정이 아니라 요청 경로의 특정 단계에서 제한이 발생하기 때문입니다. 더 큰 파일을 업로드할 수 있도록 하려면 업로드를 처리하는 모든 단계(PHP, 웹 서버, 리버스 프록시 또는 호스팅 패널)에서 파일 크기보다 큰 목표 용량을 설정하십시오. 그런 다음 저장 공간, 임시 공간 및 요청 시간 제한이 전송을 지원할 수 있는지 확인하십시오.

이 가이드에서는 최대 약 4GB 크기의 파일을 기준으로 5GB를 목표 용량으로 설정하는 예시를 제시합니다. 실제 사용 사례에 맞는 용량 제한을 선택하고, 필요한 경우 요청 오버헤드를 고려하여 여유 공간을 확보하며, 전체 시스템에서 동일한 설정을 유지하십시오. 예시는 PHP를 사용하는 자체 관리형 Nextcloud 서버를 기준으로 작성되었으며, 관리형 호스팅, 컨테이너 및 어플라이언스 환경에서는 구성 경로가 다를 수 있습니다.

2GB 업로드가 실패하는 이유는 무엇일까요?

Nextcloud의 최신 관리 설명서에 따르면 대용량 파일 업로드는 PHP 및 웹 서버 구성에 따라 제한될 수 있습니다. 청크 업로드의 경우 브라우저 또는 클라이언트가 파일을 여러 조각으로 나누어 전송하면 Nextcloud가 이를 조합합니다. 이 경우 일부 PHP 파일 크기 설정은 이러한 요청에 적용되지 않을 수 있지만, 웹 서버 또는 PHP 시간 초과는 여전히 영향을 미칠 수 있습니다. 프록시, 방화벽, 스토리지 백엔드, 사용자 할당량 또는 임시 디스크 용량 부족 또한 제한 요소가 될 수 있습니다. 자세한 내용은 Nextcloud 대용량 파일 업로드 관리 가이드 및 Nextcloud 대용량 파일 업로드 사용자 가이드를 참조하십시오 .

"2GB"는 2,000,000,000바이트 또는 2GiB(2,147,483,648바이트)를 의미할 수도 있습니다. 표시되는 제한과 실제 바이트 임계값이 정확히 일치하지 않을 수 있습니다. 오류, 파일 크기(바이트 단위), 그리고 오류가 즉시 발생하는지 또는 진행이 시작된 후에 발생하는지 기록하십시오. 이러한 세부 정보는 어떤 부분을 검사해야 하는지 파악하는 데 도움이 됩니다.

1. 업로드를 거부하는 첫 번째 레이어를 식별하십시오.

설정을 변경하기 전에 파일 업로드 방식을 확인하세요. Nextcloud 웹 인터페이스, 데스크톱 또는 모바일 동기화 클라이언트, 또는 WebDAV 애플리케이션 중 어떤 방식을 사용했는지 확인하십시오. 기존 임계값보다 약간 큰 파일을 업로드하여 테스트해 보세요. 단, 문제 해결 중에는 수 기가바이트에 달하는 파일을 반복적으로 업로드하지 마십시오. 오류 발생 시 Nextcloud 관리자 개요 및 로그, 웹 서버 오류 로그, PHP-FPM 또는 Apache 로그, 그리고 프록시 또는 호스팅 대시보드를 확인하십시오.

• HTTP 413 응답이 즉시 발생하는 경우는 웹 서버 또는 프록시의 요청 본문 용량 제한을 나타내는 경우가 많습니다.
• PHP에서 파일 크기가 허용된 크기를 초과했다는 경고는 일반적인 멀티파트 요청에 대한 PHP 업로드 설정과 관련이 있습니다.
• 전송이 시작되었지만 중단되거나 시간 초과되는 경우 요청 시간 초과, 연결 끊김 또는 리소스 부족을 나타낼 수 있습니다.
• 명확한 할당량 메시지가 표시되면 서버 업로드 용량 제한이 아니라 사용자가 사용할 수 있는 Nextcloud 저장 공간이 부족한 것이 문제임을 의미합니다.

이는 단서일 뿐 확정적인 진단은 아닙니다. 프록시가 애플리케이션 오류를 대체할 수 있으며, 로그는 배포 환경에 따라 다릅니다. 구성을 수정하기 전에 계층별 타임스탬프를 비교하십시오.

2. 브라우저 폼 업로드에 대한 PHP 제한 설정

웹에서 실행되는 Nextcloud 프로세스에서 사용하는 PHP 설정을 찾으세요. Debian 또는 Ubuntu에서는 일반적으로 PHP-FPM 파일이 `/etc/php.php` 경로에 있습니다 . /etc/php/<version>/fpm/php.inimod_php를 사용하는 Apache는 보통 별도의 `/etc/php.php` 파일을 사용합니다 apache2/php.ini. PHP 명령줄 설정은 다를 수 있으므로, `php.php` 명령으로 찾은 파일만 수정하면 php --ini웹사이트가 변경되지 않을 수 있습니다. Nextcloud의 PHP 설정 가이드에서는 서버 측 설정에 대해 자세히 설명합니다.

5GB 용량 제한을 설정하려면 활성 웹 PHP 구성에서 다음 설정을 검토하십시오.

upload_max_filesize = 5G
post_max_size = 5G
max_input_time = 3600
max_execution_time = 3600

post_max_size최소한 의 크기 이상이어야 합니다 upload_max_filesize. 두 값을 동일하게 설정하는 것이 단일 파일 멀티파트 업로드의 실용적인 시작점입니다. 위의 시간 값은 예시일 뿐이며 전송 완료를 보장하는 것은 아닙니다. 사용 가능한 대역폭과 운영 정책에 맞는 시간을 선택하십시오. 파일 크기 memory_limit가 5GB라는 이유만으로 PHP의 값을 5GB로 늘리지 마십시오. PHP 문서에는 업로드 입력 수신에 소요되는 시간과 업로드 동작이 관련 지시문에 따라 달라진다는 내용이 포함되어 있습니다. PHP 업로드 관련 문제점 문서를max_input_time 참조하십시오 .

3. 웹 서버 요청 제한을 높이세요

PHP-FPM을 사용하는 Nginx

Nextcloud에 사용되는 활성 Nginx 서버 블록에서 허용하려는 가장 큰 파일 크기보다 큰 요청 본문 제한(request-body cap)을 설정하세요. 예를 들어 5GB로 설정하려면 다음과 같이 하면 됩니다.

client_max_body_size 5G;

적절한 컨텍스트에 배치하고 , http더 구체적인 블록에서 더 낮은 값과 충돌하지 않도록 하십시오. Nginx는 핵심 모듈 참조 에서 이 지시문을 설명합니다 . Nextcloud의 Nginx 설치 예제에는 업로드 크기 및 시간 초과 설정도 포함되어 있습니다. Nginx를 다시 로드하기 전에 구성을 검증하십시오 .serverlocationsudo nginx -t

아파치

활성화된 가상 호스트, 디렉터리 구성 또는 포함된 구성 세트가 올바른지 확인하십시오 LimitRequestBody. Apache 버전에서 기본값 또는 명시적 제한이 목표값보다 낮은 경우, 필요한 바이트 수로 제한값을 높이거나, 배포 환경에 적합한 경우에만 Apache 수준의 제한을 두지 않도록 설정하십시오. 지시문이 Apache 버전 및 구성에서 허용하는 컨텍스트에 배치되었는지 확인하십시오. Apache는 LimitRequestBody 문서0 에서 해당 동작에 대해 설명합니다 . 서비스를 다시 로드하기 전에 실행하십시오.apachectl configtest

4. 리버스 프록시, 컨테이너 및 스토리지를 점검하십시오.

트래픽이 다른 Nginx 인스턴스, 로드 밸런서, 호스팅 제어판 또는 보안 프록시를 통과하는 경우, 해당 인스턴스의 본문 크기 및 시간 초과 제한도 업로드를 허용해야 합니다. 요청이 Nextcloud에 도달하기 전에 거부될 수 있습니다. 해당 설정을 담당하는 레이어만 업데이트한 다음 로그와 응답 코드를 확인하십시오. Docker 또는 다른 컨테이너 배포의 경우, 실행 중인 컨테이너에 마운트된 구성 또는 해당 이미지에 대해 지원되는 환경 설정을 변경하십시오. 호스트 PHP 파일이 컨테이너에서 전혀 사용되지 않을 수도 있습니다.

대용량 파일 업로드는 리소스를 많이 소모합니다. Nextcloud 데이터 볼륨에 충분한 여유 공간이 있는지, PHP 또는 웹 서버의 임시 디렉터리가 작업 부하를 처리할 수 있는지 확인하십시오. 청크 업로드의 경우, 청크가 조립되는 동안 임시 공간이 필요할 수 있으며, 객체 스토리지 배포 환경에서는 추가 임시 디스크 공간이 필요할 수 있습니다. 최대 크기 파일 하나만 고려하지 말고 여러 파일을 동시에 업로드할 수 있도록 계획하십시오. 사용량이 많은 환경에서 업로드 제한을 늘리기 전에 Nextcloud의 임시 공간 및 대용량 파일 업로드 관련 섹션을 검토하십시오.

5. 변경 사항을 적용하고 통제된 테스트를 통해 검증합니다.

구성 검사가 완료되면 관련 PHP-FPM 및 웹 서버 서비스를 다시 로드하거나 재시작하여 업데이트된 설정을 적용하십시오. 정확한 서비스 이름은 배포판 및 PHP 버전에 따라 다릅니다. 관련 없는 운영 서비스를 재시작하지 마십시오. 그런 다음 이전에 실패했던 것과 동일한 클라이언트와 경로를 사용하여 이전 2GB 제한보다 약간 큰 파일(예: 약 2.1GB 크기의 알려진 테스트 파일)을 업로드하십시오. 테스트 파일 크기가 새 제한을 넘지 않도록 유지하고 디스크 여유 공간, 로그 및 전송 진행 상황을 모니터링하십시오.

테스트가 성공적으로 완료되면 HTTP 크기 오류나 시간 초과가 발생하지 않고, 지정된 Nextcloud 폴더에 저장되며, 클라이언트에서 확인했을 때 파일 크기가 정상적이어야 합니다. 중요한 파일의 경우, 워크플로에서 지원하는 경우 원본과 대상 위치에서 체크섬을 비교하십시오. 진행률 표시줄이 100%에 도달했다고 해서 저장된 파일이 완전히 완료되었다고 볼 수는 없습니다.

이 해결책이 충분하지 않을 때

• 웹 업로드는 성공하지만 데스크톱 클라이언트에서는 실패합니다. 클라이언트, 프록시 및 서버 시간 초과 동작을 검사해 보세요. Nextcloud 클라이언트는 청크 단위 업로드를 사용하므로 PHP 설정 upload_max_filesize만 변경해서는 청크 요청 또는 최종 어셈블리 시간 초과 문제가 해결되지 않을 수 있습니다.
• 오류 메시지는 사용자의 저장 공간이 부족하다는 것을 나타냅니다. 해당 사용자의 Nextcloud 할당량 또는 사용 가능한 저장 공간을 조정하십시오. 요청 제한을 늘려도 용량이 확보되지는 않습니다.
• 모든 클라이언트에서 동일한 바이트 수에서 오류가 발생합니다. 공유 프록시, WAF, 호스팅 제공업체 또는 웹 서버의 제한 사항을 찾아 해당 로그와 요청을 연관시켜 분석해 보세요.
• 업로드가 완료되었지만 임시 디스크 공간을 너무 많이 사용하고 있습니다. 동시 업로드 횟수를 줄이거나, 충분한 임시 저장 공간을 확보하거나, 백엔드의 청킹 및 저장 동작에 대한 문서를 검토하십시오.

업로드 제한을 높이면 사용자가 서버로 전송할 수 있는 용량이 늘어나므로, 할당량 설정, 모니터링, 충분한 저장 공간 및 적절한 접근 제어와 함께 사용해야 합니다. 안전한 최대 용량이라는 보편적인 기준은 없으며, 실제적인 한계는 요청 경로에서 가장 느린 처리 ​​속도와 서버 및 저장 시스템의 용량에 따라 달라집니다.

참고 자료

• Nextcloud 서버 관리 설명서: 대용량 파일 업로드
• Nextcloud 서버 관리 설명서: PHP 구성
• NGINX 문서: client_max_body_size
• Apache HTTP 서버 문서: LimitRequestBody
• PHP 매뉴얼: 일반적인 업로드 오류