سرویس عکس (Pixel) روی لبه CDN، تصویر را بعد از دریافت از آپ‌استریم و قبل از تحویل به کلاینت تغییر می‌دهد. تغییر اندازه، برش، چرخش، مات‌کردن، خاکستری‌کردن، واترمارک، تبدیل فرمت و بهینه‌سازی در همین نقطه رخ می‌دهد؛ نه روی دیسک آپ‌استریم و نه در مرورگر.

این سرویس جایگزین میزبانی تصویر نیست. فایل اصلی همچنان از آپ‌استریم می‌آید. لبه یک نسخه‌ تولیدشده می‌سازد و همان را تحویل می‌دهد. بدون روشن بودن سرویس روی قانون مسیر منطبق، پارامتر x-img در URL اثری ندارد و همان فایل اصلی برمی‌گردد.

flowchart LR
  client(["کلاینت"])
  edge(["لبه CDN"])
  cache(["کش خروجی"])
  origin(["آپ‌استریم"])
  pixel(["اعمال فیلتر"])
  client --> edge
  edge --> cache
  cache -->|"HIT"| client
  cache -->|"MISS"| origin
  origin --> pixel
  pixel -->|"fill"| cache
  pixel --> client

چرا در لبه پردازش می‌شود؟

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

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

فیلتر از کجا می‌آید؟

رشته‌ی فیلتر نسخه‌ی v1 است و از چپ به راست اجرا می‌شود. فیلترها با / از هم جدا می‌شوند؛ پارامترهای یک فیلتر با , و نام و مقدار با _. شرح نحو و فهرست فیلترها در مرجع سرویس عکس (Pixel) است.

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

محلرفتار
Query x-imgرشته از URL خوانده می‌شود؛ هر درخواست می‌تواند فیلتر متفاوتی بخواهد
Forced Filter روی قانون مسیرهمان نحو v1/... در تنظیم قانون؛ مقدار x-img نادیده گرفته می‌شود

x-img برای آزمایش و برای حالتی مناسب است که خود اپلیکیشن URL نسخه‌ تولیدشده را می‌سازد. Forced Filter وقتی معنا دارد که همه‌ی درخواست‌های آن مسیر باید یک پردازش ثابت بگیرند و کلاینت نباید فیلتر را عوض کند.

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

نسخه‌ی مستندشده در پنل و در x-img برابر v1 است. مدل Preset (نسخه‌ی دوم) از پنل در دسترس نیست.

کش خروجی تغییر‌یافته

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

URL بدون x-img و URL با فیلتر دو کلید جدا هستند، به‌شرط آن‌که Query String در کلید کش باشد. در این حالت bird.jpg همان فایل اصلی می‌ماند و bird.jpg?x-img=v1/resize,w_100 نسخه‌ تولیدشده کش‌شده است. اگر Query String از کلید کش حذف شود، فیلترهای مختلف به یک کلید می‌خورند و خروجی نادرست سرو می‌شود.

باز بودن x-img یعنی هر کلاینت می‌تواند رشته‌ی فیلتر را عوض کند. ترکیب‌های سنگین روی تصاویر بزرگ، هزینه و بار لبه را بالا می‌برد (EDoS). Forced Filter این سطح را می‌بندد، چون رشته از URL خوانده نمی‌شود.

فرمت خروجی

بدون فیلتر format و بدون optimize، فرمت تا حد زیادی از ورودی و از هدر Accept کلاینت می‌آید: WebP ورودی اگر کلاینت WebP بپذیرد WebP می‌ماند؛ وگرنه PNG. PNG و JPEG ورودی همان فرمت می‌مانند.

format فرمت را صریح می‌کند. optimize متادیتا را حذف می‌کند، کیفیت را تنظیم می‌کند، و اگر کلاینت WebP بپذیرد به WebP می‌رود. چند فیلتر فرمت در یک رشته، آخرین فیلتر را معیار می‌گیرند و تغییر فرمت بعد از بقیه‌ی فیلترها اعمال می‌شود.

ادامه مسیر