Skip to content

Commit 30a7132

Browse files
committed
Expand GUIDE.md e2e section: explain pubkey, cert path, query size fields
1 parent 9f2a177 commit 30a7132

1 file changed

Lines changed: 41 additions & 3 deletions

File tree

GUIDE.md

Lines changed: 41 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -198,9 +198,34 @@ TUI شما را قدم به قدم راهنمایی می‌کند:
198198
**بخش E2E (اختیاری):**
199199
- **E2E Testing** — به صورت پیش‌فرض خاموش است. وقتی روشن کنید:
200200
- وضعیت باینری‌ها را نشان می‌دهد (✔ یا ✘ برای `dnstt-client`، `slipstream-client`، `curl`)
201-
- فیلدهای Pubkey، Cert، Test URL، Proxy Auth و E2E Timeout ظاهر می‌شوند
201+
- فیلدهای Pubkey، Cert Path، Test URL، Proxy Auth و E2E Timeout ظاهر می‌شوند
202202
- بدون باینری‌ها اسکن شروع نمی‌شود — ابتدا آن‌ها را نصب کنید
203203

204+
**توضیح فیلدهای E2E:**
205+
206+
- **Pubkey** — کلید عمومی سرور DNSTT. یک رشته ۶۴ کاراکتر هگز است که **موقع ساخت سرور DNSTT** ساخته می‌شود.
207+
- فقط برای dnstt لازم است — برای Slipstream خالی بگذارید
208+
- مثال: `9e2bfd5b4e7644f14bbd74a41663e42bfa2a11497b04c88f7bc3d290144f7b37`
209+
- این کلید را از سرور خود می‌گیرید (فایل `server.pub` یا خروجی دستور راه‌اندازی سرور)
210+
211+
- **Cert Path** — مسیر فایل گواهی TLS سرور Slipstream روی **سیستم خودتان**.
212+
- فقط برای Slipstream لازم است — برای dnstt خالی بگذارید
213+
- این فایل روی سرور Slipstream شما ساخته می‌شود (معمولاً `cert.pem`)
214+
- باید یک بار از سرور به سیستم خود کپی کنید (مثلاً با `scp`) و مسیر لوکالش را وارد کنید
215+
- مثال ویندوز: `C:\Users\You\Desktop\cert.pem`
216+
- مثال لینوکس: `/home/user/cert.pem`
217+
218+
- **Query Size** — حداکثر سایز query DNS که dnstt-client می‌فرستد (بایت). پیش‌فرض: خالی (حداکثر ممکن).
219+
- اگر در ایران همه e2e فیل می‌شوند، مقدار 50 تا 80 را امتحان کنید
220+
- بعضی فیلترها query‌های بزرگ را بلاک می‌کنند
221+
222+
- **Test URL** — آدرس سایتی که از طریق تانل تست می‌شود. پیش‌فرض: `http://httpbin.org/ip`
223+
- معمولاً نیازی به تغییر ندارد
224+
225+
- **Proxy Auth** — احراز هویت SOCKS به فرمت `user:pass`. فقط اگر سرور شما رمز دارد.
226+
227+
- **E2E Timeout** — حداکثر زمان انتظار برای هر تست e2e (ثانیه). پیش‌فرض: 20 ثانیه.
228+
204229
هر فیلد یک توضیح در پایین صفحه نشان می‌دهد.
205230

206231
**کلیدها:** `Space` برای تغییر وضعیت، `Tab/↓` فیلد بعدی، `Enter` روی Start Scan.
@@ -904,11 +929,24 @@ findns edns -i resolvers.txt -o edns-results.json --domain t.example.com --edns-
904929

905930
### پیش‌نیازهای تست E2E (مهم - حتماً بخوانید)
906931

907-
تست e2e فقط بررسی DNS نیست — **واقعاً یک تانل باز می‌کند و ترافیک رد می‌کند.** برای این کار به دو چیز نیاز دارید:
932+
تست e2e فقط بررسی DNS نیست — **واقعاً یک تانل باز می‌کند و ترافیک رد می‌کند.** برای این کار به موارد زیر نیاز دارید:
908933

909934
**۱. سرور تانل فعال:** شما باید یک سرور DNSTT یا Slipstream **از قبل راه‌اندازی کرده باشید** روی یک VPS. بدون سرور، تست e2e نمی‌تواند کار کند چون باید واقعاً به سرور وصل شود.
910935

911-
**۲. باینری کلاینت:** فایل `dnstt-client` یا `slipstream-client` باید روی سیستم شما موجود باشد. (نحوه نصب: [بخش ۱ - dnstt-client چیست؟](#dnstt-client-چیست-و-چطور-نصبش-کنم))
936+
**۲. باینری کلاینت:** فایل `dnstt-client` یا `slipstream-client` باید کنار findns باشد. (نحوه نصب: [بخش ۱ - dnstt-client چیست؟](#dnstt-client-چیست-و-چطور-نصبش-کنم))
937+
938+
**۳. کلید یا گواهی سرور:**
939+
940+
برای **DNSTT** — به `--pubkey` نیاز دارید:
941+
- یک رشته ۶۴ کاراکتر هگز که موقع ساخت سرور DNSTT ساخته می‌شود
942+
- از فایل `server.pub` روی سرور می‌گیرید: `cat /etc/dnstt/server.pub`
943+
- مثال: `9e2bfd5b4e7644f14bbd74a41663e42bfa2a11497b04c88f7bc3d290144f7b37`
944+
- ⚠️ فقط محتوای خالص hex — اگر فایل دانلود می‌کنید حتماً Raw بگیرید نه صفحه HTML
945+
946+
برای **Slipstream** — به `--cert` نیاز دارید:
947+
- فایل `cert.pem` که روی سرور Slipstream ساخته می‌شود
948+
- باید یک بار از سرور به سیستم خود کپی کنید: `scp user@vps:/path/to/cert.pem ~/cert.pem`
949+
- سپس مسیر لوکال را به findns بدهید: `--cert /home/user/cert.pem`
912950

913951
> **اگر سرور تانل ندارید:** فقط تا مرحله `tunnel` (بررسی NS record) می‌توانید تست کنید. این مرحله بررسی می‌کند resolver **قابلیت** ساپورت تانل را دارد، ولی تضمین واقعی نمی‌دهد. برای تضمین واقعی باید e2e بزنید.
914952

0 commit comments

Comments
 (0)