نصب و راه‌اندازی WarpScanner 🚀¶

خب خوشگله، بریم صفحه راه‌اندازی و نصب WarpScanner رو با هم اوکی کنیم! 🎉 این ابزار برای پیدا کردن بهترین آی‌پی‌های WARP (وایرگارد) برای پلتفرم‌های مختلف طراحی شده.

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

دریافت و نصب 📥¶

ویندوز 💻¶

لینوکس 🐧¶

• نصب سریع با اسکریپت (تحت ترمینال): این ساده‌ترین راه برای نصب روی اکثر توزیع‌های لینوکسه. ترمینال رو باز کن و دستور زیر رو بزن:

  bash <(curl -fsSL https://raw.githubusercontent.com/arshiacomplus/WarpScanner/main/install.sh)
  

• نسخه 64 بیتی: WarpScanner-v0.4.1-linux-64bit.tar.gz (نسخه: v0.4.1)

اندروید 📱¶

• مخزن اصلی نسخه اندروید: https://github.com/arshiacomplus/WarpScanner-android-GUI
• صفحه دانلودهای نسخه اندروید: https://github.com/arshiacomplus/WarpScanner-android-GUI/releases
• لینک دانلود مستقیم آخرین نسخه فعلی: WarpScanner_v0.1.2.apk (نسخه: v0.1.2)

راهنمای استفاده و توضیح بخش‌ها 🧭¶

حالا که برنامه رو گرفتی، بیا ببینیم چطور باید باهاش کار کنی و هر بخش چیکار می‌کنه.

تب اصلی (Main) 🏠¶

این تب، صفحه شروع و قلب تپنده برنامه برای اسکن آی‌پی‌هاست.

• بالای صفحه: اینجا نسخه‌های IP که در دسترس هستن (مثلاً IPv4, IPv6) رو نشون میده. با زدن دکمه Check می‌تونی دوباره وضعیتشون رو بررسی کنی.
• وسط صفحه: یه کادر متنی (Text View) بزرگ هست که نتایج اسکن (آی‌پی‌های پیدا شده) اینجا لیست میشن.
• زیر کادر نتایج: دو تا گزینه رادیویی (Radio Button) برای تعیین حالت عملیات وجود داره:
  • ip scanning: (حالت پیش‌فرض) برنامه فقط آی‌پی‌ها رو اسکن می‌کنه و نتایج رو نمایش میده/ذخیره می‌کنه.
  • get wireguard: برنامه علاوه بر اسکن آی‌پی، سعی می‌کنه با استفاده از آی‌پی‌های سالم پیدا شده، کانفیگ‌های وایرگارد کامل تولید کنه.
• دکمه‌های عملیاتی (پایین صفحه):
  • IPv4: با زدن این دکمه، اسکن برای پیدا کردن آی‌پی‌های سالم وایرگارد نسخه 4 شروع میشه.
  • IPv6: با زدن این دکمه، اسکن برای پیدا کردن آی‌پی‌های سالم وایرگارد نسخه 6 شروع میشه.
  • Clean: این گزینه نتایج نمایش داده شده در کادر متنی رو بر اساس تنظیماتی که کردی (مثل فرمت پنل یا محدوده پینگ) مرتب و تمیز می‌کنه و برای خروجی گرفتن آماده می‌کنه.

منوی تنظیمات (Settings) ⚙️¶

تو صفحه اصلی، یه دکمه منو (معمولاً سه خط یا چرخ‌دنده) هست. با کلیک روی اون و انتخاب گزینه Settings، می‌تونی تنظیمات مختلف برنامه رو تغییر بدی:

• Scan Speed (سرعت اسکن):
  • Faster: اسکن سریع‌تر انجام میشه، ولی ممکنه منابع بیشتری از سیستمت (CPU, RAM) رو مصرف کنه.
  • Slower: اسکن با سرعت کمتر و مصرف منابع بهینه‌تر انجام میشه.
• Save Result (ذخیره نتایج):
  • Yes: نتایج اسکن به صورت خودکار توی فایلی به اسم result.txt کنار فایل اجرایی برنامه (.exe در ویندوز یا فایل اجرایی لینوکس) ذخیره میشه.
  • No: نتایج اسکن به صورت خودکار ذخیره نمیشن.

  برای اندروید

  تو پوشه download/wwarpscanner ذخیره میشن

• Which Panel (نوع ذخیره / برای کدام پنل): مشخص می‌کنه نتایج اسکن تو فایل result.txt با چه فرمتی ذخیره بشن:
  • bpb: آی‌پی‌ها با ویرگول (,) از هم جدا میشن.
  • vahid: آی‌پی‌ها با اینتر (رفتن به خط جدید) از هم جدا میشن.
  • with score: آی‌پی‌ها به همراه جزئیاتشون مثل پکت لاس، پینگ، جیتر و... ذخیره میشن.
• First Tab (تب پیش‌فرض): مشخص می‌کنه موقع باز کردن برنامه، کدوم تب اول نمایش داده بشه:
  • Main: تب اصلی (اسکن) اول باز بشه.
  • VPN: تب VPN اول باز بشه.
• Theme (پوسته): ظاهر برنامه رو می‌تونی تغییر بدی:
  • System: از پوسته پیش‌فرض سیستم‌عاملت استفاده می‌کنه.
  • Dark: پوسته تیره (مشکی/خاکستری).
  • Light: پوسته روشن (سفید).

  نیاز به راه‌اندازی مجدد

  بعد از تغییر پوسته، باید برنامه رو ببندی و دوباره باز کنی تا تغییرات اعمال بشه.

• Save with Port (ذخیره با پورت):
  • Yes: آی‌پی‌ها همراه با پورت‌شون ذخیره میشن (مثلاً 1.1.1.1:8080).
  • No: آی‌پی‌ها بدون پورت ذخیره میشن (مثلاً 1.1.1.1).
• Which API (کدام API): برای دریافت کلید وایرگارد از کدوم منبع استفاده بشه:
  • API 1: (غیرفعال) فعلاً از کار افتاده و کار نمی‌کنه. 🤷‍♂️
  • API 2: (پیشنهادی) بهتره روی این گزینه باشه.
• Sing-box Format (فرمت سینگ‌باکس): برای سازگاری با کلاینت‌های سینگ‌باکس:
  • Singbox Hiddify (old): با نسخه‌های قدیمی Hiddify و Sing-box کار می‌کنه.
  • Just Hiddify (new): فقط برای Hiddify ورژن جدید کار می‌کنه.
• V2ray Formats (فرمت V2ray): برای سازگاری با کلاینت‌های V2ray:
  • V2rayN pro (old): برای ورژن جدید V2rayN pro.
  • V2ray pro (new): برای ورژن قدیم V2rayN pro.
• Ping Range (محدوده پینگ): یه کادر متنی که توش یه عدد وارد می‌کنی. فقط آی‌پی‌هایی که پینگشون از 0 تا این عدد باشه، تو نتایج (result.txt و تب Table) نمایش داده و ذخیره میشن.
• <Advanced> (تنظیمات پیشرفته اسکن): اینجا تنظیمات دقیق‌تری برای فرآیند اسکن ICMP (پینگ) وجود داره:
  • Icmp timeout: حداکثر زمان انتظار (به میلی‌ثانیه) برای دریافت پاسخ پینگ از یک آی‌پی. هرچی کمتر باشه، سریع‌تر سراغ آی‌پی بعدی میره، ولی ممکنه آی‌پی‌هایی که دیر جواب میدن رو از دست بدی.
  • icmp_ping_count: تعداد پکت‌های پینگی که برای هر آی‌پی ارسال میشه. اگه اسکن دقیق‌تری می‌خوای، این عدد رو بیشتر کن (پیش‌فرض 2 هست، حداکثر تا 10 معمولاً کافیه). پکت لاس (Packet Loss) درصد پکت‌های ارسال شده‌ای هست که جوابی براشون دریافت نشده.
  • icmp_interval: فاصله زمانی (به ثانیه) بین ارسال هر پکت پینگ برای یک آی‌پی خاص. معمولاً همون مقدار پیش‌فرض (مثلاً 1) مناسبه.
• Config Ping (پینگ با کانفیگ وایرگارد): یه دکمه خاموش/روشن (On/Off) و یه کادر متنی زیرش. اگه این گزینه رو فعال کنی (On), باید یه کانفیگ وایرگارد کامل داخل کادر متنی وارد کنی. برنامه فقط به جای استفاده از پینگ ICMP معمولی، از طریق این کانفیگ وایرگارد، اتصال به آی‌پی‌های پیدا شده رو تست می‌کنه تا وضعیت واقعی‌تری ازشون بدست بیاره.

تب VPN 🛡️ (ویندوز)¶

این تب برای مدیریت اتصال VPN از طریق خود برنامه (با استفاده از هسته‌های داخلی مثل Xray) کاربرد داره.

• دکمه اتصال: یه دکمه بزرگ وسط صفحه برای وصل شدن (Connect) یا قطع شدن (Disconnect) اتصال VPN.
• اطلاعات اتصال: بعد از اینکه وصل شدی، معمولاً پینگ و لوکیشن (اگه قابل تشخیص باشه) زیر دکمه نمایش داده میشه. اگه روی متن پینگ کلیک کنی، دوباره پینگ گرفته میشه.
• تنظیمات VPN (منوی کشویی): زیر اطلاعات اتصال، یه منوی کشویی (Dropdown) هست که تنظیمات پیشرفته VPN رو دسته‌بندی کرده:
  • Fragment Settings: تنظیمات مربوط به تکه‌تکه کردن بسته‌ها (Fragmentation) برای کمک به عبور از فیلترینگ. شامل گزینه‌هایی مثل: Packets, Length, Interval, Fake Host, Mux.
  • WireGuard Config Setting: تنظیمات مربوط به Chain کردن (زنجیر کردن) کانفیگ‌های وایرگارد (مثل پیاده‌سازی Warp on Warp).
  • VPN Setting: تنظیمات کلی VPN. شامل گزینه‌هایی مثل: Local Dns, Fake Dns, Local Dns Port, Allow Insecure (شاید AllowInsecure?), Sniffing.
  • Routing Setting: تنظیمات مسیریابی ترافیک (برای مشخص کردن چه ترافیکی از VPN عبور کنه و چه ترافیکی مستقیم بره). شامل گزینه‌هایی مثل: Domain Strategy, Proxy URL or IP, Direct URL or IP, Blocked URL or IP.
  • Advanced Setting: تنظیمات پیشرفته‌تر مربوط به پراکسی سیستم و DNS و لاگ. شامل گزینه‌هایی مثل: Socks5 Proxy Port, Http Proxy Port, Remote Dns, Domestic Dns, Log Level, Ping Test Link.

تب Configs ⚙️ (ویندوز)¶

اینجا جاییه که می‌تونی کانفیگ‌های VPN خودت (مثل Vmess, Vless, WireGuard و...) و لینک‌های اشتراک (Subscription Links یا "ساب لینک") رو مدیریت کنی.

• بالای صفحه:
  • دکمه Add (+): برای اضافه کردن کانفیگ جدید. می‌تونی یک یا چند کانفیگ رو از کلیپ‌بورد یا فایل اضافه کنی، یا یه لینک اشتراک (ساب لینک) وارد کنی.
  • منوی کشویی (Dropdown): لیست ساب‌لینک‌هایی که اضافه کردی رو نشون میده. با انتخاب هر کدوم، کانفیگ‌های داخل اون ساب‌لینک نمایش داده میشن.
  • دکمه Delete (سطل زباله): تمام کانفیگ‌های داخل ساب‌لینک انتخاب شده رو پاک می‌کنه.
  • دکمه Update (چرخش 🔄): این دکمه فقط برای ساب‌لینک‌هایی که خودت اضافه کردی (و جزو دو مخزن اصلی پیش‌فرض نیستن) نمایش داده میشه. با زدنش، برنامه دوباره میره و کانفیگ‌های اون ساب‌لینک رو از سرور آپدیت می‌کنه.
• لیست کانفیگ‌ها: کانفیگ‌های داخل ساب‌لینک انتخاب شده، به صورت کارت‌های جداگانه زیر هم نشون داده میشن.
  • عملیات روی کارت: روی هر کارت کانفیگ، معمولاً سه تا آیکون یا دکمه وجود داره: یکی برای پاک کردن (Delete) اون کانفیگ، یکی برای ویرایش (Edit) اسم یا جزئیاتش، و یکی برای کپی کردن (Copy) کانفیگ تو کلیپ‌بورد.
  • نمایش پینگ با دوبار کلیک: اگه روی کارت یه کانفیگ دوبار کلیک کنی، برنامه از اون کانفیگ پینگ می‌گیره و نتیجه (عدد پینگ) رو روی همون کارت نمایش میده و ذخیره می‌کنه.
  • نمایش پرچم کشور: اگه توی اسم کانفیگ (معمولاً بعد از # یا تو بخش remarks) از فرمت >>{کد کشور} استفاده کنی (بدون فاصله)، برنامه پرچم اون کشور رو روی کارت کانفیگ نشون میده.
    • مثال:

      #remarks>>US
      

• پایین صفحه:
  • دکمه Sort: کانفیگ‌های نمایش داده شده در لیست رو بر اساس پینگشون (از کم به زیاد) مرتب می‌کنه.
  • دکمه Ping: از تمام کانفیگ‌هایی که در حال حاضر تو لیست (مربوط به ساب‌لینک انتخاب شده) نمایش داده میشن، پینگ می‌گیره و نتایج رو روی کارت‌هاشون آپدیت می‌کنه.

تب Table 📊¶

بعد از اینکه تو تب Main اسکن آی‌پی رو انجام دادی، این تب به صورت خودکار 10 تا از بهترین آی‌پی‌های پیدا شده (معمولاً بر اساس کمترین پینگ و شاید پکت لاس) رو توی یه جدول مرتب نشون میده.

• کپی کردن آی‌پی: با دوبار کلیک روی هر ردیف از این جدول، آی‌پی مربوط به اون ردیف توی کلیپ‌بوردت کپی میشه تا بتونی راحت ازش تو کانفیگ‌هات یا برنامه‌های دیگه استفاده کنی.