دفترچه راهنمای کامل Clean IP Scanner — از نصب تا شکار خودکار، WARP، تلگرام و عیب‌یابی؛ قدم‌به‌قدم و مصور.The complete illustrated handbook for Clean IP Scanner — from installation to automated hunting, WARP, Telegram and troubleshooting, step by step.
همین حالا اسکنر را اجرا کنLaunch the scanner right now
دموی آفلاین اسکنر — رابط کاربری کامل با دادهٔ نمونه، همین‌جا در مرورگر تو. برای اسکن زندهٔ واقعی، اپ را روی سیستم خودت اجرا کن.The scanner's offline demo — the full UI with sample data, right here in your browser. For real live scanning, run the app on your own machine.
دمو کاملاً آفلاین و خصوصی است — هیچ داده‌ای ارسال نمی‌شود؛ موتور اسکن فقط در اجرای محلی فعال می‌شود.The demo is fully offline and private — nothing is ever sent; the scan engine only runs when self-hosted.
همه‌چیز در یک جعبه‌ابزارEverything in one toolbox
اسکن زنده، شکار، زمان‌بندی، هشدار و خروجی — بدون هیچ سرویس ابری.Live scan, hunt, schedule, notify and export — with zero cloud services.
📡
اسکنر زندهLive scanner
اسکن تأخیر TCP/TLS با ماتریس پورت، سطوح تأیید و کنترل همزمانی.TCP/TLS latency scanning with a port matrix, verify levels and concurrency control.
منابع زنده (SPF، رنج API، RIPE…) با گزارش سلامت و دانش‌نامه داخلی.Live sources (SPF, API ranges, RIPE…) with health reports and a knowledge base.
⏱️
زمان‌بان شکارHunt scheduler
شکار دوره‌ای سمت سرور با ژورنال ماندگار و بازتاب تنظیمات هر اجرا.Server-side recurring hunts with a persisted journal and per-fire settings echo.
🛡️
اسکنر WARPWARP scanner
پروب اندپوینت‌های کلادفلر WARP با نرخ زنده‌بودن و تاریخچه.Cloudflare WARP endpoint probing with alive-rate and history.
✈️
خلاصه تلگرامTelegram digests
گزارش دستی یا خودکار با پیوست CSV ژورنال برای اجراهای زمان‌بندی‌شده.Manual or auto-on-finish reports, auto-attaching the journal CSV for scheduled runs.
🗂️
تاریخچه و CSVHistory & CSV
جست‌وجو، فیلتر، بازه‌های زمانی و خروجی CSV تک‌کلیکی از هر جدول.Search, filter, time ranges and one-click CSV export from every table.
🌐
دوزبانهٔ کاملFully bilingual
انگلیسی پیش‌فرض با چیدمان LTR؛ فارسی راست‌به‌چپ با یک کلیک — انتخاب شما ذخیره می‌شود.English-first with LTR layout; full RTL Persian one click away — your choice is remembered.
01
فصل اولChapter 1
کلین آی‌پی اسکنر چیست؟What is Clean IP Scanner?
یک ابزار وب کاملاً محلی برای پیدا کردن IPهای «پاک» — یعنی IPهایی که سریع‌اند، پاسخ می‌دهند و برای عبور از فیلترینگ یا اتصال به سرویس‌های CDN مناسب‌اند. همه‌چیز روی سیستم خودت اجرا می‌شود: دیتابیس لوکال است، اسکن لوکال است و هیچ داده‌ای جایی ارسال نمی‌شود.A fully local web tool for finding clean IPs — fast, responsive addresses that work well with CDNs and circumvention setups. Everything runs on your machine: the database, the scans, the scheduler. Nothing ever leaves your box.
رابط کاربری دوزبانه است (انگلیسی پیش‌فرض و فارسی راست‌به‌چپ با یک کلیک) و موتور اسکن یک سرویس مستقل Bun است که با socket.io به رابط وصل می‌شود — به همین دلیل پیشرفت اسکن در لحظه و بدون رفرش دیده می‌شود.The UI is bilingual (English by default, full RTL Persian one click away), and the scan engine is a standalone Bun service connected via socket.io — that is why scan progress streams live, without refresh.
💡 نکته💡 Tip«IP پاک» یعنی کمتر گزارش‌شده و کمتر بلاک‌شده — ابزار با تأخیر و سرعت دانلود واقعی آن را رتبه‌بندی می‌کند.A “clean” IP is one that is less flagged and less blocked — the tool ranks candidates by real latency and download speed.
02
فصل دومChapter 2
نصب و راه‌اندازی در ۴ قدمSetup in four steps
پیش‌نیاز فقط Bun نسخه ۱.۱ به بالاست. مخزن را کلون کنید و چهار دستور زیر را اجرا کنید:The only prerequisite is Bun 1.1+. Clone the repo and run the four commands below:
1 · clone & install
git clone https://github.com/CheginiSoroush/clean-ip-scanner.git
cd clean-ip-scanner
bun install
2 · database (SQLite + Prisma)
bun run db:push
3 · web app → :3000
bun run dev
4 · scan engine → :3003
cd mini-services/scan-service
./run.sh
⚠️ مهم⚠️ Importantموتور اسکن باید روشن بماند؛ اگر خاموش شود رابط کاربری حالت «قطع» را نشان می‌دهد و اسکن شروع نمی‌شود.Keep the engine running; if it is down the UI shows a “disconnected” state and scans will not start.
03
فصل سومChapter 3
اولین اسکن زندهYour first live scan
پریست CDN را انتخاب کنیدPick a CDN preset«کلادفلر» برای شروع بهترین است (۱.۵M+ آی‌پی). می‌توانید رنج‌های CIDR سفارشی را با پریست ترکیب کنید.“Cloudflare” is the best starting point (1.5M+ IPs). Custom CIDR ranges can be mixed with any preset.
پورت و تنظیمات را تعیین کنیدSet port & tuningپورت پیش‌فرض ۴۴۳ است. «تعداد پینگ»، «تایم‌اوت»، «همزمانی» و «حداکثر IP» را متناسب با شبکه خودتان تنظیم کنید.Default port is 443. Tune ping count, timeout, concurrency and max IPs to match your network.
اسکن را شروع کنیدStart the scanنوار پیشرفت، لاگ زنده موتور و شمارنده‌ها را همان لحظه در داشبورد می‌بینید.Watch the progress bar, live engine log and counters update in real time.
تست سرعت و رتبه‌بندیSpeed test & rankingIPهای پاسخگو به‌طور خودکار تست سرعت می‌شوند و در جدول «بهترین‌ها» رتبه می‌گیرند.Alive IPs are speed-tested automatically and ranked in the “best” table.
داشبورد اسکن زنده — آمار کلی، پیکربندی و لاگ موتورLive scan dashboard — stats, configuration and engine log
میانبرهای صفحه‌کلید:Keyboard shortcuts:
1–6تب‌هاtabsFتمرکز روی رنجfocus rangesEscبستن دیالوگclose dialog
04
فصل چهارمChapter 4
شکارچی گوگل و زمان‌بان شکارGoogle hunter & hunt scheduler
شکارچی IP گوگل رنج‌های رو‌به‌گوگل را از منابع زنده جمع می‌کند: رکوردهای SPF، رنج‌های API، اسنپ‌شات‌های RIPE و… . سلامت هر منبع گزارش می‌شود و نتایج در «دانش‌نامه» ذخیره می‌ماند تا اسکن‌های بعدی سریع‌تر شوند.The Google IP hunter collects Google-facing ranges from live sources: SPF records, API ranges, RIPE snapshots and more. Source health is reported and results persist in a knowledge base, making later hunts faster.
زمان‌بان شکار اجازه می‌دهد شکار به‌صورت دوره‌ای و سمت سرور اجرا شود. هر اجرا در «ژورنال» ثبت می‌شود و یک بازتاب تنظیمات فشرده (پروایدور، هدف، دسته، همزمانی، host:port، سرعت، سطح تأیید) کنار نتیجه می‌ماند — حتی بعد از ری‌استارت.The hunt scheduler runs hunts periodically on the server side. Every fire is recorded in the journal with a compact settings echo (provider, target, batch, concurrency, host:port, speed, verify) — persisted across restarts.
💡 ترفند💡 Pro tipژورنال اجراها را می‌توانید با یک کلیک به CSV ببرید و در اکسل تحلیل کنید.Export the run journal to CSV with one click and analyze it in your spreadsheet.
05
فصل پنجمChapter 5
اسکنر WARPWARP scanner
در تب WARP می‌توانید اندپوینت‌های کلادفلر WARP را پروب کنید: نرخ زنده‌بودن، تأخیر و تاریخچه هر دسته پروب ذخیره می‌شود تا روند سلامت شبکه‌تان را ببینید.The WARP tab probes Cloudflare WARP endpoints: alive-rate, latency and full history per probe batch are stored so you can watch your network’s trend.
تب WARP با تاریخچه و خروجی CSVWARP tab with history and CSV export
⚠️ محیطی⚠️ Environmentalاگر شبکه‌تان UDP را بسته باشد، نرخ زنده‌بودن صفر نشان داده می‌شود — این محدودیت شبکه است، نه باگ ابزار.If your network blocks UDP, the alive-rate will read zero — that is a network restriction, not a bug.
06
فصل ششمChapter 6
تلگرام و DDNS کلادفلرTelegram & Cloudflare DDNS
در تب یکپارچه‌سازی، توکن ربات و شناسه چت را وارد کنید تا خلاصه نتایج به تلگرام‌تان برسد — دستی یا خودکار پس از پایان هر اسکن. اجراهای زمان‌بندی‌شده به‌طور خودکار CSV ژورنال را هم پیوست می‌کنند.In the Integrations tab, enter your bot token and chat ID to receive result digests — manually or automatically after each scan. Scheduled runs auto-attach the journal CSV via sendDocument.
DDNS کلادفلر هم بهترین IP پاک را مستقیم روی رکورد A دامنه‌تان می‌گذارد؛ دستی یا خودکار با آستانه حداقل IP.Cloudflare DDNS pushes the best clean IP straight to your domain’s A record — manually, or automatically with a minimum-IP threshold.
تب یکپارچه‌سازی — تلگرام و DDNSIntegrations tab — Telegram and DDNS
07
فصل هفتمChapter 7
تاریخچه، علاقه‌مندی‌ها و خروجی CSVHistory, favorites & CSV export
تاریخچه اسکن‌ها با جست‌وجو، فیلتر و مرتب‌سازی + بازه‌های «۲۴ ساعت / ۷ روز / همه»Scan history with search, filter and sort + 24h / 7d / all range chips
علاقه‌مندی‌ها با بررسی سلامت دوره‌ای IPهای منتخبFavorites with periodic health checks of your picked IPs
خروجی CSV از سه جدول: تاریخچه شکار، WARP و ژورنال زمان‌بان (با BOM سازگار با اکسل)CSV export from three tables: hunt history, WARP and the scheduler journal (Excel-friendly BOM)
همه‌چیز در SQLite محلی — پشتیبان‌گیری فقط کپی یک فایل استAll in local SQLite — backing up is copying one file
تب تاریخچه اسکن‌هاScan history tab
08
فصل هشتمChapter 8
عیب‌یابی و سؤالات پرتکرارTroubleshooting & FAQ
عیب‌یابی
Troubleshooting
Symptom
Fix
UI shows “disconnected”
Start the engine: cd mini-services/scan-service && ./run.sh
Scan returns nothing
Lower concurrency, raise timeout, try another port (443 → 2053/2083/2087)
Telegram: 502 Unauthorized
Bot token is invalid — regenerate from @BotFather and re-enter chat ID
WARP alive-rate = 0
UDP is blocked on your network — environmental, not a bug
Database errors on boot
Run bun run db:push again
سؤالات پرتکرار
Frequently asked
آیا داده‌هایم به سروری ارسال می‌شود؟Is my data sent anywhere?
نه. اسکن، دیتابیس و زمان‌بان همگی لوکال‌اند؛ فقط اگر خودتان تلگرام را پیکربندی کنید گزارش‌ها به ربات خودتان می‌روند.No. Scans, the database and the scheduler are all local; only if you configure Telegram yourself do digests go to your own bot.
تفاوت «اسکن» و «شکار» چیست؟Scan vs hunt — what is the difference?
اسکن، رنج‌های یک پریست CDN را بررسی می‌کند؛ شکار، رنج‌های رو‌به‌گوگل را از منابع زنده می‌یابد و برای همان‌ها اسکن می‌چیند.A scan probes a CDN preset’s ranges; a hunt discovers Google-facing ranges from live sources and builds scans on top of them.
روی ویندوز / مک کار می‌کند؟Does it run on Windows / macOS?
بله — هر دو بخش روی Bun اجرا می‌شوند که برای هر سه سیستم‌عامل نسخه دارد.Yes — both parts run on Bun, which ships for all three platforms.
چطور از همه‌چیز پشتیبان بگیرم؟How do I back everything up?
فایل db/custom.db را کپی کنید — کل تاریخچه، تنظیمات و ژورنال همان‌جاست.Copy db/custom.db — all history, settings and the journal live there.
لایسنس چیست؟What is the license?
MIT — آزاد برای استفاده شخصی و تجاری با ذکر نام نویسنده.MIT — free for personal and commercial use with attribution.
→
جادهٔ آیندهRoadmap
چه چیزی در راه استWhat is next
v7.7 ✓نمودار کوچک روند زنده‌بودن WARP · بازه‌های زمانی سفارشی · دیالوگ جزئیات هر اجرا — همگی اعمال شدندWARP alive-rate sparkline · custom date ranges · per-fire detail dialog — all shipped
v7.8 ✓بازبینی کامل i18n سطوح v7 · نمودار روند امتیاز هر IP · درون‌ریزی/برون‌بری پریست وزن‌ها — همگی اعمال شدندv7-surface i18n audit · per-IP score sparkline · weight-preset import/export — all shipped
