Skip to content

Instantly share code, notes, and snippets.

@armamini
Created December 12, 2025 16:35
Show Gist options
  • Select an option

  • Save armamini/7fe50fa3092323da7bc3fef514dacbe4 to your computer and use it in GitHub Desktop.

Select an option

Save armamini/7fe50fa3092323da7bc3fef514dacbe4 to your computer and use it in GitHub Desktop.
Implement a reliable connection over Websocket via Cloudflare Workers

ساخت با Cloudflare Workers

این راهنما به شما کمک می‌کند تا بدون هزینه و سرور مجازی، یک فیلترشکن شخصی با سرعت بالا و پینگ مناسب روی زیرساخت کلادفلر بسازید. (V2Ray over Websocket)


📋 پیش‌نیازها

  1. اکانت Cloudflare: نیاز به یک ایمیل (شخصی یا موقت) دارید.
  2. کد اسکریپت: کدی که باید در ورکر قرار دهید (موجود در فایل‌های این مخزن).
  3. UUID: یک کد یکتا که به عنوان رمز عبور عمل می‌کند.

🚀 مراحل نصب و راه‌اندازی

۱. ثبت‌نام در کلادفلر

  1. وارد سایت Cloudflare شوید.
  2. روی گزینه Sign Up کلیک کنید و با ایمیل خود ثبت‌نام کنید.
  3. ایمیل تاییدیه را که برایتان ارسال می‌شود، تایید (Verify) کنید.

۲. ساخت ورکر (Worker)

  1. در پنل کاربری، از منوی سمت چپ وارد بخش Workers & Pages شوید.
  2. دکمه Create Worker را بزنید.
  3. قالب Hello World را انتخاب کرده و Get Started را کلیک کنید.
  4. یک نام دلخواه انتخاب کنید و دکمه Deploy را بزنید.

۳. ساخت فضای ذخیره‌سازی (KV)

  1. از منوی سمت چپ، به مسیر Storage & Databases > KV بروید.
  2. روی Create a Namespace کلیک کنید.
  3. یک نام دلخواه (مثلاً vpn-data) وارد کرده و دکمه Add را بزنید.

۴. اتصال KV به ورکر (Binding)

  1. به تنظیمات همان ورکری که در مرحله ۲ ساختید برگردید.
  2. وارد تب Settings شوید و سپس Variables را انتخاب کنید.
  3. در بخش KV Namespace Bindings، روی Add Binding کلیک کنید.
  4. تنظیمات را دقیقاً به صورت زیر انجام دهید:
    • Variable name: فقط حرف بزرگ C را وارد کنید (بسیار مهم).
    • KV Namespace: نام فضایی که در مرحله ۳ ساختید را انتخاب کنید.
  5. دکمه Save and Deploy را بزنید.

۵. تنظیم رمز عبور (UUID)

  1. در همان تب Variables، به بخش Environment Variables بروید.
  2. روی Add Variable کلیک کنید.
  3. تنظیمات را به صورت زیر انجام دهید:
    • Variable name: حرف بزرگ U را وارد کنید.
    • Value: در این بخش باید یک کد UUID وارد کنید.

🛠 نحوه دریافت کد UUID:

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

  • روش آنلاین: وارد وب‌سایت uuidgenerator.net شوید و کدی که نمایش داده می‌شود را کپی کنید.
  • سیستم‌عامل macOS یا Linux: ترمینال را باز کنید و دستور زیر را تایپ کنید:
    uuidgen
  1. کد کپی شده را در بخش Value قرار دهید و تغییرات را ذخیره کنید (Save and Deploy).

۶. قرار دادن کد اسکریپت

  1. در بالای صفحه ورکر، روی دکمه Edit Code کلیک کنید.
  2. تمام کدهای موجود در فایل worker.js را پاک کنید.
  3. کد اسکریپت موجود CODE را کپی کرده و در ادیتور پیست کنید.
  4. دکمه Deploy را بزنید.

📱 نحوه استفاده

دریافت لینک اشتراک

  1. آدرس URL ورکر خود را باز کنید (فرمت: https://name.workers.dev).
  2. در انتهای آدرس، کد UUID خود را اضافه کنید: https://your-worker-name.workers.dev/YOUR-UUID-CODE
  3. در پنل باز شده، لینک سابسکریپشن یا کانفیگ‌های تکی را کپی کنید.

اتصال

  • لینک را در نرم‌افزارهایی مثل Hiddify یا Happ ایمپورت کنید و متصل شوید.

⚠️ نکات پایانی

  • ترید ممنوع: IP این سرویس ثابت نیست و با هر بار اتصال ممکن است تغییر کند.
  • هزینه: این روش از پلن رایگان Cloudflare استفاده می‌کند و هزینه‌ای ندارد.

⚖️ سلب مسئولیت (Disclaimer)

این آموزش و محتوای ارائه شده در این مخزن، صرفاً جنبه آموزشی و تحقیقاتی داشته و با هدف آشنایی کاربران با نحوه عملکرد سرویس‌های CDN و قابلیت‌های Cloudflare Workers تهیه شده است.

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment