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

ریدایرکت در Nginx: HTTP به HTTPS، www و آدرس‌های قدیمی بدون حلقه

ریدایرکت‌های HTTP به HTTPS، www به non-www و آدرس‌های قدیمی را با return 301 و map در Nginx بنویسید و با curl بدون حلقه تست کنید.

ریدایرکت در Nginx: HTTP به HTTPS، www و آدرس‌های قدیمی بدون حلقه

ریدایرکت اشتباه یا حلقه‌ای، هم کاربر را قفل می‌کند و هم رتبهٔ سایت را آسیب می‌زند. در Nginx ساده‌ترین و ایمن‌ترین روش دستور return است، نه rewrite. این راهنما سه سناریوی رایج را با تست مرحله‌ای نشان می‌دهد.

۱. HTTP به HTTPS

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

$request_uri مسیر و پارامترها را نگه می‌دارد. یک بلوک جدا برای پورت ۸۰ ساده‌تر و خواناتر از شرط‌های if است.

۲. www به non-www

server {
    listen 443 ssl;
    server_name www.example.com;
    # ssl_certificate ...
    return 301 https://example.com$request_uri;
}

گواهی باید نام www را هم پوشش دهد، وگرنه کاربر قبل از ریدایرکت خطای گواهی می‌بیند. جهت را (با www یا بدون آن) یک بار انتخاب کنید و همه‌جا یکسان نگه دارید.

۳. آدرس‌های قدیمی با map

map $request_uri $new_uri {
    /old-page   /new-page;
    /blog/2019  /articles/2019;
}

server {
    if ($new_uri) { return 301 $new_uri; }
}

map را در بلوک http بگذارید. برای ده‌ها آدرس، فایل جدا و include مرتب‌تر است. return داخل if الگوی امن و رایج است.

۴. تست مرحله‌ای

sudo nginx -t && sudo systemctl reload nginx
curl -sI http://example.com/page?x=1 | grep -iE 'HTTP|location'

باید 301 و Location درست ببینید. مرورگرها 301 را کش می‌کنند، پس هنگام آزمایش اول 302 بگذارید و بعد به 301 تبدیل کنید. ترتیب بلوک‌ها را با ترتیب انطباق location کنترل کنید.

۵. حلقه‌ها

اگر پشت CDN یا پروکسی هستید و HTTPS در آنجا پایان می‌یابد، ریدایرکت به HTTPS در Nginx می‌تواند حلقه بسازد؛ در آن حالت از هدر X-Forwarded-Proto استفاده کنید. صفحهٔ خطای سفارشی را در صفحهٔ خطا و 503 ببینید.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید کاربر آدرس http://www.example.com/page?x=1 را باز می‌کند. با دو ریدایرکت پشت‌سرهم (اول HTTPS و بعد حذف www) به مقصد می‌رسد. بهتر است همین را با یک ریدایرکت مستقیم انجام دهید. این سناریو فقط برای توضیح است، نه اندازه‌گیری واقعی.

۷. اشتباه‌های رایج

  • استفاده از rewrite برای ریدایرکت‌های ساده.
  • حذف پارامترهای query با نوشتن مقصد بدون $request_uri.
  • گواهی بدون پوشش www.
  • انتخاب 301 هنگام آزمایش و گیرکردن در کش مرورگر.

۸. پرسش‌های متداول

301 یا 302؟ 301 دائمی است و کش می‌شود؛ 302 موقت است. هنگام تست 302 امن‌تر است.

زنجیرهٔ چند ریدایرکت مشکل دارد؟ کند می‌کند و بهتر است به یک پرش برسد.

if در Nginx بد است؟ return داخل if امن است؛ از دستورهای پیچیده در آن پرهیز کنید.

۹. چک‌لیست سریع

  1. بلوک جدا برای پورت ۸۰ نوشته شد.
  2. گزینهٔ www/non-www انتخاب و گواهی بررسی شد.
  3. $request_uri حفظ شد.
  4. با curl کد و Location تست شد.
  5. حلقه‌ای وجود ندارد.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

Nginx return directive · Nginx ngx_http_map_module · Google Search Central: redirects