بازنویسی مسیر (Rewrite) مسیر URL را فقط هنگام ارسال درخواست به آپ‌استریم تغییر می‌دهد. نشانی که کاربر در مرورگر می‌بیند ثابت می‌ماند؛ اما مسیری که Edge برای دریافت محتوا از آپ‌استریم استفاده می‌کند می‌تواند متفاوت باشد.

بازنویسی روی یک قانون مسیر تعریف می‌شود، نه روی کل دامنه. قانون مسیر مشخص می‌کند کدام درخواست‌ها با این قانون مطابقت داشته باشند و بازنویسی مشخص می‌کند پس از این تطبیق، چه مسیری به آپ‌استریم ارسال شود.

flowchart LR

  client(["کلاینت"])

  edge(["Edge CDN"])

  match(["تطبیق قانون مسیر"])

  rewrite(["بازنویسی مسیر"])

  upstream(["آپ‌استریم"])

  client -->|"/api/v2/users"| edge

  edge --> match

  match --> rewrite

  rewrite -->|"/users"| upstream

تفاوت مسیر عمومی و مسیر آپ‌استریم

مسیر عمومی بخشی از قرارداد سایت با کاربر است و مسیر آپ‌استریم مسیری است که Edge برای دریافت محتوا استفاده می‌کند. این دو لزوما یکسان نیستند.

برای مثال، API می‌تواند در URL عمومی از مسیر /api/v2/* استفاده کند، در حالی که همان درخواست‌ها در آپ‌استریم از مسیر /users یا /orders دریافت شوند. همچنین ممکن است فایل‌های یک سرویس ذخیره‌سازی در مسیری مانند /bucket/public/ قرار داشته باشند، اما URL عمومی آن‌ها زیر /assets/ باشد.

بازنویسی این دو ساختار را از یکدیگر جدا می‌کند: کاربر URL عمومی را می‌بیند و Edge مسیر متفاوتی را برای دریافت محتوا به آپ‌استریم ارسال می‌کند.

بازنویسی محتوای پاسخ را تغییر نمی‌دهد و جایگزین آپ‌استریم نیست. محتوا همچنان از آپ‌استریم دریافت می‌شود؛ فقط مسیر درخواست برای دریافت آن تغییر می‌کند.


بازنویسی در برابر ریدایرکت

این دو مکانیزم رفتار متفاوتی دارند.

بازنویسی در برابر ریدایرکت

در بازنویسی مسیر (Rewrite)، مسیر هنگام ارسال درخواست به آپ‌استریم تغییر می‌کند و URL مرورگر ثابت می‌ماند. در ریدایرکت (Redirect)، CDN پاسخ 301 یا 302 به کلاینت ارسال می‌کند و مرورگر به URL جدید می‌رود. در پنل، ریدایرکت از طریق عملیات Redirect در مرجع دیواره آتش (Firewall) قابل پیکربندی است.

بازنویسی مسیرریدایرکت
URL در مرورگرهمان URL اولیهURL جدید
پاسخ به کلاینتپاسخ محتوای درخواست301 یا 302 به همراه Location
محل پیکربندیقانون مسیرعملیات Redirect در فایروال
کاربردنگاشت URL عمومی به مسیر متفاوت در آپ‌استریمانتقال کاربر به URL جدید

اگر می‌خواهیم URL عمومی برای کاربر ثابت بماند، از بازنویسی استفاده می‌کنیم. اگر می‌خواهیم مرورگر به URL دیگری برود، از ریدایرکت استفاده می‌کنیم.

بازنویسی مسیر به‌خودی‌خود هدرهای HTTP را تغییر نمی‌دهد. تغییر هدرهای درخواست یا پاسخ تنظیم جداگانه‌ای است که می‌تواند روی همان قانون مسیر پیکربندی شود.


پیشوند مسیر و مسیر مقصد

بازنویسی روی پیشوند مسیر کار می‌کند، نه روی کل URL.

  • پیشوند مسیر: بخشی از ابتدای مسیر درخواست که باید جایگزین شود؛ برای مثال، در /api/v2/users، مقدار /api/v2/ می‌تواند پیشوند باشد.
  • مسیر مقصد: مسیری که جایگزین پیشوند می‌شود و درخواست با آن به آپ‌استریم ارسال می‌شود.

برای مثال، اگر پیشوند مسیر /api/v2/ و مسیر مقصد / باشد، درخواست:

https://cdn.example.com/api/v2/users

برای کاربر با همان URL باقی می‌ماند، اما مسیر ارسال‌شده به آپ‌استریم به شکل زیر خواهد بود:

/users

بخش باقی‌مانده مسیر، یعنی users، حفظ می‌شود. اسلش انتهای پیشوند مهم است: جایگزینی /api/v2 با / می‌تواند مسیر //users بسازد. Query String نیز بخشی جدا از مسیر است و بازنویسی مسیر آن را تغییر نمی‌دهد.

مسیر قانون (Path) با پیشوند بازنویسی یکی نیست. Path مشخص می‌کند قانون روی کدام درخواست‌ها اعمال شود؛ برای مثال:

/api/v2/*

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

بنابراین ابتدا قانون مسیر با درخواست مطابقت داده می‌شود و سپس بازنویسی مسیر روی درخواست اعمال می‌شود.

ترتیب قوانین مسیر نیز همچنان تعیین‌کننده است. اگر قانون /* بالاتر از /api/v2/* قرار گرفته باشد، درخواست /api/v2/users ممکن است با قانون عمومی مطابقت پیدا کند و به قانون شامل بازنویسی نرسد.


مرز بازنویسی با کش

بازنویسی مسیر و کش دو مرحله متفاوت از پردازش درخواست هستند.

درخواست ابتدا با قانون مسیر مطابقت داده می‌شود و در صورت فعال بودن بازنویسی، مسیر مورد استفاده برای درخواست به آپ‌استریم تغییر می‌کند. کش نیز بر اساس تنظیمات خود تصمیم می‌گیرد پاسخ را از کش ارایه کند یا از آپ‌استریم دریافت کند.

بنابراین نباید مسیر عمومی و مسیر ارسالی به آپ‌استریم را در مستندات یا عیب‌یابی یکسان فرض کنیم. برای مثال، ممکن است کاربر /api/v2/users را درخواست کند، در حالی که درخواست به آپ‌استریم با مسیر /users ارسال شود.

برای جزییات نحوه ایجاد و استفاده از کلید کش، کش در CDN ستون را مطالعه می‌کنیم.


ادامه مسیر