خطاهای 502، 504 و 52x در CDN؛ تشخیص علت و رفع آن

کدهای 5xx به زبان ساده

کدهای 52x اصطلاحاً توسط برخی CDNها (مثل Cloudflare) تعریف شده‌اند؛ مفهوم مشابه در CDNهای دیگر ممکن است با 502 یا 504 نمایش داده شود.

معنای خطاهای رایج 5xx در CDN

502 / 521مبدأ در دسترس است اما سرویس پاسخ نمی‌دهد یا اتصال را رد می‌کند

522اتصال TCP به مبدأ اصلاً برقرار نمی‌شود

504 / 524اتصال برقرار شده ولی پاسخ دیرتر از مهلت رسیده

520مبدأ پاسخی نامعتبر یا خالی برگردانده

گام اول برای همهٔ خطاها: تست مستقیم مبدأ

# از خود سرور مبدأ
curl -sv http://127.0.0.1:PORT/ -o /dev/null

# از بیرون، مستقیم به آی‌پی مبدأ
curl -sv -H "Host: www.example.com" http://ORIGIN_IP:PORT/ -o /dev/null

• مبدأ مستقیم هم خطا می‌دهد → مشکل روی سرور شماست (ادامهٔ همین راهنما).
• مبدأ مستقیم سالم است ولی از CDN خطا → تنظیم آدرس/پورت مبدأ در CDN، فایروال یا محدودیت روی آی‌پی لبه‌ها را بررسی کنید (چک‌لیست بعد از اتصال CDN).

رفع 502 و 521: سرویس پاسخ نمی‌دهد

sudo systemctl status nginx          # یا apache2، یا سرویس اپلیکیشن
sudo ss -tlnp | grep -E ':80|:443|:3000'
sudo journalctl -u nginx --since "30 min ago"
sudo tail -n 50 /var/log/nginx/error.log

علت‌های رایج: - پروسهٔ پشت Nginx خاموش است (PHP-FPM، Node، Gunicorn): connect() failed (111: Connection refused) در error.log. - سوکت یا پورت اشتباه در proxy_pass یا fastcgi_pass. - کمبود رم و OOM Killer که پروسه را کشته است: dmesg -T | grep -i oom؛ راهنمای پر شدن رم سرور.

رفع 504 و 524: پاسخ دیر می‌رسد

• کوئری‌های کند دیتابیس: slow query log را فعال و ایندکس‌های لازم را اضافه کنید.
• کار طولانی در درخواست وب: کارهایی مثل ساخت گزارش بزرگ یا ارسال ایمیل انبوه را به صف پس‌زمینه منتقل کنید.
• تایم‌اوت‌های داخلی: proxy_read_timeout در Nginx یا request_terminate_timeout در PHP-FPM را بررسی کنید؛ اما افزایش بی‌حساب تایم‌اوت درمان نیست.
• منابع ناکافی: اگر load average بالا و steal زیاد است، پلن بزرگ‌تر یا بهینه‌سازی لازم است.

رفع 522: اتصال برقرار نمی‌شود

sudo ufw status verbose
sudo iptables -L -n | head -50

• پورت مبدأ در فایروال بسته است یا فقط برای آی‌پی‌های خاص باز است.
• آی‌پی مبدأ در تنظیمات CDN اشتباه است (مثلاً پس از ساخت سرور جدید، آی‌پی قبلی مانده).
• سرور خاموش یا به‌دلیل اتمام موجودی متوقف شده است.
• اختلال شبکه بین لبه و مبدأ؛ با mtr از سمت مبدأ بررسی کنید.

رفع 520: پاسخ غیرمنتظره

• پروسه در میانهٔ پاسخ کرش می‌کند؛ لاگ اپلیکیشن را ببینید.
• هدرهای پاسخ یا کوکی‌ها بیش از حد بزرگ‌اند.
• مبدأ اتصال را بدون پاسخ می‌بندد (مثلاً به‌دلیل محدودیت keep-alive یا ماژول امنیتی).

503: سرویس موقتاً در دسترس نیست

• حالت تعمیرات CMS فعال مانده است.
• محدودکنندهٔ نرخ (rate limit) روی مبدأ، درخواست‌های لبه را محدود کرده؛ چون همهٔ کاربران از چند آی‌پی لبه می‌آیند، محدودیت بر اساس آی‌پی باید روی هدر آی‌پی واقعی کاربر اعمال شود.
• سرور زیر بار سنگین است.

پیشگیری

سؤالات متداول