Skip to content

Commit ad41e84

Browse files
committed
Update docs: --edns flag is opt-in, add input dedup/inline comment docs
- Pipeline descriptions updated: edns step no longer automatic - --edns flag added to flags tables in README.md and GUIDE.md - Input format section: document inline comment stripping and deduplication
1 parent ee4bc57 commit ad41e84

2 files changed

Lines changed: 17 additions & 6 deletions

File tree

GUIDE.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -643,7 +643,9 @@ findns scan -i resolvers.txt -o results.json --domain t.example.com
643643

644644
<div dir="rtl">
645645

646-
مراحل: `ping -> resolve -> nxdomain -> edns -> resolve/tunnel`
646+
مراحل: `ping -> resolve -> nxdomain -> resolve/tunnel`
647+
648+
> **نکته:** برای اضافه کردن تست EDNS payload size از فلگ `--edns` استفاده کنید. با این فلگ: `ping -> resolve -> nxdomain -> edns -> resolve/tunnel`
647649
648650
### توضیح هر مرحله
649651

@@ -673,7 +675,9 @@ findns scan -i resolvers.txt -o results.json \
673675

674676
<div dir="rtl">
675677

676-
مراحل: `ping -> resolve -> nxdomain -> edns -> resolve/tunnel -> e2e/dnstt`
678+
مراحل: `ping -> resolve -> nxdomain -> resolve/tunnel -> e2e/dnstt`
679+
680+
> با `--edns`: `ping -> resolve -> nxdomain -> edns -> resolve/tunnel -> e2e/dnstt`
677681
678682
نیازمند: `dnstt-client` و `curl` در PATH. این مرحله واقعاً dnstt-client را اجرا می‌کند، یک تانل SOCKS می‌سازد و با curl از طریق آن تانل یک صفحه وب را باز می‌کند.
679683
- متریک: `e2e_ms` (کل زمان از شروع تا اتصال موفق)
@@ -727,6 +731,7 @@ findns scan -i doh-resolvers.txt -o results.json \
727731
| `--proxy-auth` | احراز هویت پروکسی SOCKS به صورت `user:pass` (برای تست e2e) ||
728732
| `--doh` | حالت DoH به جای UDP | `false` |
729733
| `--skip-ping` | رد کردن مرحله ping (مفید اگر ICMP مسدود باشد) | `false` |
734+
| `--edns` | فعال‌سازی تست سایز EDNS payload (اختیاری) | `false` |
730735
| `--skip-nxdomain` | رد کردن بررسی هایجک | `false` |
731736
| `--top` | تعداد نتایج برتر در خروجی ترمینال | `10` |
732737

@@ -1251,6 +1256,8 @@ https://dns.quad9.net/dns-query
12511256
8.8.8.8
12521257
1.1.1.1
12531258
9.9.9.9
1259+
8.8.8.8 # تکراری — به صورت خودکار حذف می‌شود
1260+
1.1.1.1 # کامنت اینلاین — حذف می‌شود و فقط آی‌پی استفاده می‌شود
12541261
# این یک کامنت است (نادیده گرفته می‌شود)
12551262
12561263
# رنج CIDR (به صورت خودکار باز می‌شود)
@@ -1260,6 +1267,8 @@ https://dns.quad9.net/dns-query
12601267

12611268
<div dir="rtl">
12621269

1270+
**حذف تکراری‌ها:** آی‌پی‌های تکراری به صورت خودکار حذف می‌شوند و تعداد تکراری‌ها در stderr گزارش می‌شود. **کامنت اینلاین:** هر چیزی بعد از ` #` (فاصله + #) از انتهای خط حذف می‌شود.
1271+
12631272
**پشتیبانی از CIDR:** رنج‌هایی مثل `1.2.3.0/24` به صورت خودکار به آی‌پی‌های تکی تبدیل می‌شوند (آدرس شبکه و broadcast حذف می‌شوند). این قابلیت برای اسکن بلوک‌های آی‌پی منطقه‌ای (مثل فایل‌های `iran-ipv4.cidrs`) بسیار مفید است. اگر تعداد آی‌پی‌ها بیش از 100,000 باشد هشدار نمایش داده می‌شود.
12641273

12651274
برای DoH:

README.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -213,17 +213,18 @@ Automatically chains the right scan steps based on your flags. This is the **rec
213213
findns scan -i resolvers.txt -o results.json --domain t.example.com
214214
```
215215

216-
**UDP mode pipeline:** `ping → resolve → nxdomain → edns → tunnel → e2e`
216+
**UDP mode pipeline:** `ping → resolve → nxdomain → tunnel → e2e` (add `--edns` for EDNS payload check)
217217
**DoH mode pipeline:** `doh/resolve → doh/tunnel → doh/e2e`
218218

219219
| Flag | Description | Default |
220220
|------|-------------|---------|
221-
| `--domain` | Tunnel domain (enables tunnel/edns/e2e steps) ||
221+
| `--domain` | Tunnel domain (enables tunnel/e2e steps) ||
222222
| `--pubkey` | DNSTT server public key (enables e2e test) ||
223223
| `--cert` | Slipstream cert path (enables Slipstream e2e) ||
224224
| `--test-url` | URL to fetch through tunnel for e2e test | `https://httpbin.org/ip` |
225225
| `--proxy-auth` | SOCKS proxy auth as `user:pass` (for e2e tests) ||
226226
| `--doh` | Scan DoH resolvers instead of UDP | `false` |
227+
| `--edns` | Include EDNS payload size check | `false` |
227228
| `--skip-ping` | Skip ICMP ping step | `false` |
228229
| `--skip-nxdomain` | Skip NXDOMAIN hijack check | `false` |
229230
| `--top` | Number of top results to display | `10` |
@@ -849,17 +850,18 @@ findns scan -i doh-resolvers.txt -o results.json \
849850

850851
به صورت خودکار مراحل مناسب را بر اساس فلگ‌ها ترتیب می‌دهد.
851852

852-
**حالت UDP:** `ping → resolve → nxdomain → edns → tunnel → e2e`
853+
**حالت UDP:** `ping → resolve → nxdomain → tunnel → e2e` (با `--edns` مرحله EDNS اضافه می‌شود)
853854
**حالت DoH:** `doh/resolve → doh/tunnel → doh/e2e`
854855

855856
| فلگ | توضیح | پیش‌فرض |
856857
|-----|-------|---------|
857-
| `--domain` | دامنه تانل (فعال‌سازی تست تانل/edns/e2e) ||
858+
| `--domain` | دامنه تانل (فعال‌سازی تست تانل/e2e) ||
858859
| `--pubkey` | کلید عمومی سرور DNSTT (فعال‌سازی تست e2e) ||
859860
| `--cert` | مسیر گواهی Slipstream (فعال‌سازی تست Slipstream) ||
860861
| `--test-url` | آدرس برای تست اتصال e2e | `https://httpbin.org/ip` |
861862
| `--proxy-auth` | احراز هویت پروکسی SOCKS به صورت `user:pass` (برای تست e2e) ||
862863
| `--doh` | اسکن DoH به جای UDP | `false` |
864+
| `--edns` | فعال‌سازی تست سایز EDNS payload | `false` |
863865
| `--skip-ping` | رد کردن مرحله ping | `false` |
864866
| `--skip-nxdomain` | رد کردن بررسی هایجک | `false` |
865867
| `--top` | تعداد نتایج برتر برای نمایش | `10` |

0 commit comments

Comments
 (0)