Nextcloud '413 Entity Too Large' 오류 해결하기

Nextcloud에서 '413 Entity Too Large' 오류가 발생할 때가 있습니다. 이 오류는 대용량 파일을 업로드할 때 주로 나타나며, Nginx 서버의 설정 문제로 인해 발생하는 경우가 대부분입니다. 오늘은 이 오류의 원인과 간단한 해결책을 알아보겠습니다.

문제 원인: Nginx 파일 크기 제한

'413 Entity Too Large' 오류는 Nginx 서버가 클라이언트 요청 본문(request body)의 크기가 설정된 제한을 초과했을 때 발생합니다. Nginx는 서비스 안정성을 위해 기본적으로 요청 크기를 제한하는데, Nextcloud처럼 대용량 파일 업로드가 필요한 서비스에서는 이 제한이 문제가 됩니다.

특히 Nginx를 리버스 프록시로 사용하고 있다면, 파일 업로드 요청이 Nextcloud 앱에 도달하기 전에 Nginx에서 먼저 거부되는 것입니다.

해결책: Nginx 설정 수정

이 문제는 Nginx 설정 파일에 client_max_body_size 지시어를 추가하여 파일 업로드 크기 제한을 늘리면 간단히 해결됩니다.

Nginx 설정 파일 열기: Nextcloud에 대한 Nginx 설정 파일(예: nextcloud.hamsm.cc.conf)을 엽니다.

client_max_body_size 추가: 아래 예시처럼 server 블록 내부에 원하는 크기를 설정합니다. 10GB까지 업로드를 허용하고 싶다면 10G로 설정하면 됩니다.

server {
    server_name nextcloud.hamsm.cc;
    
    # 파일 업로드 크기 제한을 10GB로 설정
    client_max_body_size 10G; 

    location / {
        proxy_pass http://localhost:8088;
        # ... 기타 설정 ...
    }

    # ... ssl 설정 ...
}

Nginx 재시작: 설정을 수정한 후에는 Nginx 서비스를 재시작하거나 재로드해야 변경 사항이 적용됩니다.
```
sudo systemctl restart nginx 
# 또는
sudo systemctl reload nginx
```

추가 확인 사항

Nginx 설정만으로는 부족할 수 있습니다. Nextcloud는 PHP를 기반으로 작동하므로, PHP 설정도 함께 확인하는 것이 좋습니다.

PHP 설정 (php.ini): php.ini 파일에서 **upload_max_filesize**와 post_max_size 값을 Nginx 설정 값보다 크거나 같게 조정하세요.
```
upload_max_filesize = 10G
post_max_size = 10G
```
Nextcloud 설정: Nextcloud 자체의 설정도 확인하세요. config/config.php 파일에 특정 파일 크기 제한 설정이 있는지 확인하고, 필요하다면 값을 수정하세요.

세 가지 설정(Nginx, PHP, Nextcloud) 모두에서 파일 크기 제한을 늘려야 원활한 대용량 파일 업로드가 가능합니다.