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

ساختار قانون

قوانین در فهرست spec.routingRules منبع CDN قرار دارند.

گزینهفیلدقرارداد
نام قانونnameدر پنل الزامی، حداکثر ۶۴ کاراکتر و در همان CDN یکتا
وضعیتenabledفقط قوانین فعال در ارزیابی شرکت می‌کنند
شرط‌هاconstraintsآرایه دوبعدی؛ شرط‌های هر گروه با «و» و گروه‌ها با «یا» ترکیب می‌شوند
عملیاتactionsعملیات پشتیبانی‌شده setUpstream است؛ پنل برای هر قانون یک آپ‌استریم انتخاب می‌کند
آپ‌استریم مقصدactions[].setUpstream.upstreamNameنام یک آپ‌استریم موجود در spec.upstreams همان CDN؛ مقدار خالی یا نام ناموجود معتبر نیست

شرط‌های قابل استفاده

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

پارامترtypeمقدار مورد مقایسه
ربات شناخته‌شدهknown_botsشناخته‌شده بودن درخواست به‌عنوان ربات
TLStlsاستفاده از TLS
میزبانhostمیزبان درخواست
مسیرpathمسیر بدون Query String
URIuriمسیر همراه Query String
پارامتر Queryargsنام و مقدار پارامتر
کشورcountryکد کشور، مانند IR
آدرس IPipآدرس یا محدوده CIDR
ASNasnشماره ASN
کوکیcookieنام و مقدار کوکی
هدرheaderنام و مقدار هدر درخواست
متدmethodمتد درخواست، مانند GET

IP Set در قانون آپ‌استریم

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

ترتیب و تطبیق

وضعیتنتیجه
قانون غیرفعالدر ارزیابی شرکت نمی‌کند
هیچ قانون منطبق نیستآپ‌استریم پیش‌فرض قانون مسیر تغییر نمی‌کند
چند قانون منطبق هستندقوانین به ترتیب فهرست اعمال می‌شوند؛ آخرین عملیات setUpstream منطبق، مقصد را تعیین می‌کند
constraints: []هیچ گروهی برای تطبیق وجود ندارد؛ قانون منطبق نمی‌شود
constraints: [[]]گروه خالی برقرار محسوب می‌شود؛ قانون با همه درخواست‌ها منطبق است

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

نمونه ساختار یک قانون

این نمونه یک عضو از spec.routingRules است، نه بدنه کامل درخواست به‌روزرسانی CDN. آپ‌استریم foreign-origin باید در همان CDN تعریف شده باشد.

{
  "name": "outside-ir",
  "enabled": true,
  "constraints": [
    [
      {
        "type": "country",
        "negate": true,
        "country": { "operator": "equals", "expected": ["IR"] }
      }
    ]
  ],
  "actions": [
    {
      "type": "setUpstream",
      "setUpstream": { "upstreamName": "foreign-origin" }
    }
  ]
}

مستندات مرتبط