인프라 튜닝: 413 Request Entity Too Large 해결 (256MB 확장)

🚀 256MB 초고속 데이터 고속도로 개통 가이드

10G 인프라 환경에서 대용량 부품 도면 및 고해상도 이미지를 원활하게 처리하기 위해, 외부 유입부터 최종 DB 저장 단계까지 모든 관문의 업로드 제한을 256MB로 상향 조정합니다.

🏗️ 전체 아키텍처 흐름

User → Synology Reverse Proxy (Gate 1) → nginx:alpine (Gate 2) → WordPress PHP (Gate 3)

🟦 Gate 1: 시놀로지 역방향 프록시 (최외곽)

외부 요청이 가장 먼저 통과하는 지점입니다. 여기서 막히면 뒤의 설정은 무의미합니다.

1. 경로: 제어판 > 로그인 포털 > 고급 > 역방향 프록시
2. 대상: qfd.systems 규칙 선택 후 편집
3. 설정: 사용자 정의 머리글 탭 → 생성 → 사용자 지정
   • 헤더 이름: client_max_body_size
   • 값: 256M

🟩 Gate 2: 최전방 nginx:alpine (교통 관제)

루트와 /blog를 분기하는 컨테이너 설정입니다.

1. 파일 경로: /etc/nginx/conf.d/default.conf (또는 nginx.conf)
2. 수정 내용: server 블록 내부에 설정 추가

server {
    listen 80;
    server_name qfd.systems;

    # MASTER의 256MB 대문 개방
    client_max_body_size 256M;

    location /blog {
        # 해당 위치에도 명시적으로 추가하여 우선순위 보장
        client_max_body_size 256M;
        proxy_pass http://[WP_IP]:[PORT];
        proxy_set_header Host $host;
    }
}

1. 적용: docker exec [컨테이너명] nginx -s reload

🟧 Gate 3: 워드프레스 PHP (최종 목적지)

파일이 실제로 저장되는 애플리케이션 단계입니다. PHP 설정이 낮으면 Nginx를 통과해도 여기서 거절됩니다.

1. 파일 경로: 워드프레스 루트 폴더의 .htaccess
2. 추가 내용: (파일 최하단에 삽입)

# PHP 업로드 용량 및 성능 최적화
php_value upload_max_filesize 256M
php_value post_max_size 256M
php_value memory_limit 512M
php_value max_execution_time 600
php_value max_input_time 600

📊 설정 요약 리포트

💡 MASTER's Note

이 설정은 단순한 용량 증설이 아니라, 10G 네트워크 대역폭을 온전히 활용하기 위한 인프라 최적화 작업입니다. 이제 413 에러 없이 대용량 부품 데이터를 자유롭게 핸들링할 수 있습니다.

"데이터가 흐르지 않으면 시스템은 죽은 것과 같습니다. 이제 막힘없이 쏘십시오!" 🚀🫡