[Guide] 워드프레스 멀티사이트 업로드 용량 256MB 확장 가이드

워드프레스(특히 Docker 기반 멀티사이트) 환경에서 업로드 용량이 1MB 또는 2MB로 제한되는 문제를 해결하기 위한 '풀 스택' 설정 가이드입니다. 서버 엔진부터 애플리케이션 설정까지 5단계로 구성됩니다.

1. PHP 설정 (PHP-FPM 환경)

Docker 환경에서 PHP 설정을 덮어쓰는 가장 깔끔한 방법입니다.

• 파일명: .user.ini
• 위치: /var/www/html/ (워드프레스 루트 디렉토리)

upload_max_filesize = 256M
post_max_size = 256M
memory_limit = 512M
max_execution_time = 600

보안 팁: .htaccess 파일 최상단에 아래 코드를 추가하여 외부에서 .user.ini에 접근하지 못하도록 차단하세요.
```apache
<Files ".user.ini">
Require all denied
</Files>
```

2. 워드프레스 런타임 강제 할당 (wp-config.php)

서버 설정이 무시될 때, 워드프레스 실행 시점에 PHP 설정을 강제로 주입하는 방식입니다.

• 파일명: wp-config.php
• 위치: <?php 바로 아래 최상단에 삽입

@ini_set( 'upload_max_size' , '256M' );
@ini_set( 'post_max_size', '256M' );
@ini_set( 'memory_limit', '512M' );
@ini_set( 'max_execution_time', '300' );

3. 웹 서버 레벨 설정 (.htaccess)

Apache 서버가 요청을 처리할 때 적용되는 설정입니다.

• 파일명: .htaccess
• 주의: # BEGIN WordPress와 # END WordPress 블록 바깥에 작성하세요.

# --- PHP Upload Limits Start ---
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
# --- PHP Upload Limits End ---

4. 멀티사이트 네트워크 설정 (핵심 해결책)

서버 설정이 완벽해도 멀티사이트 환경에서는 네트워크 관리자 설정이 모든 것을 우선합니다.

1. 내 사이트 > 네트워크 관리자 > 설정으로 이동.
2. 최대 업로드 파일 크기 (Max upload file size) 항목 확인.
3. 값을 `262144` (KB 단위, 256MB)로 수정 후 저장.

5. Nginx 역방향 프록시 설정 (필수)

Nginx는 기본적으로 1MB 이상의 요청을 차단합니다. 전방에 Nginx나 시놀로지 역방향 프록시를 쓴다면 반드시 추가해야 합니다.

• 설정 항목: http 또는 server 블록 내부

client_max_body_size 256M;

✅ 최종 결과 확인

모든 설정 후 컨테이너를 재시작(docker restart)하고, 미디어 > 새로 추가 메뉴에서 최대 업로드 파일 크기: 256 MB 문구를 확인하세요.

docker restart [wordpress_container_name]

작성자: MASTER & Gemini
날짜: 2026-04-10