همه مقالات تخصصی

رفع خطای 413 در Nginx؛ تنظیم محدودیت آپلود

راهنمای رفع خطای 413 در Nginx با تنظیم client_max_body_size، هماهنگ‌سازی محدودیت‌های PHP و وردپرس، تست پیکربندی و کنترل امنیت آپلود و نکات عملی.

رفع خطای 413 در Nginx؛ تنظیم محدودیت آپلود

خطای 413 Request Entity Too Large یعنی یکی از لایه‌های مسیر درخواست، اندازه Body را بیشتر از حد مجاز تشخیص داده است. راه‌حل پایدار فقط افزایش یک عدد نیست؛ باید محدودیت Nginx، PHP، وردپرس و هر Proxy جلوی سرور با هم هماهنگ باشند.

منبع خطا را قبل از افزایش Limit پیدا کنید

413 ممکن است در CDN، Load Balancer، Nginx، Apache یا خود برنامه تولید شود. هدر پاسخ و Error Log را بررسی کنید. اگر درخواست به PHP نرسیده باشد، تغییر upload_max_filesize اثری ندارد.

curl -I https://example.com/upload
sudo tail -f /var/log/nginx/error.log
sudo nginx -T | grep -n client_max_body_size

محدودیت Nginx را در Scope درست تنظیم کنید

client_max_body_size را می‌توان در http، server یا location گذاشت. کوچک‌ترین Scope ممکن را انتخاب کنید تا همه Endpointها بی‌دلیل فایل بزرگ نپذیرند.

location /wp-admin/async-upload.php {
    client_max_body_size 64m;
    include fastcgi_params;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}

محدودیت PHP را هماهنگ کنید

post_max_size باید از upload_max_filesize بزرگ‌تر باشد و حافظه کافی برای پردازش وجود داشته باشد. فایل php.ini فعال برای FPM را پیدا کنید؛ تنظیم CLI ممکن است متفاوت باشد.

php --ini
php -i | grep -E "upload_max_filesize|post_max_size|memory_limit"
# php.ini
upload_max_filesize = 64M
post_max_size = 72M

پیکربندی را اعتبارسنجی و Reload کنید

قبل از Reload از Syntax Test استفاده کنید. سپس یک فایل کمی کوچک‌تر و کمی بزرگ‌تر از Limit آزمایش کنید تا رفتار مرزی مشخص شود.

sudo nginx -t
sudo systemctl reload nginx
sudo systemctl reload php8.3-fpm

امنیت و ظرفیت را فراموش نکنید

افزایش Limit بدون کنترل MIME، پسوند، فضای دیسک و زمان پردازش خطرناک است. برای فایل‌های بسیار بزرگ از Object Storage، Upload چندبخشی یا URL امضاشده استفاده کنید.

چک‌لیست رفع 413

  • محل تولید پاسخ 413 را از روی Header و Log مشخص کنید.
  • client_max_body_size را در Scope محدود تنظیم کنید.
  • upload_max_filesize و post_max_size را هماهنگ کنید.
  • فضای موقت و دیسک را بررسی کنید.
  • فایل زیر و بالای Limit را تست کنید.

سؤال‌های رایج

چرا تغییر php.ini مشکل را حل نکرد؟

زیرا Nginx ممکن است قبل از رسیدن درخواست به PHP آن را رد کند یا فایل php.ini دیگری برای FPM فعال باشد.

آیا client_max_body_size را صفر کنم؟

صفر محدودیت را غیرفعال می‌کند و معمولاً برای سایت عمومی توصیه نمی‌شود. حد مشخص و متناسب با کاربرد امن‌تر است.

چرا آپلود بزرگ باعث 504 می‌شود؟

پس از عبور از محدودیت اندازه، پردازش طولانی یا کندی Storage می‌تواند Timeout جداگانه ایجاد کند.

راهنماهای مرتبط

منابع و مستندات رسمی

آخرین بررسی منابع: ۳۰ سپتامبر ۲۰۲۶