تحریم شکن برای Cloudflare Pages

محدودیت دسترسی به Cloudflare Pages می‌تواند فرایند توسعه، دریافت وابستگی‌ها یا استفاده از ابزارهای مرتبط را مختل کند. در این راهنما تنظیم شکن، دامنه‌های لازم و روش آزمایش تحریم شکن برای Cloudflare Pages را با نمونه عملی توضیح می‌دهیم.

Cloudflare Pages یکی از سرویس‌های میزبانی و انتشار وب‌سایت است که به توسعه‌دهندگان امکان می‌دهد پروژه‌های وب خود را از طریق اتصال به مخزن کد یا روش‌های دیگر منتشر کنند. این سرویس برای سایت‌های استاتیک، پروژه‌های فرانت‌اند و برخی کاربردهای مبتنی بر Pages Functions استفاده می‌شود.

با وجود سادگی فرایند انتشار در بسیاری از پروژه‌ها، گاهی هنگام اتصال مخزن Git، اجرای Build، انتشار نسخه جدید یا باز کردن آدرس سایت با خطا مواجه می‌شوید. در بعضی شرایط، مشکل می‌تواند به اتصال شبکه یا DNS مربوط باشد؛ اما بسیاری از خطاهای Cloudflare Pages از تنظیمات پروژه، مسیر خروجی Build، دامنه سفارشی یا گواهی SSL ناشی می‌شوند.

در این راهنما، به‌جای تکرار آموزش عمومی Cloudflare، روی مشکلات ویژه Cloudflare Pages تمرکز می‌کنیم: از دسترسی به پروژه و Deploy گرفته تا خطاهای دامنه، آدرس pages.dev و روش بررسی اتصال با DNS شکن.

Cloudflare Pages چیست؟

Cloudflare Pages سرویسی برای میزبانی و انتشار پروژه‌های وب است. توسعه‌دهندگان می‌توانند کد پروژه خود را به مخزن‌هایی مانند GitHub یا GitLab متصل کنند تا با تغییرات جدید، فرایند ساخت و انتشار سایت اجرا شود.

از کاربردهای Cloudflare Pages می‌توان به این موارد اشاره کرد:

• انتشار وب‌سایت‌های استاتیک و صفحات فرانت‌اند

• اتصال پروژه به مخزن Git و مدیریت نسخه‌های سایت

• مشاهده گزارش ساخت و انتشار نسخه‌های مختلف

• استفاده از دامنه پیش‌فرض pages.dev

• اتصال دامنه اختصاصی به پروژه

• پیاده‌سازی قابلیت‌های پویا با Pages Functions، در صورت نیاز پروژه

اگر از Cloudflare Pages استفاده می‌کنید، باید میان سه نوع مشکل تفاوت قائل شوید: باز نشدن داشبورد، شکست فرایند Deploy و در دسترس نبودن سایت منتشرشده. هرکدام علت‌ها و راهکارهای متفاوتی دارند.

چرا Cloudflare Pages باز نمی‌شود یا Deploy خطا می‌دهد؟

پیش از تغییر DNS، مشخص کنید خطا در کدام مرحله رخ می‌دهد.

۱. داشبورد یا صفحه پروژه باز نمی‌شود

اگر نمی‌توانید وارد داشبورد شوید یا صفحه پروژه بارگذاری نمی‌شود، مشکل ممکن است به اتصال اینترنت، DNS، مرورگر یا وضعیت حساب مربوط باشد.

در این شرایط، ابتدا آدرس داشبورد Cloudflare را باز کنید. اگر صفحه ورود هم بارگذاری نمی‌شود، اتصال را با یک مرورگر یا شبکه دیگر آزمایش کنید. در صورت مشاهده خطای مرتبط با DNS، تغییر DNS می‌تواند یکی از مراحل عیب‌یابی باشد.

اما اگر وارد داشبورد می‌شوید و پروژه را مشاهده می‌کنید، ولی Deploy با خطا متوقف می‌شود، احتمال دارد علت در تنظیمات پروژه یا محیط Build باشد. در این حالت، تغییر DNS دستگاه لزوماً مشکل را برطرف نمی‌کند.

۲. اتصال به GitHub یا GitLab مشکل دارد

Cloudflare Pages می‌تواند از مخزن کد برای دریافت تغییرات پروژه استفاده کند. اگر فرایند اتصال یا دریافت کد با مشکل مواجه شود، بررسی مجوزهای اتصال و تنظیمات مخزن اهمیت دارد.

موارد زیر را بررسی کنید:

• آیا مخزن موردنظر هنوز وجود دارد؟

• آیا حساب متصل به Cloudflare مجوز دسترسی به مخزن را دارد؟

• آیا اتصال Git در تنظیمات پروژه معتبر است؟

• آیا خطا در مرحله دریافت کد رخ می‌دهد یا بعد از شروع Build؟

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

۳. فرایند Build شکست می‌خورد

ممکن است پروژه به مخزن متصل باشد و Cloudflare نیز کد را دریافت کند، اما مرحله Build با خطا متوقف شود.

در این حالت، مواردی مانند دستور Build، پوشه خروجی، نسخه ابزارهای موردنیاز، وابستگی‌های پروژه و متغیرهای محیطی باید بررسی شوند.

برای نمونه، اگر پروژه با یک فریم‌ورک جاوااسکریپت ساخته شده است، دستور Build و مسیر خروجی باید با تنظیمات همان فریم‌ورک سازگار باشند. تنظیم اشتباه این مقادیر ممکن است مانع انتشار سایت شود؛ حتی اگر اتصال اینترنت کاملاً برقرار باشد.

۴. سایت منتشر شده اما باز نمی‌شود

اگر وضعیت Deploy موفق است اما آدرس سایت باز نمی‌شود، باید تفاوت میان آدرس پیش‌فرض pages.dev و دامنه اختصاصی را بررسی کنید.

برای مثال، اگر آدرس پیش‌فرض پروژه باز می‌شود اما دامنه اختصاصی خطا دارد، احتمال دارد تنظیمات DNS دامنه، اتصال دامنه به پروژه یا فرایند فعال‌سازی SSL مشکل داشته باشد.

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

آیا تحریم شکن برای Cloudflare Pages کاربرد دارد؟

شکن یک سرویس DNS است و ممکن است در بعضی مشکلات مرتبط با شناسایی دامنه یا اتصال شبکه مفید باشد. اگر دسترسی به داشبورد Cloudflare Pages یا یک آدرس مربوط به پروژه به دلیل مشکل DNS برقرار نمی‌شود، می‌توانید DNS شکن را برای آزمایش بررسی کنید.

بااین‌حال، DNS شکن جایگزین تنظیمات صحیح Build، مجوزهای مخزن، پیکربندی دامنه یا گواهی SSL نیست. همچنین تضمینی وجود ندارد که با تغییر DNS، همه مراحل Deploy یا تمام آدرس‌های pages.dev در دسترس قرار بگیرند.

برای تشخیص بهتر، به محل بروز خطا توجه کنید:

• داشبورد باز نمی‌شود: اتصال شبکه، DNS، مرورگر و وضعیت حساب را بررسی کنید.

• اتصال مخزن انجام نمی‌شود: مجوزهای GitHub یا GitLab و پیام خطا را بررسی کنید.

• Build شکست می‌خورد: گزارش Build و تنظیمات پروژه را بررسی کنید.

• دامنه اختصاصی باز نمی‌شود: رکورد DNS، اتصال دامنه به پروژه و SSL را بررسی کنید.

• آدرس pages.dev خطای 404 می‌دهد: فایل خروجی و وجود فایل index.html را بررسی کنید.

آدرس DNS شکن رایگان و حرفه‌ای

اگر نشانه‌های خطا به DNS مربوط هستند، می‌توانید آدرس‌های زیر را روی دستگاه خود تنظیم و اتصال به Cloudflare Pages را دوباره آزمایش کنید.

پس از اعمال تنظیمات، صفحه داشبورد و آدرس پروژه را جداگانه آزمایش کنید. اگر مشکل فقط در مرحله Build رخ می‌دهد، متن خطا را از گزارش انتشار بخوانید؛ زیرا تغییر DNS دستگاه ممکن است هیچ تأثیری بر علت اصلی نداشته باشد.

برای آشنایی با مفهوم DNS و تنظیم آن می‌توانید راهنمای DNS تحریم شکن را ببینید.

آموزش تنظیم DNS شکن برای Cloudflare Pages در ویندوز

اگر از ویندوز برای توسعه و انتشار پروژه استفاده می‌کنید، می‌توانید DNS شبکه را برای بررسی مشکلات احتمالی اتصال تغییر دهید.

۱. وارد Settings شوید.

۲. بخش Network & Internet را باز کنید.

۳. اتصال فعال Wi-Fi یا Ethernet را انتخاب کنید.

۴. بخش تنظیم DNS یا DNS server assignment را باز کنید.

۵. حالت Manual را انتخاب و IPv4 را فعال کنید.

۶. DNS اول و دوم شکن را وارد کنید.

۷. تغییرات را ذخیره کنید.

۸. داشبورد Cloudflare و آدرس پروژه را دوباره آزمایش کنید.

اگر داشبورد باز می‌شود اما Deploy همچنان شکست می‌خورد، به‌جای تغییر مجدد DNS، گزارش Build را بررسی کنید. برای آموزش کامل تنظیم DNS در ویندوز، به صفحه تحریم شکن برای ویندوز مراجعه کنید.

تنظیم DNS شکن در مک و لینوکس

اگر برای توسعه پروژه از macOS یا لینوکس استفاده می‌کنید، می‌توانید DNS اتصال فعال را از تنظیمات شبکه تغییر دهید. مسیر دقیق این گزینه در نسخه‌های مختلف سیستم‌عامل و ابزارهای مدیریت شبکه متفاوت است.

در مک، معمولاً تنظیم DNS در بخش Network و تنظیمات اتصال فعال قرار دارد. در لینوکس نیز ممکن است بتوانید از رابط گرافیکی شبکه، NetworkManager یا ابزار مدیریت DNS سیستم استفاده کنید.

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

راهنماهای مرتبط:

• تحریم شکن برای مک

• تحریم شکن برای لینوکس

رفع خطاهای رایج Cloudflare Pages

جدول زیر به شما کمک می‌کند خطاهای مربوط به انتشار پروژه را از مشکلات احتمالی DNS جدا کنید.

چگونه گزارش خطای Cloudflare Pages را بررسی کنیم؟

اگر پروژه شما Deploy نمی‌شود، گزارش Build یکی از مهم‌ترین منابع برای تشخیص علت مشکل است.

برای مشاهده گزارش:

۱. وارد داشبورد Cloudflare شوید.

۲. بخش Workers & Pages را باز کنید.

۳. پروژه موردنظر را انتخاب کنید.

۴. به بخش Deployments بروید.

۵. جزئیات انتشار ناموفق را باز کنید و Build log را بررسی کنید.

در گزارش مشخص می‌شود خطا در کدام مرحله رخ داده است؛ برای مثال، هنگام آماده‌سازی محیط، نصب وابستگی‌ها، اجرای دستور Build یا انتشار خروجی.

اگر خطا مربوط به نصب وابستگی‌ها یا دریافت فایل از مخزن باشد، اتصال شبکه و دسترسی به منابع موردنیاز را بررسی کنید. اگر خطا به مسیر خروجی یا دستور Build اشاره می‌کند، باید تنظیمات پروژه را اصلاح کنید.

برای راهنمای جزئی‌تر، مستند رسمی عیب‌یابی Cloudflare Pages را مطالعه کنید.

چرا سایت Cloudflare Pages با خطای 404 باز می‌شود؟

خطای 404 به‌تنهایی نشان نمی‌دهد که مشکل از DNS یا محدودیت دسترسی است. در پروژه‌های Cloudflare Pages، این خطا می‌تواند به نبود فایل موردنیاز در خروجی انتشار یا درخواست مسیری مربوط باشد که در سایت وجود ندارد.

اگر آدرس اصلی پروژه، مانند example.pages.dev، خطای 404 می‌دهد، موارد زیر را بررسی کنید:

• آیا آخرین Deploy با موفقیت انجام شده است؟

• آیا پوشه خروجی Build همان پوشه‌ای است که در تنظیمات پروژه تعیین شده؟

• آیا فایل index.html در مسیر اصلی خروجی وجود دارد؟

• آیا آدرسی که باز می‌کنید متعلق به پروژه صحیح است؟

اگر صفحه اصلی باز می‌شود اما یک مسیر داخلی خطای 404 دارد، ساختار مسیریابی پروژه و تنظیمات فریم‌ورک را بررسی کنید.

در این شرایط، تغییر DNS معمولاً اولین راهکار نیست؛ ابتدا باید مطمئن شوید محتوای موردنظر واقعاً در خروجی منتشرشده وجود دارد.

چرا دامنه اختصاصی Cloudflare Pages فعال نمی‌شود؟

یکی از مراحل مهم پس از انتشار سایت، اتصال دامنه اختصاصی به پروژه است. این کار از بخش Custom domains در تنظیمات پروژه انجام می‌شود.

اگر دامنه فعال نمی‌شود، موارد زیر را بررسی کنید:

۱. دامنه را از بخش Custom domains پروژه اضافه کرده باشید.

۲. رکوردهای DNS مطابق راهنمای نمایش‌داده‌شده در پنل تنظیم شده باشند.

۳. اگر از دامنه اصلی مانند example.com استفاده می‌کنید، شرایط لازم برای اتصال دامنه و Nameserverها فراهم باشد.

۴. وضعیت اعتبارسنجی دامنه و گواهی SSL را بررسی کنید.

۵. اگر دامنه پیش‌تر به مقصد دیگری اشاره می‌کرده، رکوردهای قدیمی و تنظیمات مرتبط را بازبینی کنید.

صرفاً ساختن یک رکورد CNAME بدون تکمیل فرایند اتصال دامنه در داشبورد Pages ممکن است کافی نباشد. بنابراین، بهتر است دامنه را از طریق مسیر رسمی پروژه اضافه کنید و وضعیت فعال‌سازی آن را در پنل دنبال کنید.

برای جزئیات بیشتر می‌توانید مستند اتصال دامنه اختصاصی به Cloudflare Pages را ببینید.

تفاوت مشکل DNS دستگاه با DNS دامنه Cloudflare Pages

این دو موضوع گاهی با یکدیگر اشتباه گرفته می‌شوند، درحالی‌که نقش متفاوتی دارند.

DNS دستگاه: تعیین می‌کند رایانه یا گوشی شما چگونه نام دامنه‌هایی مانند dash.cloudflare.com یا آدرس پروژه را پیدا کند. اگر مشکل در همین مرحله باشد، تغییر DNS دستگاه ممکن است به برقراری اتصال کمک کند.

DNS دامنه پروژه: مشخص می‌کند دامنه اختصاصی سایت شما به چه مقصدی اشاره کند. اگر دامنه به پروژه Pages متصل نشده باشد یا رکورد آن اشتباه باشد، تغییر DNS رایانه شما رکوردهای دامنه را اصلاح نمی‌کند.

برای مثال، اگر داشبورد Cloudflare باز می‌شود و آدرس example.pages.dev نیز کار می‌کند اما www.example.com باز نمی‌شود، باید تنظیمات دامنه اختصاصی را بررسی کنید؛ نه اینکه صرفاً DNS دستگاه را تغییر دهید.

آیا برای Cloudflare Pages به VPN نیاز داریم؟

به نوع خطا بستگی دارد. اگر مشکل به DNS مربوط باشد، تغییر DNS می‌تواند یک اقدام آزمایشی باشد. اما اگر Build به دلیل خطای کد، مسیر خروجی، وابستگی‌ها یا تنظیمات دامنه متوقف شده باشد، تغییر DNS یا استفاده از VPN لزوماً مشکل را حل نمی‌کند.

همچنین باید بین باز نشدن داشبورد و در دسترس نبودن سایت منتشرشده تفاوت قائل شوید. این دو بخش مسیرهای عیب‌یابی متفاوتی دارند.

بهترین روش این است که ابتدا پیام خطا و مرحله بروز آن را مشخص کنید و سپس راهکار مناسب را انتخاب کنید.

پرسش‌های متداول درباره تحریم شکن برای Cloudflare Pages

آیا DNS شکن خطاهای Deploy در Cloudflare Pages را رفع می‌کند؟

فقط در صورتی که مشکل به DNS یا اتصال شبکه مربوط باشد، ممکن است کمک کند. خطاهای مربوط به کد پروژه، دستور Build، وابستگی‌ها و پوشه خروجی باید جداگانه بررسی شوند.

چرا Cloudflare Pages به مخزن GitHub متصل نمی‌شود؟

این مشکل می‌تواند به مجوزهای حساب، تنظیمات اتصال Git یا دسترسی به مخزن مربوط باشد. ابتدا پیام خطا و مجوزهای اتصال را بررسی کنید. اگر خطا صراحتاً به شبکه یا DNS اشاره دارد، اتصال را نیز آزمایش کنید.

چرا سایت pages.dev باز نمی‌شود؟

ممکن است انتشار پروژه کامل نشده باشد، آدرس اشتباه باشد یا مشکل شبکه و DNS وجود داشته باشد. ابتدا وضعیت آخرین Deploy و سپس دسترسی به آدرس پروژه را بررسی کنید.

چرا دامنه اختصاصی باز نمی‌شود اما آدرس pages.dev کار می‌کند؟

این وضعیت معمولاً نیازمند بررسی رکوردهای DNS دامنه، اتصال دامنه در بخش Custom domains و وضعیت SSL است. تنظیم DNS دستگاه به‌تنهایی رکوردهای دامنه را تغییر نمی‌دهد.

آیا می‌توان از DNS شکن برای دسترسی به داشبورد Cloudflare Pages استفاده کرد؟

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

اگر Build موفق باشد اما نسخه جدید سایت نمایش داده نشود، چه کنیم؟

ابتدا مطمئن شوید Deploy جدید با موفقیت منتشر شده و آدرس درست را باز می‌کنید. سپس کش مرورگر و تنظیمات کش مرتبط با دامنه را بررسی کنید. اگر فقط دامنه اختصاصی مشکل دارد، تنظیمات آن را با آدرس pages.dev مقایسه کنید.

جمع‌بندی

اگر هنگام استفاده از Cloudflare Pages با مشکل مواجه شده‌اید، ابتدا مرحله بروز خطا را مشخص کنید: ورود به داشبورد، اتصال مخزن، اجرای Build، انتشار سایت یا اتصال دامنه اختصاصی.

تحریم شکن می‌تواند برای بررسی مشکلات احتمالی DNS مفید باشد، اما همه خطاهای Cloudflare Pages به DNS مربوط نیستند. گزارش Build، تنظیمات پروژه، مجوزهای مخزن، رکوردهای دامنه و وضعیت SSL منابع مهمی برای عیب‌یابی هستند.

اگر هدف شما رفع مشکل دسترسی به خود پلتفرم Cloudflare است، راهنمای تحریم شکن برای Cloudflare را نیز ببینید. در مقابل، برای خطاهای انتشار سایت، تنظیمات پروژه و اتصال دامنه در Cloudflare Pages، مراحل همین راهنما را دنبال کنید.