پرش به محتوا

کتابخانه

دانلود @cap.js/wasm و نشانی CDN ایرانی

@cap.js/wasm یه بسته npm برای پروژه Cap هست؛ همون Capی که جایگزین سبک و متن باز کپچاست و به جای انتخاب عکس، با اثبات کار (Proof of Work) و هش SHA-256 کار می کنه. این بسته حل کننده WebAssembly رو در اختیارت می ذاره تا چالش ها توی مرورگر سریع تر حل بشن.

نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز Apache-2.0؛ هش هر فایل با منبع بررسی شده است.

آخرین نسخه
۰.۰.۸
نسخه‌ها در مخزن
۵
مجوز
Apache-2.0
سازنده
Tiago
آخرین بررسی
آخرین به‌روزرسانی
توضیحات

آخرین نسخه

آخرین نسخه ۰.۰.۸ آخرین

۶۳ کیلوبایت· ۸ فایل· انتشار

دانلود
نشانی مستقیم فایل اصلی https://mirror.wbweb.ir/npm/@cap.js/wasm@0.0.8/node/cap_wasm.js
کد آماده با SRI <script src="https://mirror.wbweb.ir/npm/@cap.js/wasm@0.0.8/node/cap_wasm.js" integrity="sha256-nYT6HT1P+VyYaWQAHg/GTzudOqqXgflkVqXMJNB+guk=" crossorigin="anonymous"></script>

SHA-256: 9d84fa1d3d4ff95c986964001e0fc64f3b9d3aaa9781f96456a5cc24d07e82e9

درباره @cap.js/wasm (کپ جی اس وسم)

کپچاهای معمول یه مشکل همیشگی دارن: یا کاربر رو با انتخاب عکس و چراغ راهنما اذیت می کنن، یا به یه سرویس خارجی وصلن که از داخل ایران گاهی کند یا ناپایداره. Cap راه دیگه ای رفته. به جای اینکه بپرسه «ربات هستی یا نه»، از مرورگر می خواد یه محاسبه کوچیک انجام بده. @cap.js/wasm همون بخشیه که این محاسبه رو انجام می ده.

ماجرا ساده است. سرور یه چالش می فرسته و مرورگر باید با هش SHA-256 جواب درست رو پیدا کنه. برای کاربر معمولی چند لحظه بیشتر طول نمی کشه و کاربر کاری هم نمی کنه؛ همه چیز پشت صحنه اتفاق می افته. ولی رباتی که می خواد هزاران بار فرم رو پر کنه، هر بار باید همین هزینه رو بده و جمعش سنگین می شه. اسم این روش Proof of Work یا اثبات کاره. بسته @cap.js/wasm محاسبه رو با WebAssembly انجام می ده که معمولا از هش کردن با جاوااسکریپت خالص سریع تره.

این بسته به درد کسی می خوره که کپچای خودمیزبان می خواد و نمی خواد به سرویس بیرونی وابسته باشه؛ مثلا برای فرم ثبت نام، تماس یا ورود سایتی که روی هاست داخلی بالا اومده. ولی اگه دنبال افزونه وردپرسی ای هستی که فقط فعالش کنی، این چیزی نیست که می خوای. این یه کتابخانه جاوااسکریپته، نه افزونه، و فقط یه تکه از مجموعه Cap حساب می شه. برای کار کامل، سرور Cap و ویجتش رو هم لازم داری.

قبل از انتخاب سه چیز رو در نظر بگیر. اثبات کار جادو نیست: مهاجمی که منابع زیادی داره می تونه هزینه محاسبه رو بده، پس برای فرم های حساس محدودیت تعداد درخواست هم بذار. روی گوشی های ضعیف حل چالش ممکنه کمی بیشتر طول بکشه، پس سختی چالش رو با دقت تنظیم کن. مجوز Apache هم معمولا استفاده تجاری رو اجازه می ده، ولی متن مجوز رو یه بار بخون و اطلاعیه ها رو نگه دار. اگه سایتت ترافیک زیادی داره، قبل از انتشار روی یه نمونه آزمایشی ببین سرور Cap زیر بار چطور رفتار می کنه.

نسخه های رسمی و بدون تغییر این بسته توی مخزن داخلی ما هم هست؛ برای روزهایی که دسترسی به npm و اینترنت بین الملل مختل می شه.

راهنمای استفاده

اگه فقط می خوای بسته رو توی یه صفحه امتحان کنی، ساده ترین راه کد آماده پایین همین صفحه است. کدش رو توی صفحه HTML بذار و مطمئن شو فایل ها از مسیر درست بارگذاری می شن. اگه پروژه ات با npm مدیریت می شه، بسته رو با نام @cap.js/wasm بهش اضافه کن.

قدم های کلی کار اینه:

  • اول مستندات Cap رو بخون و ببین این بسته توی کدوم قسمت معماری قرار می گیره.
  • سمت سرور، Cap رو راه بنداز تا چالش بسازه و جواب ها رو بررسی کنه.
  • سمت کاربر، ویجت یا کد خودت رو جوری تنظیم کن که برای حل چالش از این حل کننده WASM استفاده کنه.
  • فرم رو تست کن و ببین حل چالش توی مرورگرهای مختلف درست جواب می ده.
  • یه بار هم روی یه گوشی معمولی امتحان کن. اگه کند بود، سختی چالش رو کمتر کن.

اگه سایتت وردپرسیه، یادت باشه این بسته افزونه آماده نیست. یه توسعه دهنده باید اون رو توی قالب یا یه افزونه سفارشی وصل کنه و فرم هات رو به سرور Cap ربط بده. بعد از راه اندازی، سرعت پاسخ سرور و لاگ خطاها رو هم نگاه کن تا چالش ها بی دلیل رد نشن.

همه نسخه‌ها (۵)

نسخه‌های ۰.x ۵ نسخه
  • ۰.۰.۸ آخرین نسخه ۶۳ کیلوبایت·
    دانلودنسخه 0.0.8
    نشانی مستقیم فایل اصلی 0.0.8 https://mirror.wbweb.ir/npm/@cap.js/wasm@0.0.8/node/cap_wasm.js
  • ۰.۰.۷ ۵۱ کیلوبایت·
    دانلودنسخه 0.0.7
    نشانی مستقیم فایل اصلی 0.0.7 https://mirror.wbweb.ir/npm/@cap.js/wasm@0.0.7/node/cap_wasm.js
  • ۰.۰.۶ ۱۷۲ کیلوبایت·
    دانلودنسخه 0.0.6
    نشانی مستقیم فایل اصلی 0.0.6 https://mirror.wbweb.ir/npm/@cap.js/wasm@0.0.6/node/cap_wasm.js
  • ۰.۰.۵ ۱۷۶ کیلوبایت·
    دانلودنسخه 0.0.5
    نشانی مستقیم فایل اصلی 0.0.5 https://mirror.wbweb.ir/npm/@cap.js/wasm@0.0.5/node/cap_wasm.js
  • ۰.۰.۴ قدیمی‌ترین نسخه ۱۴۱ کیلوبایت·
    دانلودنسخه 0.0.4
    نشانی مستقیم فایل اصلی 0.0.4 https://mirror.wbweb.ir/npm/@cap.js/wasm@0.0.4/node/cap_wasm.js

پرسش‌های رایج

  • Cap یه جایگزین سبک و متن باز برای کپچاست که روی اثبات کار با SHA-256 ساخته شده. @cap.js/wasm فقط بخش حل کننده WebAssembly همین پروژه است و محاسبه چالش رو توی مرورگر انجام می ده. برای یه کپچای کامل، سرور Cap و ویجتش رو هم لازم داری، چون این بسته به تنهایی چالش نمی سازه.

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

  • بله، ولی این افزونه وردپرس نیست. یه کتابخانه جاوااسکریپته و باید توی قالب یا یه افزونه سفارشی به فرم ها وصل بشه. اگه می خوای فقط فعالش کنی و تموم، دنبال افزونه آماده ای بگرد که از Cap پشتیبانی کنه، یا کار رو به یه توسعه دهنده بسپار.

  • این مجوز معمولا استفاده تجاری و تغییر کد رو اجازه می ده، به شرطی که اطلاعیه مجوز و حق نشر رو نگه داری. چون جزئیاتش مهمه، قبل از استفاده توی پروژه مشتری متن کامل مجوز رو یه بار بخون. اگه شک داشتی، از یه مشاور حقوقی بپرس.

  • چون Cap خودمیزبانه و محاسبه توی مرورگر انجام می شه، به سرویس خارجی وابسته نیستی. فقط خود فایل های بسته باید دم دستت باشن. نسخه های رسمی و بدون تغییرش رو می تونی از مخزن داخلی ما هم بگیری و کنار پروژه ات روی هاست خودت بذاری.

چیزی که لازم دارید اینجا نیست؟

نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.