Nextcloud 웹 서버의 PHP 메모리 경고를 해결하는 방법

Nextcloud 관리자 개요에서 PHP 메모리 제한이 512MB 미만으로 표시되는 경우, 임의로 값을 높여도 php.ini경고가 사라지지 않을 수 있습니다. Nextcloud는 웹 인터페이스를 제공하는 PHP 환경을 확인하는 반면, 명령줄 PHP는 다른 구성을 로드할 수 있기 때문입니다. memory_limit활성화된 웹 PHP 서비스에 대해 값을 설정하고 해당 서비스를 재시작한 다음, Nextcloud 관리자 개요에서 값을 다시 확인하십시오.

2026년 10월 10일 기준으로 확인한 Nextcloud 35 관리 설명서에 따르면 PHP의 메모리 제한은 최소 512MB로 설정해야 합니다. 이는 스크립트별 최대 메모리 사용량이며, 모든 PHP 프로세스가 해당 용량을 사용한다는 보장은 아닙니다. 이 제한을 높이면 메모리 집약적인 요청이 더 빨리 완료될 수 있지만, 물리적인 RAM 용량이 추가되는 것은 아닙니다. 소규모 서버에서는 너무 많은 PHP 워커 프로세스가 동시에 실행될 경우 시스템 메모리가 부족해질 수 있습니다.

먼저 Nextcloud가 PHP를 실행하는 방식을 파악하십시오.

설정을 편집하기 전에 웹 스택과 PHP 버전을 확인하십시오. Nextcloud 관리자 개요에서 PHP 버전이 표시되면 기록해 두세요. 셸에서는 php --ini명령줄 PHP 바이너리가 사용하는 구성 파일이 표시되지만, PHP-FPM 또는 Apache가 브라우저 요청에 어떤 파일을 사용하는지는 알 수 없습니다.

php --version
php --ini

일반적인 Debian 또는 Ubuntu 설정에서 PHP-FPM은 종종 `/php-fpm-php`를 읽고 /etc/php/<version>/fpm/php.ini, Apache의 mod_php는 종종 `/php-fpm-php`를 읽습니다 /etc/php/<version>/apache2/php.ini. CLI 설정은 일반적으로 `/php-fpm-php`에 있습니다 . `/php-fpm-php`를 설치된 PHP 버전(예: `php-fpm-php`)으로 /etc/php/<version>/cli/php.ini바꾸십시오 . 다른 운영 체제 및 제어판은 다른 경로를 사용할 수 있습니다.<version>8.3

Nextcloud 설명서에는 AIO, Snap, NCP 또는 커뮤니티 Docker와 같은 턴키 배포 방식이 사전 구성된 PHP 환경을 제공한다고 명시되어 있습니다. 이러한 설치의 경우 호스트 수준 설정이 적용된다고 가정하기보다는 배포 방식에서 지원하는 구성 방법을 사용하십시오 php.ini.

웹 PHP 메모리 제한을 512MB 이상으로 설정하십시오.

Nginx 또는 Apache를 사용한 PHP-FPM

활성 FPM 구성을 백업한 다음 해당 구성을 편집합니다 php.ini. Debian 또는 Ubuntu에서는 다음과 같은 명령어를 사용할 수 있습니다. 서버에 맞게 버전과 경로를 수정하십시오.

sudo cp /etc/php/8.3/fpm/php.ini /etc/php/8.3/fpm/php.ini.backup
sudo nano /etc/php/8.3/fpm/php.ini

기존 memory_limit지시문을 찾아 최소 512MB로 설정하십시오.

memory_limit = 512M

여러 개의 충돌하는 복사본을 추가하는 대신 기존 지시문을 편집하십시오. PHP-FPM 풀 구성에서 설정된 경우 php_admin_value[memory_limit]해당 풀 수준 설정이 우선 적용될 수 있습니다. 경고가 계속 표시되면 활성 풀 파일을 검토하십시오.

새로운 웹 요청이 업데이트된 설정을 사용하도록 해당 PHP-FPM 서비스를 다시 시작하십시오. 예를 들어 서비스 이름은 다음과 같을 수 있습니다 php8.3-fpm.

sudo systemctl restart php8.3-fpm

Apache에서 PHP-FPM을 사용하는 경우, 웹 서버 구성이 변경된 경우에만 PHP-FPM을 재시작하고 Apache를 다시 로드하거나 재시작하십시오. 사용 중인 배포판의 올바른 서비스 이름을 사용하십시오.

mod_php가 포함된 Apache

Apache가 PHP를 모듈로 로드하는 경우, 일반적으로 /etc/php/8.3/apache2/php.iniDebian 또는 Ubuntu에서 Apache SAPI의 구성 파일을 편집해야 합니다. 설정을 memory_limit = 512M변경하고 파일을 저장한 다음, 운영 체제에 맞는 서비스 이름을 사용하여 Apache를 다시 시작하십시오.

sudo systemctl restart apache2

현재 웹 서버에서 mod_php를 사용하는 경우 FPM 파일을 편집하지 마십시오. 또는 그 반대의 경우도 마찬가지입니다. 관리자 개요 경고에는 웹 서버에서 로드하는 PHP 구성이 중요한 영향을 미칩니다.

Nextcloud 공식 Docker 이미지

Nextcloud 공식 Docker 이미지에는 PHP_MEMORY_LIMIT기본값이 인 환경 변수가 문서화되어 있습니다 512M. Compose 파일이나 다른 컨테이너 배포 구성에서 이 변수를 설정한 다음, 해당 배포 방법을 통해 컨테이너를 다시 생성하거나 업데이트하십시오. 실행 중인 컨테이너 내부에서 수동으로 편집한 내용은 교체 시 손실될 수 있습니다. 다른 이미지 및 오케스트레이션 플랫폼은 다른 설정을 사용할 수 있으므로 실제로 실행하는 이미지에 대한 문서를 참조하십시오.

변경 사항이 웹 인터페이스에 반영되었는지 확인하십시오.

관리자 계정으로 로그인한 후 관리 설정 > 개요를 다시 엽니다 . 메모리 경고가 사라졌는지, PHP 제한이 512MB 이상으로 표시되는지 확인합니다. 서비스를 재시작한 후 페이지를 새로 고칩니다. 이전에 로드한 페이지는 여전히 이전 상태를 표시할 수 있습니다.

만약 여전히 더 낮은 수치가 표시된다면, 다음의 가능한 원인을 순서대로 확인하십시오.

• 잘못된 SAPI: CLI 파일이 변경되었지만 PHP-FPM 또는 Apache가 다른 구성을 사용하고 있습니다.
• PHP 버전이 잘못되었습니다. 현재 실행 중인 웹 서비스의 PHP 버전이 사용자가 수정한 버전과 다릅니다 php.ini.
• 재정의: FPM 풀, 호스팅 제어판 또는 로컬 PHP 구성이 전역 설정을 재정의합니다.
• 서비스가 재시작되지 않았습니다. 기존 PHP 워커가 이전 구성을 계속 사용하고 있습니다.
• 컨테이너 구성: 수정된 호스트 파일이 컨테이너에 마운트되지 않았거나 환경 변수 변경 후 컨테이너가 다시 생성되지 않았습니다.

CLI 출력은 php --inicron 및 OCC 작업에 유용하지만 웹 값을 자체적으로 검증할 수는 없습니다. phpinfo()서버에 공개 페이지를 남겨두지 말고, 보호된 Nextcloud 관리자 개요 또는 호스트의 보안 진단 도구를 사용하십시오.

더 높은 한도가 충분하지 않을 때

Nextcloud에서 권장하는 512MB는 최소 구성 용량일 뿐, 일반적인 용량 산정 공식은 아닙니다. 대규모 미리보기, 가져오기 또는 앱별 작업에는 더 많은 용량이 필요할 수 있지만, 용량 제한을 크게 늘리면 각 PHP 프로세스가 더 많은 RAM을 소비하게 됩니다. 호스트에서 스왑이 발생하거나 운영 체제가 PHP 워커 프로세스를 종료하는 경우, 프로세스별 용량 제한을 계속 높이는 대신 PHP-FPM 동시 실행 수를 줄이거나 메모리 용량을 추가해야 합니다. 더 높은 값을 선택하기 전에 일반적인 최대 사용량 시 실제 RAM 사용량을 확인하십시오.

경고 메시지가 사라졌는데도 원래 작업이 여전히 실패하는 경우, Nextcloud 로그와 웹 서버 또는 PHP-FPM 로그에서 더 구체적인 PHP 오류를 찾아보세요. 메모리 제한 경고는 PHP의 프로세스별 메모리 할당 한도와 관련된 것이며, 업로드 제한, 시간 초과, 디스크 용량 부족 또는 애플리케이션 오류와 같은 관련 없는 문제는 진단하지 않습니다.

공식 참조

• Nextcloud 35: PHP 준비 및 PHP ini 설정 구성
• Nextcloud 35: 시스템 메모리 요구 사항
• PHP 매뉴얼: memory_limit 지시문
• Nextcloud 공식 Docker 이미지: PHP 구성