Add embedded Iranian resolver data and two-mode local command

Embed 7,854 known local DNS resolvers and 1,919 CIDR ranges directly
in the binary so it works offline (GitHub is blocked in Iran).

- `findns local -o file.txt` exports pre-verified resolvers (default)
- `findns local -o file.txt --discover` scans Iran's full IP space
- Discovery supports --sample, --batch/--offset, --full sub-modes
- `fetch --local` now uses known resolvers instead of CIDR candidates
- Updated all docs (README, GUIDE, guide-fa, guide-telegraph)

Author: SamNet-dev

GUIDE.md

@@ -212,7 +212,7 @@ findns fetch -o resolvers.txt
 
 این دستور از منبع trickest/resolvers حدود **17,000+** آی‌پی resolver عمومی را دانلود می‌کند.
 
-### دانلود با resolverهای ایران (محلی)
+### دانلود با resolverهای ایرانی (--local)
 
 </div>
 
@@ -222,10 +222,14 @@ findns fetch -o resolvers.txt --local
 
 <div dir="rtl">
 
-این دستور علاوه بر resolverهای جهانی، **7,800+** آی‌پی resolver ایرانی/منطقه‌ای از ir-resolvers را هم اضافه می‌کند. مجموعاً حدود **25,000+** resolver.
+این دستور علاوه بر resolverهای جهانی، **7,800+ resolver شناخته‌شده ایرانی** را هم به لیست اضافه می‌کند. این resolverها از قبل تأیید شده‌اند (منبع: ir-resolvers) و نرخ موفقیت بالایی در اسکن دارند.
+
+> **نکته مهم:** فلگ `--local` به هیچ سرور خارجی وصل نمی‌شود. لیست resolverهای ایرانی **داخل خود برنامه** ذخیره شده‌اند (embedded). حتی اگر GitHub فیلتر باشد، این فلگ کار می‌کند.
 
 > **چرا resolverهای ایرانی مهم هستند؟** در شبکه ایران، resolverهای داخلی معمولاً سریع‌تر جواب می‌دهند و ممکن است محدودیت کمتری داشته باشند.
 
+> **برای پیدا کردن resolverهای جدید** که در لیست شناخته‌شده نیستند، از دستور [`findns local --discover`](#دستور-local---resolverهای-ایرانی-داخلی) استفاده کنید.
+
 ### دانلود resolverهای DoH
 
 </div>
@@ -242,6 +246,133 @@ findns fetch -o doh-resolvers.txt --doh
 
 ---
 
+## دستور local - resolverهای ایرانی داخلی
+
+دستور `local` داده‌های ایرانی **داخل خود برنامه** را خروجی می‌دهد — نیازی به اینترنت ندارد. دو حالت دارد:
+
+### حالت 1: resolverهای شناخته‌شده (پیش‌فرض — پیشنهادی)
+
+بدون هیچ فلگ اضافه، **7,800+ resolver ایرانی از قبل تأیید‌شده** را خروجی می‌دهد (منبع: ir-resolvers). این resolverها قبلاً بررسی شده‌اند و نرخ موفقیت بالایی دارند.
+
+</div>
+
+```bash
+# خروجی resolverهای شناخته‌شده (پیشنهادی — سریع‌ترین راه)
+findns local -o resolvers.txt
+
+# اسکن کنید:
+findns scan -i resolvers.txt -o results.json --domain t.mysite.com
+```
+
+<div dir="rtl">
+
+> **این بهترین نقطه شروع است.** چون این آی‌پی‌ها واقعاً DNS resolver هستند، اکثرشان در اسکن پاس می‌شوند.
+
+### حالت 2: کشف resolver جدید (--discover)
+
+اگر می‌خواهید resolverهایی پیدا کنید که در لیست شناخته‌شده **نیستند**، از `--discover` استفاده کنید. این حالت از **1,919 رنج CIDR ایرانی** (منبع: RIPE NCC، ~10.8 میلیون آی‌پی) استفاده می‌کند.
+
+> **مهم:** این آی‌پی‌ها **resolver نیستند!** فقط کاندید هستند. اکثرشان DNS server نیستند و در اسکن فیل می‌شوند. این حالت برای **کشف** resolverهای جدید است.
+
+#### نمونه‌گیری — Sample (پیش‌فرض discover)
+
+از هر subnet تعدادی آی‌پی **تصادفی** انتخاب می‌کند. سریع است و پوشش خوبی می‌دهد.
+
+</div>
+
+```bash
+# پیش‌فرض: 10 آی‌پی تصادفی از هر subnet (~19,000 آی‌پی)
+findns local -o candidates.txt --discover
+
+# 5 آی‌پی از هر subnet (سریع‌تر، ~9,500 آی‌پی)
+findns local -o candidates.txt --discover --sample 5
+
+# 50 آی‌پی از هر subnet (کندتر، ~95,000 آی‌پی)
+findns local -o candidates.txt --discover --sample 50
+
+# بعد از تولید لیست، اسکن کنید:
+findns scan -i candidates.txt -o results.json --domain t.mysite.com
+```
+
+<div dir="rtl">
+
+#### دسته‌ای — Batch (اسکن تدریجی)
+
+اگر می‌خواهید **همه** آی‌پی‌ها را اسکن کنید ولی یکجا نه — مثلاً هر بار 1 میلیون آی‌پی — از batch استفاده کنید.
+
+**هر دسته رنج متفاوتی دارد و هیچ آی‌پی تکراری بین دسته‌ها وجود ندارد.** برنامه بعد از هر دسته دقیقاً می‌گوید دستور بعدی چیست.
+
+</div>
+
+```bash
+# دسته اول: آی‌پی شماره 1 تا 1,000,000
+findns local -o batch1.txt --discover --batch 1000000
+
+# برنامه در خروجی می‌گوید:
+#   next batch command:
+#     findns local -o <next-file>.txt --discover --batch 1000000 --offset 1000000
+#   remaining: 9,815,490 IPs
+
+# دسته دوم: آی‌پی شماره 1,000,001 تا 2,000,000
+findns local -o batch2.txt --discover --batch 1000000 --offset 1000000
+
+# هر دسته را جداگانه اسکن کنید:
+findns scan -i batch1.txt -o results1.json --domain t.mysite.com
+findns scan -i batch2.txt -o results2.json --domain t.mysite.com
+```
+
+<div dir="rtl">
+
+> **نکته:** هر دسته آی‌پی‌های **جدید و متفاوت** تولید می‌کند. لازم نیست نگران اسکن مجدد باشید — `--offset` تضمین می‌کند هیچ آی‌پی دو بار اسکن نشود.
+
+#### حالت کامل — Full
+
+تمام ~10.8 میلیون آی‌پی ایرانی را یکجا خروجی می‌دهد.
+
+</div>
+
+```bash
+findns local -o all-iran.txt --discover --full
+```
+
+<div dir="rtl">
+
+> **هشدار:** اسکن 10.8 میلیون آی‌پی **روزها** طول می‌کشد! پیشنهاد: به جای `--full` از `--batch 1000000` استفاده کنید.
+
+#### نمایش رنج‌ها (بدون تولید فایل)
+
+فقط لیست رنج‌های CIDR را ببینید. نیازی به `-o` ندارد:
+
+</div>
+
+```bash
+findns local --list-ranges
+```
+
+<div dir="rtl">
+
+### توضیح فلگ‌ها
+
+| فلگ | توضیح | پیش‌فرض |
+|-----|-------|---------|
+| `-o, --output` | مسیر فایل خروجی برای لیست آی‌پی‌ها. در تمام حالت‌ها **الزامی** است به جز `--list-ranges`. | — |
+| `--discover` | حالت کشف resolver جدید. بدون این فلگ، resolverهای شناخته‌شده خروجی داده می‌شوند. | `false` |
+| `--sample N` | **[discover]** از هر subnet چند آی‌پی تصادفی انتخاب شود. عدد بزرگ‌تر = پوشش بیشتر ولی اسکن کندتر. عدد `0` مثل `--full` عمل می‌کند. | `10` |
+| `--full` | **[discover]** تمام ~10.8 میلیون آی‌پی را خروجی بده. این فلگ `--sample` را نادیده می‌گیرد. | `false` |
+| `--batch N` | **[discover]** دقیقاً N آی‌پی خروجی بده. هر بار اجرا با `--offset` متفاوت، رنج جدیدی می‌دهد. هیچ آی‌پی تکراری نیست. | `0` (غیرفعال) |
+| `--offset N` | **[discover]** با `--batch` استفاده می‌شود. از آی‌پی شماره N شروع کن (0-indexed). برنامه بعد از هر دسته `--offset` بعدی را نشان می‌دهد. | `0` |
+| `--list-ranges` | فقط لیست رنج‌های CIDR ایرانی را چاپ کن و خارج شو. نیازی به `-o` ندارد. | `false` |
+
+### اولویت فلگ‌ها
+
+- بدون `--discover` → resolverهای شناخته‌شده (7,800+)
+- اگر `--list-ranges` داده شود → فقط رنج‌ها چاپ می‌شود، بقیه فلگ‌ها نادیده گرفته می‌شوند
+- اگر `--discover --batch` > 0 باشد → حالت دسته‌ای فعال می‌شود (`--sample` و `--full` نادیده گرفته می‌شوند)
+- اگر `--discover --full` داده شود → تمام آی‌پی‌ها (`--sample` نادیده گرفته می‌شود)
+- اگر `--discover` بدون فلگ دیگر → حالت نمونه‌گیری با `--sample N`
+
+---
+
 ## 4. اسکن کامل (scan) - دستور اصلی
 
 دستور scan مهم‌ترین و پیشنهادی‌ترین دستور است. تمام مراحل تست را به ترتیب اجرا می‌کند و فقط resolverهایی که همه مراحل را پاس کنند در خروجی نهایی می‌آیند.

README.md

@@ -162,7 +162,7 @@ Use `.\findns.exe` instead of `./scanner` in all commands:
 # 📥 Download global UDP resolvers
 ./scanner fetch -o resolvers.txt
 
-# 🌍 Include regional intranet resolvers
+# 🌍 Include 7,800+ known regional resolvers (embedded, offline)
 ./scanner fetch -o resolvers.txt --local
 
 # 🔒 Download DoH resolver URLs
@@ -237,7 +237,7 @@ Automatically downloads and deduplicates resolver lists from public sources.
 # Global UDP resolvers (from trickest/resolvers)
 ./scanner fetch -o resolvers.txt
 
-# Include regional intranet resolvers (7,800+ IPs)
+# Include 7,800+ known regional resolvers (embedded, no download needed)
 ./scanner fetch -o resolvers.txt --local
 
 # DoH resolver URLs (19+ well-known + public lists)
@@ -252,6 +252,41 @@ Automatically downloads and deduplicates resolver lists from public sources.
 
 ---
 
+### 🌍 `local` — Export Bundled Regional Data
+
+Export regional resolver data bundled inside the binary. No internet connection needed.
+
+**Two modes:**
+
+```bash
+# Mode 1: Known resolvers (default, recommended)
+# Exports 7,800+ pre-verified regional DNS resolvers — high scan success rate
+./scanner local -o resolvers.txt
+
+# Mode 2: Discover NEW resolvers (--discover)
+# Exports candidate IPs from 1,919 CIDR ranges (~10.8M IPs)
+# Most will NOT be DNS servers — use this to find resolvers not in the known list
+./scanner local -o candidates.txt --discover
+
+# Discovery with batch scanning (non-overlapping, no duplicates)
+./scanner local -o batch1.txt --discover --batch 1000000
+./scanner local -o batch2.txt --discover --batch 1000000 --offset 1000000
+
+# Show embedded CIDR ranges
+./scanner local --list-ranges
+```
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--discover` | Switch to discovery mode (CIDR expansion) | `false` |
+| `--sample N` | [discover] Random IPs per subnet | `10` |
+| `--full` | [discover] Export all ~10.8M IPs | `false` |
+| `--batch N` | [discover] Export exactly N IPs (use with `--offset`) | `0` |
+| `--offset N` | [discover] Skip N IPs before starting batch | `0` |
+| `--list-ranges` | Print embedded CIDR ranges and exit | `false` |
+
+---
+
 ### 🏓 `ping` — ICMP Reachability
 
 ```bash
@@ -741,7 +776,7 @@ go build -o findns.exe ./cmd
 # 📥 دانلود resolverهای UDP جهانی
 ./scanner fetch -o resolvers.txt
 
-# 🌍 شامل resolverهای محلی
+# 🌍 شامل 7,800+ resolver شناخته‌شده ایرانی (بدون اینترنت)
 ./scanner fetch -o resolvers.txt --local
 
 # 🔒 دانلود آدرس‌های DoH
@@ -814,14 +849,52 @@ go build -o findns.exe ./cmd
 
 ```bash
 ./scanner fetch -o resolvers.txt           # resolverهای UDP جهانی
-./scanner fetch -o resolvers.txt --local    # + resolverهای محلی
+./scanner fetch -o resolvers.txt --local    # + 7,800+ resolver شناخته‌شده ایرانی
 ./scanner fetch -o doh-resolvers.txt --doh # آدرس‌های DoH
 ```
 
 <div dir="rtl">
 
 ---
 
+### 🌍 `local` — resolverهای ایرانی داخلی
+
+داده‌های ایرانی داخل خود برنامه را خروجی می‌دهد — نیازی به اینترنت ندارد.
+
+**دو حالت:**
+
+</div>
+
+```bash
+# حالت 1: resolverهای شناخته‌شده (پیش‌فرض — پیشنهادی)
+# 7,800+ resolver تأیید‌شده — نرخ موفقیت بالا
+./scanner local -o resolvers.txt
+
+# حالت 2: کشف resolver جدید (--discover)
+# از رنج‌های CIDR ایرانی (~10.8M آی‌پی)
+./scanner local -o candidates.txt --discover
+
+# اسکن دسته‌ای (بدون تکرار)
+./scanner local -o batch1.txt --discover --batch 1000000
+./scanner local -o batch2.txt --discover --batch 1000000 --offset 1000000
+
+# نمایش رنج‌ها
+./scanner local --list-ranges
+```
+
+<div dir="rtl">
+
+| فلگ | توضیح |
+|-----|-------|
+| `--discover` | حالت کشف resolver جدید (از CIDR) |
+| `--sample N` | [discover] آی‌پی تصادفی از هر subnet (پیش‌فرض: 10) |
+| `--full` | [discover] تمام ~10.8M آی‌پی |
+| `--batch N` | [discover] دقیقاً N آی‌پی (با `--offset`) |
+| `--offset N` | [discover] رد کردن N آی‌پی اول |
+| `--list-ranges` | چاپ رنج‌های CIDR |
+
+---
+
 ### دستورات جداگانه
 
 | دستور | توضیح | متریک |

cmd/fetch.go

@@ -10,6 +10,7 @@ import (
 	"strings"
 	"time"
 
+	"github.com/SamNet-dev/findns/internal/data"
 	"github.com/spf13/cobra"
 )
 
@@ -21,7 +22,7 @@ var fetchCmd = &cobra.Command{
 
 func init() {
 	fetchCmd.Flags().StringP("output", "o", "resolvers.txt", "output file for merged resolver list")
-	fetchCmd.Flags().Bool("local", false, "include regional intranet resolvers from ir-resolvers")
+	fetchCmd.Flags().Bool("local", false, "include 7,800+ known Iranian resolvers (bundled, no download needed)")
 	fetchCmd.Flags().Bool("doh", false, "fetch DoH resolver URLs instead of UDP IPs")
 	rootCmd.AddCommand(fetchCmd)
 }
@@ -31,7 +32,6 @@ var udpResolverSources = []struct {
 	url  string
 }{
 	{"trickest/resolvers", "https://raw.githubusercontent.com/trickest/resolvers/main/resolvers.txt"},
-	{"ir-resolvers (local)", "https://raw.githubusercontent.com/net2share/ir-resolvers/main/resolvers.txt"},
 }
 
 var dohResolverSources = []struct {
@@ -100,11 +100,8 @@ func runFetch(cmd *cobra.Command, args []string) error {
 			fmt.Fprintf(os.Stderr, "  +%d DoH endpoints\n", added)
 		}
 	} else {
-		// Fetch UDP resolver IPs
+		// Fetch UDP resolver IPs from online sources
 		for _, src := range udpResolverSources {
-			if src.name == "ir-resolvers (local)" && !localMode {
-				continue
-			}
 			fmt.Fprintf(os.Stderr, "fetching %s...\n", src.name)
 			ips, err := fetchIPList(src.url)
 			if err != nil {
@@ -121,6 +118,24 @@ func runFetch(cmd *cobra.Command, args []string) error {
 			}
 			fmt.Fprintf(os.Stderr, "  +%d resolvers\n", added)
 		}
+
+		// Add known Iranian resolvers from bundled list
+		if localMode {
+			localIPs, err := data.IRResolvers()
+			if err != nil {
+				fmt.Fprintf(os.Stderr, "  warning: reading embedded resolvers: %v\n", err)
+			} else {
+				added := 0
+				for _, ip := range localIPs {
+					if _, exists := seen[ip]; !exists {
+						seen[ip] = struct{}{}
+						entries = append(entries, ip)
+						added++
+					}
+				}
+				fmt.Fprintf(os.Stderr, "  +%d known Iranian resolvers (bundled, no download needed)\n", added)
+			}
+		}
 	}
 
 	f, err := os.Create(output)