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

قانون مسیر مشخص می‌کند هر درخواست به کدام برش سایت تعلق دارد، به کدام آپ‌استریم پیش‌فرض برود، و در لبه چه رفتاری اعمال شود. ساخت آپ‌استریم به‌تنهایی ترافیک نمی‌فرستد؛ بدون دست‌کم یک قانون — معمولا /* — لبه پاسخ 404 می‌دهد.

در پنل این صفحه قوانین مسیر (لوکیشن) است. فرم با برای کدام مسیر می‌خواهید قوانین خاصی تنظیم کنید؟ شروع می‌شود و بعد چه تنظیماتی بر روی مسیر بالا انجام شود؟ کارت‌های اختیاری را باز می‌کند.


تطبیق

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

ترتیب تطبیق

اگر /* بالاتر از /api/* باشد، قانون API هرگز اجرا نمی‌شود. قانون خاص باید بالاتر از قانون فراگیر باشد.

تطبیق روی مسیر URL است، نه Query String. Query String جداست و فقط اگر در تنظیمات کش فعال باشد روی نسخه کش اثر می‌گذارد. جزییات را در مرجع کش مطالعه می‌کنیم.

گزینهمقدارتوضیح
مسیر مورد نظر (Path)اجباری؛ با / شروع شودالگوی Glob برای مسیر درخواست. راهنمای فرم: «برای اشاره به همه مسیرها از علامت * استفاده کنید.»
هاست (Host)اختیاری؛ حداکثر ۲۵۳ کاراکترمحدود کردن قانون به hostname. اگر خالی باشد همه زیردامنه‌ها در نظر گرفته می‌شوند

نمونه Path:

الگومنطبق می‌شود
/*همه مسیرها
/api/*هر چیزی زیر /api/
/pictures/*.{png,jpg}مسیرهایی که با /pictures/ شروع می‌شوند و به png یا jpg ختم می‌شوند

* هر رشته‌ای را می‌گیرد. {a,b} یکی از مقدارها را. ? یک کاراکتر.

هاست:

مقداررفتار
خالیهمه hostnameهای همین وب‌سایت
example.comفقط همان دامنه، بدون زیردامنه
*.example.comزیردامنه‌ها؛ خود example.com نه
الگوی Glob دیگرمطابق همان الگو

راهنمای فرم: «اگر فیلد هاست را خالی بگذارید، همه زیردامنه‌ها در نظر گرفته می‌شوند. با وارد کردن خود دامنه (مثلا example.com)، فقط همان دامنه بدون زیردامنه‌ها تطبیق داده می‌شود. از الگوهای glob نیز پشتیبانی می‌کنیم.»

بدون قانون منطبق، پاسخ 404 است. فیلد location در لاگ درخواست همان Path قانون منطبق است. توضیح این فیلد را در مرجع فیلدهای لاگ درخواست مطالعه می‌کنیم.


آپ‌استریم

گزینهمقدارتوضیح
آپ‌استریماجباری؛ نام یک آپ‌استریم موجودپاسخ‌دهنده پیش‌فرض این قانون. راهنمای فرم: «تعیین یک آپ‌استریم به‌عنوان پاسخ‌دهنده این قانون مسیر»

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

این آپ‌استریم پیش‌فرض قانون مسیر است. قانون آپ‌استریم می‌تواند روی همان Path، آپ‌استریم را بر اساس ویژگی‌های درخواست عوض کند؛ مثلا کشور یا ربات. اگر چند قانون آپ‌استریم منطبق شوند، آخرین غالب است — برعکس قانون مسیر که اولی می‌برد. تفاوت در قوانین مسیر است.

برای ترافیک خارج معمولا قانون مسیر دوم نمی‌سازیم. ترافیک از قانون مسیر موجود می‌آید و قانون آپ‌استریم گروه را عوض می‌کند. دو قانون مسیر روی یک الگو تداخل مسیریابی می‌آورد.


تنظیمات اختیاری

کارت‌ها فقط وقتی دیده می‌شوند که در چه تنظیماتی بر روی مسیر بالا انجام شود؟ انتخاب شده باشند. برداشتن تیک، همان بخش را به حالت پیش‌فرض برمی‌گرداند.

گزینه در فرمنقشمرجع جزییات
تنظیمات Cacheذخیره‌سازی موقت پاسخ در لبهمرجع کش
هدر آپ‌استریمهدر روی درخواست به آپ‌استریممرجع هدرهای HTTP اختصاصی ستون
بازنویسی مسیرعوض کردن مسیر ارسالی به آپ‌استریم، بدون عوض کردن URL مرورگربازنویسی مسیر (Rewrite)
ویرایش تصویرتغییر اندازه، فرمت یا کیفیت تصویر؛ هزینه جدامرجع سرویس عکس (Pixel)
تنظیمات CORSدسترسی مرورگر از دامنه دیگرمرجع CORS
تنظیمات لینک امنالزام توکن برای همین مسیرمرجع لینک امن (Secure Link)
هدر داون‌استریمهدر روی پاسخ به کاربرمرجع هدرهای HTTP اختصاصی ستون
تنظیمات پروتکلپروکسی HTTP یا gRPCهمین صفحه

فایروال روی این فرم نیست. شرط و عملیات فایروال در مرجع دیواره آتش (Firewall) است.

با دکمه ابر یک قانون /* در انتهای فهرست ساخته می‌شود. لبه همچنان اولین منطبق را اجرا می‌کند؛ قانون دستی بالاتر می‌تواند آن را بپوشاند.


کش

کش در قانون مسیر جدید، چه دستی و چه ساخته‌شده با QuickCDN، به‌صورت پیش‌فرض غیرفعال (Bypass) است. پس از فعال‌سازی، ذخیره شدن هر پاسخ به سیاست کش و قابل‌کش بودن همان پاسخ بستگی دارد.

گزینه در کارترفتار خلاصه
کش فعال استپاسخ قابل‌کش در لبه ذخیره می‌شود. خاموش یعنی هر بار از آپ‌استریم
در نظر گرفتن Query Stringهر ترکیب پارامتر نسخه کش جدا می‌سازد
استفاده از هدر Cache-Control یا مدیریت دستی کشمنبع TTL
حالت immutableمرورگر تا پایان Browser TTL اعتبارسنجی نمی‌کند؛ فقط در مدیریت دستی
داده‌ها روی سرور CDN کش نمی‌شوند و فقط در مرورگر کاربر ذخیره می‌شوندلبه ذخیره نمی‌کند
داده‌ها بر اساس نوع “دستگاه” کاربر کش شوندنسخه جدا برای موبایل، تبلت، کامپیوتر
داده‌ها بر اساس “کشور” کاربر کش شوندنسخه جدا برای کشور GeoIP
عدم ارایه محتوای منقضی‌شده هنگام به‌روزرسانی کشهنگام تازه‌سازی، نسخه کهنه سرو نمی‌شود

TTLها، انواع محتوای قابل ذخیره، و محدودیت‌ها در مرجع کش است. مراحل پنل در پیکربندی کش محتوا.


هدر آپ‌استریم و داون‌استریم

دو جهت جداست.

بخش فرمجهت
سفارشی‌سازی هدر ارسالی به آپ استریمروی درخواست، پیش از آپ‌استریم
سفارشی‌سازی هدر ارسالی به کاربر (Downstream)روی پاسخ، پیش از کلاینت

در هر جهت دو فهرست است:

فهرسترفتار
هدر با نام و مقدارافزودن یا بازنویسی
هدرهای مسدود‌شدهحذف همان هدر از ارسال. راهنمای فرم: «هدرهایی را که نمی‌خواهید ارسال شوند، به این لیست اضافه کنید.»

Host از این بخش عوض نمی‌شود؛ در فرم آپ‌استریم است. هدرهای اختصاصی ستون به‌صورت پیش‌فرض می‌روند و برای رسیدن به آپ‌استریم لازم نیست دوباره اضافه شوند. Connection و CDN-Loop از قانون مسیر حذف یا بازنویسی نمی‌شوند.

فهرست هدرهای ستون و محدودیت حذف در مرجع هدرهای HTTP اختصاصی ستون است. مراحل در سفارشی‌سازی هدرهای HTTP.


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

URL مرورگر ثابت می‌ماند. مسیری که لبه به آپ‌استریم می‌فرستد عوض می‌شود. محتوا عوض نمی‌شود.

گزینهتوضیح
پیشوند مسیر مبداابتدای مسیر که جایگزین می‌شود. راهنما: «مسیرهایی که با این پیشوند شروع می‌شوند، بازنویسی خواهند شد. مثال: /api/ فقط ابتدای مسیر بررسی می‌شود، نه کل مسیر.»
مسیر مقصداجباری وقتی این کارت انتخاب شده. جایگزینی همان پیشوند

Path قانون با پیشوند بازنویسی یکی نیست. اول قانون منطبق می‌شود، بعد پیشوند روی مسیر اعمال می‌شود. Query String عوض نمی‌شود.

ریدایرکت کار مرورگر است و در فایروال تنظیم می‌شود، نه در این کارت. تفاوت در بازنویسی مسیر (Rewrite) است. مراحل در بازنویسی مسیر درخواست قبل از آپ‌استریم.


ویرایش تصویر

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

هزینه جدا

استفاده از این قابلیت هزینه مجزا دارد. فهرست قیمت را از واحد فروش می‌گیریم.

گزینهرفتار
فیلتر با QueryStringرشته x-img در URL تصویر را عوض می‌کند
فیلتر ثابتهمان نحو v1/... در فیلد commands؛ x-img نادیده گرفته می‌شود

فیلتر ثابت درخواست‌های GET یا HEAD منطبق با این قانون را به پردازش تصویر می‌فرستد. اگر پاسخ تصویر نباشد، پردازش انجام نمی‌شود و ممکن است پاسخ اصلی بدون تغییر برگردد. این حالت را فقط روی مسیری می‌گذاریم که خروجی‌اش تصویر است.

سرویس عکس با کش بدون در نظر گرفتن Query String سازگار نیست. متن فرم: «برای استفاده از سرویس عکس، باید نوع کش را به «کش شدن داده‌ها با Query String» تغییر دهید.»

نحو فیلترها در مرجع سرویس عکس (Pixel) است. اولین سناریو در اولین تصویر را با سرویس عکس تغییر دهید.


CORS

لبه برای درخواست منطبق، هدر CORS را به پاسخ می‌گذارد و در صورت نیاز Preflight را همان‌جا جواب می‌دهد.

گزینهتوضیح
تنظیمات CORSروشن یا خاموش برای همین قانون
Allow Credentialاجازه Cookie و هدر احراز هویت در درخواست Cross-Origin
Origin های مجازهر Origin در یک خط؛ الگوهای Glob مجاز است
هدرهای مجازهر نام در یک خط
هدرهای Exposedهر نام در یک خط
Max ageثانیه؛ نگهداری نتیجه Preflight در مرورگر
متدهای مجازGET، PUT، PATCH، POST، DELETE

OPTIONS در فهرست متد نیست؛ برای Preflight استفاده می‌شود. با Allow Credential از * برای Origin استفاده نمی‌کنیم.

جزییات در مرجع CORS. مفهوم در CORS. مراحل در فعال‌سازی CORS روی قانون مسیر.


لینک امن

گزینهمقدارتوضیح
فعال کردن لینک امن برای این مسیرفعال / غیرفعالبررسی توکن و زمان انقضا برای درخواست‌های همین قانون

تا این کلید روی قانون روشن نباشد، Secret لینک امن به‌تنهایی مسیر را محدود نمی‌کند. فعال کردن روی /* همه درخواست‌های آن قانون را به توکن وابسته می‌کند؛ معمولا فقط روی مسیر محافظت‌شده مثل /videos/* روشن می‌شود.

Secret، نام پارامتر و فرمول توکن در مرجع لینک امن (Secure Link) است. مراحل در فعال‌سازی لینک امن (Secure Link) برای مسیر.


پروتکل

پیش‌فرض، حتی بدون انتخاب این کارت، HTTP است (proxy_http). قانون مسیر فقط HTTP و gRPC را پشتیبانی می‌کند.

گزینهمعنی
HTTPپروکسی HTTP؛ کش و بقیه کارت‌ها قابل استفاده‌اند. WebSocket زیرمجموعه همین پروتکل است و بدون گزینه جدا پشتیبانی می‌شود
gRPCپروکسی gRPC

gRPC و کش

با انتخاب پروتکل gRPC، قابلیت تنظیمات Cache قابل استفاده نخواهد بود.

این پروتکل ارتباط لبه با آپ‌استریم روی همین قانون است و با پروتکل کاربر تا CDN یکی نیست.

اگر اتصال لبه تا آپ‌استریم HTTPS باشد، فقط پورت 443 قابل استفاده است. طرح و پورت سرور در مرجع آپ‌استریم است.


حذف

حذف وقتی ممکن است که بخواهیم آن برش دیگر ترافیک نگیرد. متن تایید فرم: «با حذف این قانون مسیر، ترافیک‌هایی که قبلا به آن ارسال میشد دیگر ارسال نمیشود و احتمال از دسترس خارج شدن سرویس شما وجود دارد.»

اگر هیچ قانون دیگری همان درخواست را نگیرد، پاسخ 404 است. آپ‌استریمی که قانون مسیر به آن اشاره کند حذف نمی‌شود؛ اول باید ارجاع قانون برداشته شود.


ادامه مسیر