Sotoon Logo

📄 سفارشی‌سازی صفحات خطای CDN

در پایان این راهنما، محتوای HTML اختصاصی را جایگزین صفحه خطای 404 پیش‌فرض CDN ستون می‌کنیم. در پنل، می‌توانیم صفحات 404، 502، 503 و 504 را جداگانه تنظیم کنیم.

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

پیش‌نیازها

  • یک دامنه یا زیردامنه پشت CDN ستون — آموزش‌های CDN
  • محتوای HTML برای کد خطای موردنظر؛ متن واردشده در پنل باید حداکثر ۵۱۲۰ کاراکتر باشد.

مراحل

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

  2. بخش شخصی‌سازی صفحات را باز می‌کنیم و روی ویرایش HTML صفحه کد وضعیت 404 را کلیک می‌کنیم.

  3. در بخش قالب صفحه، گزینه صفحه اختصاصی را انتخاب می‌کنیم.

  4. در فیلد ویرایش HTML، کد صفحه را وارد می‌کنیم. برای نمونه، برای صفحه 404 از HTML زیر استفاده می‌کنیم:

    <!doctype html>
<html lang="fa" dir="rtl">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>صفحه پیدا نشد</title>
    <style>
      body {
        font-family: sans-serif;
        max-width: 36rem;
        margin: 4rem auto;
        padding: 1rem;
        text-align: center;
      }
    </style>
  </head>
  <body>
    <h1>صفحه پیدا نشد</h1>
    <p>آدرس واردشده را بررسی می‌کنیم یا به صفحه اصلی بازمی‌گردیم.</p>
    <a href="/">بازگشت به صفحه اصلی</a>
  </body>
</html>

  5. روی تایید و ذخیره کلیک می‌کنیم. پس از ذخیره، پنجره ویرایش بسته می‌شود.

برای بازگرداندن صفحه پیش‌فرض، همان فرم را باز می‌کنیم، محتوای HTML را پاک می‌کنیم، صفحه پیش‌فرض را انتخاب می‌کنیم و تایید و ذخیره را می‌زنیم. برچسب شخصی‌سازی شده باید از کارت حذف شود.

نمایش صفحه هنگام قطع دسترسی به آپ‌استریم

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

بررسی صحت

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

  2. برای بررسی پاسخ واقعی، روی دامنه آزمایشی پشت CDN، آدرسی را باز می‌کنیم که صفحه خطای پیش‌فرض CDN با همان کد را نمایش می‌دهد. برای نمونه، اگر مسیر /cdn-error-test صفحه 404 ستون را نمایش می‌دهد، درخواست زیر را اجرا می‌کنیم؛ cdn.example.com را با دامنه آزمایشی جایگزین می‌کنیم:

    curl -i "https://cdn.example.com/cdn-error-test"
    • کد وضعیت پاسخ باید 404 باشد.
    • بدنه پاسخ باید شامل متن HTML اختصاصی، مانند «صفحه پیدا نشد»، باشد.

  3. همان آدرس را در مرورگر باز می‌کنیم تا نمایش متن فارسی و ظاهر صفحه را نیز بررسی کنیم. برای بررسی صفحات 502، 503 و 504 از محیط آزمایشی با همان خطا استفاده می‌کنیم.

اگر صفحه اختصاصی نمایش داده نمی‌شود، موارد زیر را بررسی می‌کنیم:

  • وب‌سایت انتخاب‌شده، کد وضعیت پاسخ و محتوای ذخیره‌شده در کارت همان کد را تطبیق می‌دهیم.
  • اگر آدرس آزمایش صفحه، خطای خود برنامه را نمایش می‌دهد، مسیری را پیدا می‌کنیم که صفحه خطای پیش‌فرض CDN را نمایش دهد.
  • اگر فرم ذخیره نمی‌شود، خالی نبودن HTML و رعایت محدودیت ۵۱۲۰ کاراکتر را بررسی می‌کنیم.

ادامه مسیر

بک‌لینک‌ها