نصب‌کننده Cloudflare Worker

گام ۱: مشخصات حساب و توکن Cloudflare

در داشبورد Cloudflare به بخش Workers & Pages بروید؛ شناسه حساب در URL داشبورد مشخص است.

برای استفاده از دفترچه، حساب را پس از واردکردن مشخصات ذخیره کنید. Token در مرورگر با AES-GCM رمزگذاری می‌شود و رمز اصلی ذخیره نمی‌شود.

دفترچه امن حساب‌ها (حداکثر ۱۰ حساب)

رمز اصلی دفترچه

برای نگهداری رمزگذاری‌شده حساب‌ها، ابتدا دفترچه را ایجاد یا باز کنید.

دسترسی‌های لازم:
• برای ساخت Worker جدید یا Clean Rebuild: نقش Workers Admin در سطح حساب.
• برای اتصال D1: دسترسی D1 Edit.
• برای ساخت KV: دسترسی Workers KV Storage Edit.
• برای اتصال دامنه: دسترسی مدیریت Worker و فعال بودن Zone دامنه در همین حساب.

گام ۲: سورس و مشخصات Worker

الگوی آماده پروژه

نام Worker *

برای به‌روزرسانی، نام Worker موجود را وارد کنید. نام باید با حروف کوچک و عدد شروع شود.

آدرس مستقیم سورس کد (GitHub Raw URL) *

فقط لینک خام GitHub یا Gist پذیرفته می‌شود. فایل باید یک اسکریپت Worker آماده استقرار باشد.

دامنه یا زیردامنه اختصاصی (اختیاری)

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

مبهم‌سازی سورس کد (Obfuscator)همان روش رشته‌ای XOR/Base64 مورد استفاده Jasaz؛ ممکن است با بعضی سورس‌ها ناسازگار باشد و رمزنگاری واقعی نیست.

حذف و بازسازی مجدد Worker (Clean Rebuild)در صورت وجود Worker با همین نام، ابتدا حذف و سپس از صفر ایجاد می‌شود. در صورت شکست آپلود، نسخه قبلی خودکار برنمی‌گردد؛ منابع Durable Object متعلق به Worker نیز ممکن است حذف شوند.

⚠️ مبهم‌سازی را فقط وقتی فعال کنید که سورس را تست کرده‌اید. برای سورس‌های از پیش مبهم‌شده مانند بعضی نسخه‌های Nahan، مبهم‌سازی مجدد را فعال نکنید.

گام ۳: منابع ذخیره‌سازی اختیاری (D1 و KV)

ساخت یا اتصال پایگاه‌داده D1اگر دیتابیسی با همین نام وجود داشته باشد، به همان متصل می‌شود؛ در غیر این صورت ایجاد می‌شود.

نام دیتابیس D1 *

نام Binding در سورس Worker *

ساخت یا اتصال KV Namespaceفضای KV موجود با همان عنوان پیدا می‌شود؛ اگر وجود نداشته باشد ساخته خواهد شد.

نام KV Namespace *

نام Binding در سورس Worker *

نکته: این مرحله فقط منابع را ایجاد/پیدا و Binding آن‌ها را روی Worker تنظیم می‌کند؛ ساخت جدول‌ها و داده‌های اولیه دیتابیس بر عهده سورس Worker است.

گام ۴: بازبینی و استقرار نهایی

نام Worker—

سورس—

مبهم‌سازیخاموش

روش استقراربه‌روزرسانی مستقیم

دامنه اختصاصیغیرفعال

D1غیرفعال

KVغیرفعال

با شروع عملیات، درخواست با API Token حساب شما به Cloudflare ارسال می‌شود. گزینه Clean Rebuild عملیات حذف Worker موجود را نیز انجام می‌دهد.

پایش سلامت و بازسازی خودکار

مسیر بررسی سلامت

فاصله بررسی (دقیقه)

تعداد شکست متوالی

اجازه بازسازی خودکار

پس از استقرار موفق و ذخیره حساب در دفترچه، پایش قابل فعال‌سازی است.

هنوز پایشی انجام نشده است.

هشدار: Rebuild خودکار ابتدا Worker قبلی را حذف می‌کند. از آن برای Workerهای دارای Durable Object بدون پشتیبان استفاده نکنید. پایش مرورگری با بسته‌شدن صفحه یا قفل دفترچه متوقف می‌شود.