سرویس فعال — قانون آماده، بدون نوشتن کد

توابع لبه: ریدایرکت، بازنویسی و هدر بدون کد

ریدایرکت‌های ۳۰۱ و ۳۰۲، بازنویسی مسیر و افزودن هدر پاسخ را برای هر دامنه از پنل تعریف کنید؛ قوانین روی لبهٔ داخل ایران و پیش از رسیدن درخواست به سرور شما اجرا می‌شوند. بدون تغییر کد سایت، بدون نصب و بدون هزینهٔ جداگانه.

نمونهٔ قوانین یک دامنه
  • ریدایرکت ۳۰۱ /old/* → /new
  • بازنویسی /v1/* → /api/v1
  • هدر پاسخ /staging/* X-Robots-Tag: noindex

اجرا روی لبهٔ داخل ایران، پیش از رسیدن درخواست به سرور شما.

معرفی

توابع لبه: قوانین مسیریابی روی لبه

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

این قوانین به شکل امن و از پیش تعریف‌شده پیاده شده‌اند و هیچ کد دلخواهی روی لبه اجرا نمی‌شود؛ ورودی‌ها پیش از ذخیره بررسی و تنظیمات پیش از اعمال اعتبارسنجی می‌شوند. برای هر دامنه تا ۵۰ قانون می‌سازید.

ریدایرکت، بازنویسی، هدر
۳ نوع قانون
بدون نوشتن کد
برای هر دامنه
۵۰ قانون
مسیر با پشتیبانی *
تا اعمال
چند ثانیه
با اعتبارسنجی
همراه CDN
بدون هزینهٔ جدا
از پنل

قابلیت‌ها

با قوانین لبه چه کاری انجام می‌دهید؟

تغییرات مسیریابی بدون انتشار نسخهٔ جدید اپلیکیشن.

ریدایرکت ۳۰۱ و ۳۰۲

آدرس‌های قدیمی را پس از تغییر ساختار سایت به آدرس جدید ببرید و اعتبار سئو را حفظ کنید.

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

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

هدر پاسخ

هدری مثل X-Robots-Tag یا Cache-Control را فقط روی یک مسیر مشخص بگذارید.

سازگاری API قدیمی

مسیر نسخهٔ قدیمی API را به ساختار جدید وصل کنید، بدون انتشار دوبارهٔ اپ.

امن و اعتبارسنجی‌شده

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

پاسخ در لبه

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

قیمت

هزینهٔ توابع لبه

قوانین لبه اشتراک جداگانه ندارند؛ فقط مصرف CDN بیش از سهمیهٔ رایگان ماهانه محاسبه می‌شود.

قوانین لبه

رایگان

تا ۵۰ قانون برای هر دامنه

درخواست‌ها

۱ میلیارد رایگان در ماه

سپس ۱۰۶ تومان هر ۱۰٬۰۰۰ درخواست، مبدأ داخل ایران (خارج از ایران: ۱۵۸ تومان)

ترافیک خروجی

رایگان

ترافیک ورودی: ۱۰ گیگابایت رایگان، سپس ۱٬۶۵۰ تومان هر گیگابایت

جدول کامل نرخ‌ها در قیمت‌گذاری آمده است.

قوانین را در تنظیمات CDN هر دامنه، در کارت «قوانین لبه»، بسازید؛ دامنه باید در DNS پنل باشد و پروکسی لبه روی آن روشن باشد.

ثبت‌نام و تعریف قانون

حساب دارید؟ وارد شوید تا مستقیم به تنظیمات CDN بروید.

۵ گام تا شروع

مراحل فعال‌سازی

  1. گام ۱: روشن‌کردن CDN برای دامنه

    در بخش DNS پنل، پروکسی لبه را برای رکورد موردنظر روشن کنید.

  2. گام ۲: باز کردن تنظیمات CDN

    در بخش CDN، تنظیمات همان دامنه را باز کنید و به کارت «قوانین لبه» بروید.

  3. گام ۳: انتخاب نوع قانون

    ریدایرکت، بازنویسی یا هدر پاسخ را انتخاب کنید.

  4. گام ۴: تعیین مسیر و مقصد

    مسیر را مثل /old/* وارد کنید و مقصد، نام و مقدار هدر یا کد ریدایرکت را تعیین کنید.

  5. گام ۵: ذخیره و تست

    قانون را ذخیره کنید و چند ثانیه بعد با curl -I نتیجه را بررسی کنید.

راهنمای کامل

راهنمای کامل توابع لبه (قوانین لبه) در ایران‌کلاد

توابع لبهٔ ایران‌کلاد به شما اجازه می‌دهند رفتار یک دامنه را بدون دست زدن به کد سایت تغییر دهید: آدرس‌های قدیمی را ریدایرکت کنید، مسیرها را پیش از رسیدن به سرور بازنویسی کنید و به پاسخ‌ها هدر اضافه کنید. این راهنما توضیح می‌دهد این قوانین دقیقاً چه هستند، چه چیزی نیستند، چطور آن‌ها را بنویسید و در چه سناریوهایی بیشترین فایده را دارند. این قابلیت روی Edge Proxy ساخته شده است.

۱۱ بخش حدود ۶ دقیقه مطالعه

فهرست مطالب

توابع لبه چیست و چرا به شکل قانون پیاده شده است؟

در بسیاری از CDN‌ها «تابع لبه» یعنی کدی که مشتری می‌نویسد و روی سرورهای لبه اجرا می‌شود. اجرای کد دلخواه روی لبه‌ای که بین مشتریان مشترک است، هم ریسک امنیتی دارد و هم پایداری را به کد هر مشتری وابسته می‌کند. ایران‌کلاد به‌جای آن، پرکاربردترین کارهایی را که مشتریان با توابع لبه انجام می‌دهند به شکل قوانین آماده و امن ارائه کرده است.

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

این قوانین برای مدیران سایت، تیم‌های سئو و توسعه‌دهندگانی مناسب است که می‌خواهند تغییرات کوچک مسیریابی را بدون انتشار نسخهٔ جدید اپلیکیشن انجام دهند.

سه نوع قانون و کاربرد هر کدام

هر قانون یک مسیر دارد که با / شروع می‌شود و می‌تواند ستاره داشته باشد، مثل /old/*. جدول زیر رفتار هر نوع را نشان می‌دهد:

نوع قانونچه می‌کندورودی‌هامثال
ریدایرکتمرورگر را به آدرس دیگری می‌فرستدمسیر، مقصد، کد ۳۰۱/۳۰۲/۳۰۷/۳۰۸/shop به https://shop.example.com
بازنویسیمسیر ارسالی به سرور را عوض می‌کند؛ آدرس کاربر ثابت می‌ماندمسیر، مسیر مقصد/v1/* به /api/v1
هدر پاسخیک هدر به پاسخ آن مسیر اضافه یا جایگزین می‌کندمسیر، نام هدر، مقدارX-Robots-Tag: noindex روی /staging/*

مقصد ریدایرکت می‌تواند آدرس کامل با http یا https یا یک مسیر داخلی همان دامنه باشد؛ مقصد بازنویسی همیشه یک مسیر است.

بازگشت به فهرست مطالب

ریدایرکت‌های سئو بدون تغییر کد

رایج‌ترین کاربرد قوانین لبه، حفظ رتبهٔ سایت هنگام تغییر ساختار آدرس‌هاست. وقتی صفحه‌ای جابه‌جا می‌شود، ریدایرکت ۳۰۱ به موتور جست‌وجو می‌گوید آدرس جدید جایگزین دائمی قدیمی است. با قوانین لبه این ریدایرکت پیش از رسیدن درخواست به سرور پاسخ داده می‌شود و سرور شما حتی درگیر آن نمی‌شود.

برای مهاجرت از یک CMS به CMS دیگر، فهرست آدرس‌های پربازدید قدیمی را تهیه کنید و برای هر کدام یک قانون ۳۰۱ به آدرس جدید بسازید؛ با سقف ۵۰ قانون برای هر دامنه، مهم‌ترین صفحه‌ها را پوشش دهید و بقیه را در خود اپلیکیشن مدیریت کنید. برای بررسی زنجیرهٔ ریدایرکت پس از اعمال، از ابزار بررسی هدرهای HTTP استفاده کنید.

اگر کل دامنه عوض شده است، روی دامنهٔ قدیمی یک قانون با مسیر /* و مقصد صفحهٔ اصلی دامنهٔ جدید کافی است؛ اما چون مقصد ثابت است، صفحه‌های داخلی به صفحهٔ متناظر نمی‌روند.

بازگشت به فهرست مطالب

بازنویسی مسیر برای سازگاری با نسخه‌های قدیمی

بازنویسی وقتی مفید است که آدرس عمومی باید ثابت بماند اما ساختار داخلی سرور عوض شده است. مثلاً اپ موبایل نسخهٔ قدیمی هنوز مسیر /v1/products را صدا می‌زند ولی بک‌اند جدید آن را در /api/v1/products پاسخ می‌دهد. یک قانون بازنویسی این اختلاف را در لبه برطرف می‌کند تا نیازی به انتشار نسخهٔ جدید اپ نباشد.

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

بازگشت به فهرست مطالب

افزودن هدر پاسخ برای مسیرهای مشخص

قانون هدر روی پاسخ‌های یک مسیر، یک هدر با مقدار ثابت می‌گذارد. چند کاربرد عملی: X-Robots-Tag با مقدار noindex برای محیط آزمایشی تا در نتایج جست‌وجو نیاید، Cache-Control طولانی برای پوشهٔ فایل‌های نسخه‌دار، یا Content-Disposition برای اجباری کردن دانلود فایل‌های یک پوشه.

برای هدرهای امنیتی عمومی مثل HSTS‏، nosniff و X-Frame-Options نیازی به قانون جدا نیست؛ این‌ها در تنظیمات CDN هر دامنه کلید آماده دارند و روی همهٔ مسیرها اعمال می‌شوند. قانون هدر را برای موارد خاص مسیرمحور نگه دارید.

بازگشت به فهرست مطالب

قواعد نوشتن مسیر و مقدار

برای امنیت لبه، ورودی‌ها قیدهای مشخصی دارند. اگر قانونی ذخیره نشد، معمولاً یکی از این موارد علت است:

  • مسیر باید با / شروع شود و حداکثر ۲۵۵ کاراکتر باشد
  • در مسیر فقط حروف لاتین، عدد، /، خط تیره، نقطه، زیرخط و * مجاز است
  • مقصد ریدایرکت یک آدرس http یا https کامل یا مسیری که با / شروع می‌شود
  • مقصد و مقدار هدر حداکثر ۱۰۲۴ کاراکتر و بدون فاصله، گیومه یا آکولاد
  • نام هدر فقط حروف لاتین، عدد و خط تیره، حداکثر ۱۲۸ کاراکتر
  • کد ریدایرکت یکی از ۳۰۱، ۳۰۲، ۳۰۷ یا ۳۰۸
  • حداکثر ۵۰ قانون برای هر دامنه یا زیردامنه
  • حروف فارسی و کاراکتر % در مسیر مجاز نیست، پس آدرس‌های فارسی را نمی‌توان مستقیم هدف قانون قرار داد

بازگشت به فهرست مطالب

قانون لبه، تنظیم وب‌سرور یا کد اپلیکیشن؟

همان ریدایرکت را می‌توان در سه جا ساخت. هر کدام برای وضعیت متفاوتی مناسب است:

موضوعقانون لبهتنظیم وب‌سرورکد اپلیکیشن
نیاز به دسترسی سرورندارد، از پنلدارددارد و نیاز به انتشار
بار روی سرور اصلیصفر برای ریدایرکتکمبیشتر
منطق شرطی و پویانداردمحدودکامل
تعداد زیاد قانونتا ۵۰ برای هر دامنهبدون محدودیت عملیبدون محدودیت عملی

بازگشت به فهرست مطالب

چند سناریوی واقعی برای قوانین لبه

این‌ها موقعیت‌هایی است که قوانین لبه در آن‌ها سریع‌ترین راه حل است و نیاز به هماهنگی با تیم توسعه یا دسترسی به سرور را حذف می‌کند:

  • تغییر نام دسته‌بندی فروشگاه: ریدایرکت ۳۰۱ از /category/old به آدرس دستهٔ جدید تا لینک‌های قدیمی شبکه‌های اجتماعی خراب نشوند
  • لینک کوتاه کمپین: مسیر /off با ریدایرکت ۳۰۲ به صفحهٔ تخفیف، و حذف قانون پس از پایان کمپین
  • انتقال وبلاگ به زیردامنه: مسیر /blog روی دامنهٔ اصلی به https://blog.example.com
  • محیط آزمایشی پنهان از جست‌وجو: هدر X-Robots-Tag: noindex روی /* زیردامنهٔ staging
  • دانلود اجباری فایل‌ها: هدر Content-Disposition: attachment روی مسیر /downloads/*
  • یکپارچه‌سازی مسیر API: بازنویسی /v1/* به /api/v1 برای کلاینت‌هایی که هنوز به‌روز نشده‌اند

بازگشت به فهرست مطالب

هزینهٔ توابع لبه

قوانین لبه هزینهٔ ثابت یا اشتراک ندارند و برای هر دامنه‌ای که CDN روی آن روشن است در دسترس‌اند. درخواست‌هایی که با ریدایرکت در لبه پاسخ می‌گیرند در شمار درخواست‌های CDN حساب می‌شوند؛ ۱ میلیارد درخواست اول هر ماه رایگان است و پس از آن ۱۰۶ تومان برای هر ۱۰ هزار درخواست با مبدأ داخل ایران محاسبه می‌شود.

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

بازگشت به فهرست مطالب

ساخت اولین قانون در پنج قدم

اگر دامنه هنوز در DNS ایران‌کلاد نیست، آن را اضافه کنید و برای رکورد موردنظر پروکسی لبه را روشن کنید. سپس در بخش CDN تنظیمات همان دامنه را باز کنید؛ کارت «قوانین لبه» پایین صفحه است. نوع قانون را انتخاب کنید، مسیر را بنویسید و مقصد یا هدر را وارد کنید.

پس از ذخیره، چند ثانیه صبر کنید و با دستور curl -I روی همان مسیر، کد پاسخ و هدر Location یا هدر اضافه‌شده را بررسی کنید. فهرست قوانین فعال هر دامنه در همان کارت دیده می‌شود و هر قانون با یک دکمه حذف می‌شود.

بازگشت به فهرست مطالب

محدودیت‌های فعلی که باید بدانید

هیچ کد مشتری، چه JavaScript و چه WASM، روی لبه اجرا نمی‌شود؛ بنابراین A/B تست، احراز هویت با توکن، ریدایرکت بر اساس کشور یا دستگاه و تغییر محتوای پاسخ با قوانین لبه ممکن نیست. ریدایرکت مقصد ثابت دارد و بخش ستاره‌دار مسیر یا query string را به مقصد منتقل نمی‌کند.

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

بازگشت به فهرست مطالب بازگشت به ابتدای راهنما

پرسش و پاسخ،  ۱۲ پرسش

سؤالات متداول

پاسخ پرسش خود را پیدا نکردید؟ با پشتیبانی در تماس باشید.

توابع لبه در ایران‌کلاد دقیقاً چه کاری می‌کنند؟
توابع لبه در ایران‌کلاد به شکل قوانین آماده پیاده شده‌اند، نه اجرای کد دلخواه. سه نوع قانون دارید: ریدایرکت یک مسیر به آدرس دیگر، بازنویسی داخلی مسیر پیش از ارسال به سرور شما، و افزودن یک هدر به پاسخ. هر قانون روی لبه و پیش از رسیدن درخواست به سرور اجرا می‌شود.
آیا می‌توانم کد JavaScript یا WASM روی لبه اجرا کنم؟
خیر. در حال حاضر هیچ کد مشتری روی لبه اجرا نمی‌شود؛ این انتخاب آگاهانه برای امنیت و پایداری لبهٔ مشترک است. سه نوع قانون ریدایرکت، بازنویسی و هدر بیشتر نیازهای رایج را پوشش می‌دهند. برای منطق پیچیده‌تر، آن را در بک‌اند یا سرور بدون سرور پیاده کنید.
کاربردهای رایج قوانین لبه چیست؟
انتقال آدرس‌های قدیمی پس از تغییر ساختار سایت با ریدایرکت ۳۰۱، هدایت یک مسیر کوتاه به صفحهٔ کمپین، بازنویسی مسیر نسخهٔ قدیمی API به مسیر جدید بدون تغییر کلاینت، و افزودن هدرهایی مثل Cache-Control یا X-Robots-Tag به مسیرهای مشخص.
چه محدودیتی در تعداد و شکل قوانین هست؟
برای هر دامنه حداکثر ۵۰ قانون. مسیر باید با / شروع شود و فقط حروف لاتین، عدد، خط تیره، نقطه، زیرخط و ستاره داشته باشد. مقصد و مقدار هدر حداکثر ۱۰۲۴ کاراکتر است و نباید فاصله، گیومه یا آکولاد داشته باشد؛ این قیدها جلوی تزریق تنظیمات را می‌گیرند.
اعمال قانون جدید چقدر طول می‌کشد؟
با ذخیرهٔ قانون، تنظیمات لبهٔ همان دامنه دوباره ساخته، اعتبارسنجی و بارگذاری می‌شود و معمولاً چند ثانیه بعد اثر دارد. اگر تنظیمات معتبر نباشد، بارگذاری انجام نمی‌شود و نسخهٔ قبلی فعال می‌ماند.
هزینهٔ توابع لبه چقدر است؟
قوانین لبه هزینهٔ جداگانه ندارند. درخواست‌هایی که با ریدایرکت در لبه پاسخ می‌گیرند مثل بقیهٔ درخواست‌های CDN در سهمیهٔ رایگان ماهانهٔ ۱ میلیارد درخواست شمرده می‌شوند و ترافیک خروجی رایگان است.
تفاوت ریدایرکت و بازنویسی چیست؟
در ریدایرکت، لبه به مرورگر می‌گوید به آدرس دیگری برود و آدرس نوار مرورگر عوض می‌شود. در بازنویسی، آدرسی که کاربر می‌بیند ثابت می‌ماند و فقط مسیری که به سرور شما فرستاده می‌شود تغییر می‌کند. اولی برای جابه‌جایی صفحه‌ها و دومی برای سازگاری مسیرهای قدیمی با ساختار جدید مناسب است.
کدام کد ریدایرکت را انتخاب کنم؟
برای جابه‌جایی دائمی صفحه که می‌خواهید اعتبار آن در موتور جست‌وجو منتقل شود ۳۰۱، برای انتقال موقت مثل صفحهٔ کمپین ۳۰۲، و اگر روش درخواست (مثلاً POST) باید حفظ شود ۳۰۷ برای موقت و ۳۰۸ برای دائمی را انتخاب کنید.
آیا بقیهٔ مسیر در ریدایرکت با ستاره به مقصد منتقل می‌شود؟
خیر. ستاره در مسیر فقط برای تطبیق است و مقصد یک آدرس ثابت است. پس قانون /blog/* با مقصد /articles همهٔ صفحه‌های بلاگ را به صفحهٔ اصلی مقاله‌ها می‌برد، نه به صفحهٔ متناظر. برای انتقال یک‌به‌یک، برای هر صفحهٔ مهم قانون جدا بسازید.
قوانین لبه با API قابل مدیریت است؟
فعلاً خیر؛ قوانین از صفحهٔ تنظیمات CDN هر دامنه در پنل ساخته و حذف می‌شوند. سایر تنظیمات لبه مثل کش، محدودیت نرخ و CORS از طریق API ایران‌کلاد هم قابل تغییرند.
آیا یک قانون روی همهٔ زیردامنه‌ها اعمال می‌شود؟
خیر. قوانین برای هر دامنه یا زیردامنه‌ای که CDN روی آن روشن است جداگانه تعریف می‌شوند؛ قانونی که روی www.example.com می‌سازید روی shop.example.com اثری ندارد. این جداسازی اجازه می‌دهد هر بخش سایت مسیریابی مستقل خودش را داشته باشد.
اگر قانونی اشتباه باشد چطور برگردانم؟
قانون را از فهرست قوانین همان دامنه حذف کنید؛ تنظیمات لبه دوباره ساخته می‌شود و چند ثانیه بعد رفتار قبلی برمی‌گردد. پیشنهاد می‌کنیم قوانین مهم را ابتدا با کد ۳۰۲ تست کنید و پس از اطمینان، آن‌ها را با ۳۰۱ دوباره بسازید.

پاسخ پرسش خود را پیدا نکردید؟ با پشتیبانی در تماس باشید.

ریدایرکت، بازنویسی و هدر روی لبهٔ ایران

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