پروژه StormDNS 🔐

| نسخه فارسی | English Version |

📢 کانال تلگرام / Telegram Channel: https://t.me/nulllroute1970

پروژه StormDNS یک پروژهٔ علمی-تحقیقاتی برای انتقال داده‌های TCP از طریق درخواست‌ها و پاسخ‌های DNS است. این پروژه در هدف کلی شبیه پروژه‌هایی مانند DNSTT یا SlipStream است، اما از نظر ساختار و روش پیاده‌سازی تفاوت‌های بنیادین دارد و رویکرد متفاوتی را دنبال می‌کند. پیاده‌سازی این سیستم بر پایهٔ سازگاری با انواع شبکه‌ها و رزولورها و نیز توانایی تحمل محدودیت‌های شدید طراحی شده است، تا در بدترین شرایط ممکن بالاترین میزان انتقال داده و بیشترین پایداری را فراهم کند.

📊 مقایسه StormDNS با پروژه‌های مشابه:

❌ رفع مسئولیت (Disclaimer):

پروژه StormDNS صرفاً یک ایدهٔ علمی و آموزشی است و بر همین اساس طراحی و پیاده‌سازی شده است.

• ارائه بدون ضمانت: این نرم‌افزار «همان‌طور که هست» (AS-IS) و بدون هیچ‌گونه ضمانت صریح یا ضمنی، از جمله ضمانت قابلیت فروش، مناسب‌بودن برای هدف خاص یا عدم نقض حقوق، ارائه می‌شود.
• محدودیت مسئولیت: توسعه‌دهندگان و مشارکت‌کنندگان این پروژه هیچ‌گونه مسئولیتی در قبال خسارات مستقیم، غیرمستقیم، تبعی، اتفاقی یا هر نوع خسارت دیگری ناشی از استفاده یا ناتوانی در استفاده از این نرم‌افزار نمی‌پذیرند.
• مسئولیت کاربر: استفاده از این پروژه در محیط‌های غیرآزمایشگاهی ممکن است به ساختار شبکه آسیب برساند. کاربر به‌تنهایی مسئول هرگونه پیامد ناشی از نصب، پیکربندی و استفاده از این نرم‌افزار است.
• رعایت قوانین: استفاده از این پروژه برای دور زدن قوانین کشورها می‌تواند با مسئولیت‌های مدنی و کیفری همراه باشد. لطفاً پیش از استفاده، قوانین و مقررات کشور خود را در این زمینه به‌دقت بررسی کنید. توسعه‌دهندگان هیچ مسئولیتی در قبال نقض قوانین محلی، ملی یا بین‌المللی توسط کاربران نمی‌پذیرند.
• مجوز استفاده: استفاده، کپی، توزیع یا تغییر این نرم‌افزار مشمول شرایط مجوز مندرج در فایل LICENSE این مخزن است. هرگونه استفاده خارج از چارچوب آن مجوز ممنوع است.

کانال اطلاع‌رسانی و پشتیبانی 📢

برای دریافت آخرین اخبار، نسخه‌ها و اطلاعیه‌های پروژه، کانال تلگرام ما را دنبال کنید: Telegram Channel

اگر از پروژه راضی‌اید، با دادن ستاره (⭐) در گیت‌هاب از ما حمایت کنید — این کار به دیده‌شدن پروژه کمک می‌کند.

حمایت مالی (اختیاری) 💸

• شبکه TON:

UQDfjVk2UdpiMg-bsxqoLa0O_icuaF20D-wWJgIJwK1Ha2Ul

• USDT ترون (TRC20):

TR8ibZGKutPKoDm5nMbHFwGPFBuMKwjG6j

• USDT بایننس اسمارت چین (BEP20):

0x8c45d6bae8a5a572b2a776779fe0bcae3d3f9107

از هر نوع حمایت و بازخورد شما سپاسگزاریم — کمک‌ها برای توسعه و بهبود پروژه بسیار ارزشمند است.

ویژگی‌های کلیدی و مزایا ✨

نمای کلی و مختصر از قابلیت‌های اصلی StormDNS:

• عبور از سانسور و تحمل شرایط سخت شبکه: 🛡️ طراحی‌شده برای کار در شبکه‌های دارای فیلترینگ، قطعی و محدودیت MTU.
• پروتکل سبک و کم‌سربار: 🔄 پروتکل اختصاصی با مکانیزم ارسال مجدد برای کاهش سربار و افزایش ظرفیت داده در DNS.
• قابلیت Multipath و تکثیر بسته‌ها: 📡 ارسال همزمان از مسیرهای مختلف و تکثیر انتخابی برای افزایش شانس تحویل در شبکه‌های ناپایدار.
• انتخاب هوشمند رزولورها و بررسی سلامت: ⚡ انتخاب بر اساس کیفیت و وضعیت رزولورها و مدیریت خودکار رزولورهای مشکل‌دار.
• کشف و همگام‌سازی MTU: 🧰 تشخیص MTU عملیاتی مسیرها و تنظیم برای کاهش fragmentation و افزایش پایداری.
• پشتیبانی و بهینه‌سازی SOCKS5/SOCKS4: 🧦 مسیردهی و پردازش بهینه ترافیک پراکسی محلی برای برنامه‌ها.
• تجمیع کنترل‌ها و کاهش سربار پاسخ‌ها: 📦 جمع‌آوری ACK و پیام‌های کنترلی در یک پکت برای کاهش ترافیک کنترل.
• فشرده‌سازی و تجمیع درخواست‌ها (اختیاری): 🗜️ کاهش تعداد درخواست‌ها و افزایش بهره‌وری در شرایط MTU کوچک.
• رمزنگاری انعطاف‌پذیر: 🔐 پشتیبانی از چند الگوریتم رمزنگاری برای متعادل‌سازی سرعت و امنیت.
• قابلیت DNS محلی و کشینگ در کلاینت: 📛 ارائه DNS محلی، کاهش تأخیر و جلوگیری از حملات hijack.
• مقیاس‌پذیری و کنترل منابع: ⚙️ قابل اجرا از سرورهای کم‌منابع تا محیط‌های با بار زیاد.

این فهرست نمای کلی و مختصری از قابلیت‌هاست؛ برای جزئیات بیشتر به بخش‌های مرتبط در همین سند مراجعه کنید.

راه‌اندازی و شروع بکار 🧑‍💻

بخش ۱: 🖥️ راه‌اندازی سرور

بخش ۱.۱: 🌐 راه‌اندازی و آماده‌سازی دامنه (پیش‌نیاز)

برای دریافت مستقیم درخواست‌های DNS روی سرور باید یک زیردامنه را به سرورتان واگذار (delegate) کنید. به‌صورت خلاصه دو رکورد بسازید: یک رکورد A برای آدرس سرور و یک رکورد NS که زیردامنه را به آن A ارجاع دهد.

گام ۱.۱.۱: 🅰️ ساخت رکورد A (آدرس سرور)

• نوع: A
• نام: نام کوتاه مثل ns
• مقدار: آدرس IPv4 سرور شما

مثال: ns.example.com -> 1.2.3.4

در Cloudflare - ⚠️ نکته سریع: اگر دامنه روی Cloudflare است، در صفحه DNS روی آیکون ابر کنار رکورد A کلیک کنید تا خاکستری (DNS only) شود؛ نباید Proxied (نارنجی) باشد.

گام ۱.۱.۲: 🏷️ ساخت رکورد NS (واگذاری زیردامنه)

• نوع: NS
• نام: زیردامنه‌ی تونل مثل v
• مقدار (Target): ns.example.com

مثال: v.example.com -> ns.example.com

در Cloudflare - ⚠️ نکته سریع: رکورد NS را اضافه کنید؛ Cloudflare رکورد NS را پروکسی نمی‌کند، فقط مطمئن شوید رکورد ns قبلاً روی DNS only قرار دارد.

بخش ۱.۱.۳: 💡 نکتهٔ کوتاه دربارهٔ MTU

هر چه نام‌های دامنه کوتاه‌تر باشند، فضای بیشتری برای داده در هر DNS request باقی می‌ماند. برای throughput بهتر از نام‌های کوتاه استفاده کنید. اگر از Cloudflare استفاده می‌کنید، باز هم رکوردها را DNS only نگه دارید.

بخش ۱.۲: 🐧 نصب سریع سرور لینوکس

گام ۱.۲.۱: نصب خودکار (اسکریپت)

اگر قصد دارید سرور را روی یک سیستم لینوکسی راه‌اندازی کنید، ساده‌ترین راه استفاده از اسکریپت نصب خودکار است. کافی است دستور زیر را در ترمینال سرور وارد کنید:

bash <(curl -Ls https://raw.githubusercontent.com/nullroute1970/StormDNS/main/server_linux_install.sh)

این اسکریپت مراحل نصب و پیکربندی را خودکار انجام می‌دهد. بعد از پایان نصب، سرور اجرا می‌شود و کلید رمزنگاری در لاگ ترمینال نمایش داده می‌شود و همچنین در فایل encrypt_key.txt کنار فایل اجرایی ذخیره می‌گردد — این کلید را در جای امن نگه دارید.

آرگومان‌های خط فرمان اسکریپت

اسکریپت نصب از آرگومان‌های زیر پشتیبانی می‌کند که می‌توانید آن‌ها را مستقیماً با همان دستور bash <(curl ...) به کار ببرید:

مثال‌ها:

# نصب یک نسخه‌ی خاص:
bash <(curl -Ls https://raw.githubusercontent.com/nullroute1970/StormDNS/main/server_linux_install.sh) --version v1.2.3

# حذف StormDNS (دستور را در همان دایرکتوری‌ای اجرا کنید که StormDNS را نصب کرده‌اید):
bash <(curl -Ls https://raw.githubusercontent.com/nullroute1970/StormDNS/main/server_linux_install.sh) --uninstall

توجه: برای حذف، دستور را در همان دایرکتوری اجرای نصب اولیه اجرا کنید تا اسکریپت بتواند فایل اجرایی، فایل پیکربندی و کلید رمزنگاری را پیدا و پاک کند.

گام ۱.۲.۲: نکات مهم پس از نصب

• در هنگام نصب از شما آدرس دامنه پرسیده می‌شود؛ باید همان زیردامنه‌ای باشد که در رکورد NS تنظیم کرده‌اید (مثلاً v.example.com).
• پس از ایجاد رکوردهای DNS، تا انتشار آن‌ها صبر کنید (ممکن است از چند دقیقه تا چند ساعت یا در موارد خاص تا 48 ساعت طول بکشد؛ بسته به TTL).
• برای بررسی صحت تنظیمات DNS می‌توانید از ابزارهایی مانند dig یا nslookup استفاده کنید (مثلاً dig v.example.com NS یا nslookup -type=ns v.example.com). برای پرس‌وجو مستقیم از nameserver جدید: dig @ns.example.com v.example.com A.
• اگر فایروال سرور فعال است، اجازه‌ی عبور UDP پورت 53 را بدهید. نمونه برای ufw:

sudo ufw allow 53/udp
sudo ufw reload

برای firewalld:

sudo firewall-cmd --add-port=53/udp --permanent
sudo firewall-cmd --reload

• اگر پورت 53 توسط سرویس دیگری اشغال شده باشد (مثلاً systemd-resolved در برخی توزیع‌ها)، راه‌حل را در بخش «رفع مشکل اشغال بودن پورت ۵۳» ببینید.
• کلید رمزنگاری (encrypt_key.txt) پس از نصب نمایش داده می‌شود؛ آن را کپی و امن نگه دارید، زیرا برای اتصال کلاینت لازم است.

بخش ۲: 🚀 نصب و راه‌اندازی (کلاینت و سرور)

شما می‌توانید این پروژه را به دو روش نصب و اجرا کنید:

1. استفاده از فایل‌های کامپایل‌شدهٔ آماده (مناسب اکثر کاربران)
2. اجرای مستقیم از روی سورس با Go (مناسب توسعه دهندگان)

بخش ۲.۱: استفاده از نسخه‌های کامپایل‌شده (✅ روش پیشنهادی)

برای راحتی شما، فایل‌های اجرایی کلاینت و سرور از قبل در releaseها منتشر می‌شوند. کافی است نسخه مناسب سیستم‌عامل خود را دانلود و از حالت فشرده خارج کنید.

💡 نکته: بسته‌های release معمولاً شامل فایل اجرایی و فایل‌های نمونه‌ی کانفیگ هستند.

لینک‌های دانلود کلاینت (Client) 📥

لینک‌های دانلود سرور (Server) 📤

(اگر نمی‌خواهید از اسکریپت نصب خودکار لینوکس استفاده کنید.)

بخش ۲.۲: 🪟 آماده‌سازی و اجرای کلاینت در ویندوز

• پس از دانلود نسخه مربوط به ویندوز آن را از حالت فشرده خارج کنید.
• فایل client_config.toml را با ویرایشگر متن نظیر Notepad باز کنید.
• در این فایل بجای مقادیر پیش‌فرض، مقادیر زیر را تنظیم کنید:
• مقدار ENCRYPTION_KEY را با کلیدی که در هنگام نصب سرور دریافت کرده‌اید یکی کنید (یا محتوای encrypt_key.txt سرور را در اینجا قرار دهید).
• مقدار DOMAINS را با دامنه‌ای که در رکورد NS تنظیم کرده‌اید یکی کنید (مثلاً ["v.example.com"] و باید با رکورد NS سرور یکی باشد).
• فایل client_resolvers.txt را باز کنید و لیست رزولورها (resolvers) را وارد کنید؛ هر خط یک رزولور با فرمت IP، IP:PORT، CIDR یا CIDR:PORT (مثلاً 8.8.8.8 یا 8.8.8.8:53).

⚠️ نکته: شما باید لیست رزولورهایی که قابلیت انتقال اطلاعات به سرور شما را دارند پیدا کنید و در این فایل قرار دهید.

• سپس فایل StormDNS_Client_Windows_AMD64.exe را اجرا کنید. اگر همه چیز درست تنظیم شده باشد، کلاینت به سرور متصل می‌شود و آماده استفاده است.
• حالا می‌توانید تنظیمات ساکس برنامه‌های خود را روی 127.0.0.1:18000 تنظیم کنید و از اتصال VPN مبتنی بر DNS استفاده کنید.

> ⚠️ نکته مهم: روش پیدا کردن لیست Resolver ها در انتهای این مقاله بهش اشاره شده است.

بخش ۲.۳: 🐧 آماده‌سازی و اجرا در لینوکس

• پس از دانلود نسخه مربوط به لینوکس، فایل ZIP را استخراج کنید، برای اینکار ابتدا برنامه های مورد نیاز را نصب کنید:

sudo apt update
sudo apt install unzip nano screen -y

سپس فایل را استخراج کنید:

unzip StormDNS_Client_Linux_AMD64.zip
ls

• در صورت نیاز مجوز اجرا بدهید:

chmod +x StormDNS_Client_Linux_AMD64

• فایل تنظیمات را ویرایش کنید:

nano client_config.toml

• در این فایل بجای مقادیر پیش‌فرض، مقادیر زیر را تنظیم کنید:
• مقدار ENCRYPTION_KEY را با کلیدی که در هنگام نصب سرور دریافت کرده‌اید یکی کنید (یا محتوای encrypt_key.txt سرور را در اینجا قرار دهید).

• مقدار DOMAINS را با دامنه‌ای که در رکورد NS تنظیم کرده‌اید یکی کنید (مثلاً ["v.example.com"] و باید با رکورد NS سرور یکی باشد).

• فایل client_resolvers.txt را باز کنید و لیست ریزالورهای خود را وارد کنید، هر خط یک ریزالور با فرمت IP، IP:PORT، CIDR یا CIDR:PORT (مثلاً 8.8.8.8 یا 8.8.8.8:53).

⚠️ نکته: شما باید لیست ریزالورهایی که قابلیت انتقال اطلاعات به سرور شما را دارند پیدا کنید و در این فایل قرار دهید.

بخش ۲.۳.۱: اجرای کلاینت در پس‌زمینه

بخش ۲.۳.۱.۱: استفاده از screen برای اجرای در پس‌زمینه

• حالا می‌توانید فایل اجرایی را اجرا کنید، توصیه می‌شود برای اجرای سرور و کلاینت در پس‌زمینه از screen استفاده کنید تا در صورت قطع اتصال SSH، برنامه‌ها همچنان اجرا بمانند:

screen -S StormDNS
./StormDNS_Client_Linux_AMD64

برای خروج از صفحه screen و برگشت به ترمینال اصلی، کلیدهای Ctrl + A را فشار دهید و سپس D را بزنید. برای بازگشت به صفحه screen و دیدن لاگ‌ها یا متوقف کردن برنامه، دستور زیر را وارد کنید:

screen -r StormDNS

بخش ۲.۳.۱.۲: تبدیل به سرویس systemd

همچنین میتوانید نسخه کلاینت را به سرویس systemd تبدیل کنید تا همیشه در پس‌زمینه اجرا باشد، برای اینکار فایل سرویس زیر را ایجاد کنید:

sudo nano /etc/systemd/system/stormdns-client.service

و محتوای زیر را در آن قرار دهید (مطمئن شوید مسیر فایل اجرایی درست است):

[Unit]
Description=StormDNS Client Service
After=network.target
[Service]
Type=simple
ExecStart=/path/to/StormDNS_Client_Linux_AMD64 -config /path/to/client_config.toml
Restart=on-failure
[Install]
WantedBy=multi-user.target

سپس سرویس را فعال و اجرا کنید:

sudo systemctl daemon-reload
sudo systemctl enable stormdns-client
sudo systemctl start stormdns-client

همچنین برای دیدن لاگ‌ها می‌توانید از دستور زیر استفاده کنید:

sudo journalctl -u stormdns-client -f

بخش ۲.۴: 🍎 آماده‌سازی و اجرا در مک

• پس از دانلود نسخه مربوط به مک، فایل ZIP را استخراج کنید.

• فایل client_config.toml را با ویرایشگر متن باز کنید (مثلاً با TextEdit یا nano در ترمینال) و مقادیر زیر را تنظیم کنید:

  • مقدار ENCRYPTION_KEY را با کلیدی که در هنگام نصب سرور دریافت کرده‌اید یکی کنید (یا محتوای encrypt_key.txt سرور را در اینجا قرار دهید).
  • مقدار DOMAINS را با دامنه‌ای که در رکورد NS تنظیم کرده‌اید یکی کنید (مثلاً ["v.example.com"] و باید با رکورد NS سرور یکی باشد).

• فایل client_resolvers.txt را باز کنید و لیست ریزالورهای خود را وارد کنید، هر خط یک ریزالور با فرمت IP، IP:PORT، CIDR یا CIDR:PORT (مثلاً 8.8.8.8 یا 8.8.8.8:53).

⚠️ نکته: شما باید لیست ریزالورهایی که قابلیت انتقال اطلاعات به سرور شما را دارند پیدا کنید و در این فایل قرار دهید.

• سپس فایل StormDNS_Client_MacOS_ARM64 را اجرا کنید. اگر همه چیز درست تنظیم شده باشد، کلاینت به سرور متصل می‌شود و آماده استفاده است.
• حالا می‌توانید تنظیمات ساکس برنامه‌های خود را روی 127.0.0.1:1080 قرار دهید.

بخش ۲.۵: 🐈‍⬛ پارامترهای خط فرمان (Command-line) برای کلاینت و سرور

هر دو باینری از این پارامترها پشتیبانی می‌کنند:

نمونه:

./stormdns-server -config server_config.toml -log server.log
./stormdns-client -config client_config.toml -log client.log

بخش ۳: 🛠️ ساختار فایل‌های تنظیمات (Config)

بخش ۳.۱: 📂 فایل‌های مهم پروژه

بخش ۳.۲: 🧾 فایل لیست رزولورها (client_resolvers.txt)

فرمت قابل قبول در client_resolvers.txt:

• IP
• IP:PORT
• CIDR
• CIDR:PORT

نمونه:

8.8.8.8
1.1.1.1:53
9.9.9.0/24
208.67.222.0/24:5353

بخش ۳.۴: 📖 پیکربندی کلاینت (client_config.toml)

⚠️ نکته مهم: فایل client_config.toml فقط بخشی از پیکربندی کلاینت است. لیست resolverها داخل فایل جداگانه‌ی client_resolvers.txt خوانده می‌شود و اگر آن فایل وجود نداشته باشد، کلاینت بالا نمی‌آید.

۳.۴.۱) بخش 🔐 هویت تونل، حالت کار و امنیت

۳.۴.۲) بخش 🧦 پراکسی محلی و دسترسی برنامه‌ها

۳.۴.۳) بخش 📛 DNS محلی و کش DNS

۳.۴.۴) بخش 📡 انتخاب Resolver، Duplication و سلامت مسیر

نکته — لینک‌های با آپلود محدود (مثل ایران): چون مصرف آپلود متناسب با UPLOAD_PACKET_DUPLICATION_COUNT زیاد می‌شود ولی duplication پکت‌های ACK عملاً رایگان است، یک پروفایل خوب این است: toml UPLOAD_PACKET_DUPLICATION_COUNT = 1 # یا 2 DOWNLOAD_PACKET_DUPLICATION_COUNT = 5 # 4..7 UPLOAD_SETUP_PACKET_DUPLICATION_COUNT = 3 # 2..4 DOWNLOAD_SETUP_PACKET_DUPLICATION_COUNT = 6 # 4..8 این تنظیمات مصرف آپلود را پایین نگه می‌دارد و در عین حال پایداری دانلود و ایجاد اتصال را به‌طور پررنگ محافظت می‌کند.

۳.۴.۵) بخش 🗜️ فشرده‌سازی

۳.۴.۶) بخش 📏 MTU، تست اولیه و خروجی نتایج

۳.۴.۷) بخش ⚙️ Workerها، queueها و زمان‌بندی runtime

۳.۴.۸) بخش 🫀 Ping / Keepalive

۳.۴.۹) بخش 🔄 ARQ، NACK و packing

۳.۴.۱۰) بخش 🪵 لاگ

بخش ۳.۵: 📖 پیکربندی سرور (server_config.toml)

ℹ️ نکته: در فایل نمونه‌ی سرور یک کلید به نام CONFIG_VERSION دیده می‌شود، اما کد فعلی Go آن را در ServerConfig نمی‌خواند. به همین دلیل در جدول زیر نیاورده شده است و روی رفتار واقعی سرور اثر ندارد.

۳.۵.۱) بخش 🌐 سیاست تونل و پذیرش پروتکل

۳.۵.۲) بخش 📥 UDP Listener و ظرفیت ورودی

۳.۵.۳) بخش 🧠 Deferred Session Runtime

۳.۵.۴) بخش 🍪 چرخه عمر session/stream و invalid-cookie

۳.۵.۵) بخش 📛 DNS Tunnel Upstream

۳.۵.۶) بخش 🌐 Forwarding و SOCKS خارجی

۳.۵.۷) بخش 🔐 امنیت

۳.۵.۸) بخش 🔄 ARQ، packing و TTLهای کنترلی

۳.۵.۹) بخش 🪵 لاگ

بخش ۳.۶: 🧪 تست و پیدا کردن و اسکن ریزالور

پیدا کردن ریزالور و استفاده از ریزالور مناسب یکی از مهمترین بخش های پروژه های مبنتی بر تونل DNS است. در این پروژه، کلاینت خودش به‌صورت خودکار ریزالورهای سالم را پیدا می‌کند و MTU آن‌ها را تست می‌کند. شما به کمک این قابلیت کلاینت میتوانید ریزالورهای سالم را پیدا کنید، اگر قصد دارید، ریزالورهای خود را تست کنید و یا ریزالور های یک رنج را پیدا کنید، کافیست در فایل client_resolvers.txt تمام آی پی ها را به صورت خط به خط وارد کنید.

سپس از فایل client_config.toml فعلی خود یک پشتیبان بگیرید و فایل را با ویرایشگر متن باز کرده و مقادیر زیر را پیدا کرده و با مقدار های پشنهادی زیر جایگزین کنید:

• کاهش سقف MTU جهت پیدا کردن تمام سرورهایی که DNS Server دارند و یکی کردن Min و Max برای سرعت بخشیدن به تست ریزالورها و جلوگیری از Binary Search خودکار.

MIN_UPLOAD_MTU=30
MIN_DOWNLOAD_MTU=40
MAX_UPLOAD_MTU=30
MAX_DOWNLOAD_MTU=40

• افزایش تعداد بررسی همزمان ریزالورها (این بخش را با STARTUP_MODE = "resolvers" و اسکن کامل اجرا می‌کنیم):

MTU_TEST_PARALLELISM_RESOLVERS = 200

• کاهش تعداد تلاش برای هر ریزالور و کاهش timeout برای سرعت بخشیدن به تست، البته با این تنظیمات ممکن است ریزالورهای سالمی که کمی کند هستند را از دست بدهید، پس اگر میخواهید دقیق تر تست کنید این مقادیر را کمی بالاتر ببرید.

MTU_TEST_RETRIES_RESOLVERS = 1
MTU_TEST_TIMEOUT_RESOLVERS = 1.0

⚠️ نکته مهم: حتما باید قبل از اینکار یک سرور را راه اندازی کنید و کلید و آدرس دامنه آن را در client_config.toml وارد کنید، در غیر این صورت کلاینت نمی‌تواند تست MTU را انجام دهد و همه ریزالورها را نامعتبر تشخیص می‌دهد.

حالا برنامه را اجرا کنید و صبر کنین تست ها انجام شود، پس از پایان عملیات برنامه را ببندید. لیست ریزالورهای سالم به صورت خودکار در پوشه logs/ در قالب فایل resolver_cache_<timestamp>.log ذخیره می‌شود. هر خط شامل آدرس IP، پورت، دامنه، و مقادیر MTU است. می‌توانید آی‌پی‌ها را از این فایل کپی کرده و در client_resolvers.txt خود قرار دهید.

سپس به تنظیمات قبلی خود برگردید و از ریزالورهای سالمی که پیدا کردید استفاده کنید تا بهترین عملکرد را داشته باشید.

بخش ۳.۶: ⚡ درک بهتر از MTU و تنظیمات طلایی برای اجرای سریع

این پروژه به‌شدت به MTU مناسب وابسته است. اگر MTU را خیلی بالا بگیرید:

• بخش resolverهای بیشتری fail می‌شوند
• بخش startup طولانی‌تر می‌شود
• بخش fragmentation و loss بیشتر می‌شود

اگر خیلی پایین بگیرید:

• سرعت کم می‌شود
• اما پایداری بیشتر می‌شود

پیشنهاد عملی

1. با sample config شروع کنید.
2. اجازه دهید کلاینت resolverها را تست کند.
3. خروجی MTU و تعداد resolverهای معتبر را ببینید.
4. اگر کیفیت بد است، MIN_UPLOAD_MTU و MIN_DOWNLOAD_MTU را کمی پایین‌تر بیاورید.
5. اگر می‌خواهید startup سریع‌تر شود، بازه MIN/MAX را محدودتر و بهم نزدیک تر کنید.

بخش ۴: راهنمای استفاده در موبایل (اندروید و آیفون) 📱

از آنجایی که در حال حاضر اپلیکیشن رسمی توسط خود ما برای اندروید یا iOS ارائه نشده، می‌توانید از طریق یکی از این روش‌ها از تونل روی گوشی استفاده کنید: (شما میتوانید از کلاینت های اندروید ساخته شده توسط افراد دیگر که در بخش ۵.۱ معرفی شده‌اند هم استفاده کنید.)

روش اول: اشتراک‌گذاری پراکسی از روی کامپیوتر 📶

1. بخش LISTEN_IP را روی 0.0.0.0 بگذارید.
2. کلاینت را روی کامپیوتر اجرا کنید.
3. گوشی و کامپیوتر را به یک شبکه وصل کنید.
4. در گوشی یک پروکسی SOCKS5 با IP کامپیوتر و پورت LISTEN_PORT تنظیم کنید.

روش دوم: اجرای کلاینت روی سرور واسط 🏗️

1. سرور اصلی را روی مقصد نهایی اجرا کنید.
2. کلاینت را روی سرور واسط اجرا کنید.
3. بخش LISTEN_IP را روی 0.0.0.0 بگذارید.
4. از گوشی به SOCKS5 همان سرور واسط وصل شوید.

روش سوم: ترکیب با پنل‌های دیگر 🛠️

اگر روی یک سرور، پنل یا سرویس دیگری دارید، می‌توانید outbound آن را به SOCKS5 لوکال کلاینت StormDNS بدهید و از آن به‌عنوان مسیر خروجی استفاده کنید.

⚠️ نکات مهم امنیتی برای موبایل

• اگر بخش LISTEN_IP = "0.0.0.0" است، برای SOCKS5 احراز هویت بگذارید یا مطمئن شوید شبکه‌تان امن است، چون هر کسی در شبکه می‌تواند از تونل شما استفاده کند، استفاده از نام کاربری و رمزعبور برای SOCKS5 روی شبکه های اینترنت به شدت توصیه می‌شود.
• همچنین میتوانید پورت پیشفرض LISTEN_PORT را تغییر دهید تا کمتر در معرض حملات خودکار باشد.
• اگر دستگاه‌ها به هم وصل نمی‌شوند، firewall سیستم را بررسی کنید.

بخش ۵: 🖥️ نکات و توضیحات جانبی

بخش ۵.۱: 🧩 پروژه های دیگران راجب این پروژه:

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

پیشنهاد میکنیم برای حمایت از توسعه‌دهندگان این پروژه‌ها، اگر از آن‌ها استفاده کردید یا ایده گرفتید، حتماً به مخزن گیت‌هاب آن‌ها ستاره بدهید و از آن ها حمایت کنید تا به توسعه دهنگان این پروژه ها، انگیزه بدهید و اگر مشکلی داشتید یا پیشنهادی برای بهبود داشتید، برای آن پروژه issue ایجاد کنید یا در صورت امکان pull request بزنید و در توسعه آن‌ها مشارکت کنید.

شما میتوانید با مراجعه به لینک‌های زیر این پروژه‌ها را بررسی کنید و اگر نیاز داشتید از آن‌ها استفاده کنید یا ایده بگیرید:

• کلاینت اندروید MDV HN Edition

  یک اپلیکیشن اندروید که بر مبنای StormDNS ساخته شده که امکان اتصال به سرورهای StormDNS را از طریق گوشی فراهم می‌کند. این پروژه توسط Hidden Node توسعه داده شده است و می‌توانید آن را در لینک بالا مشاهده کنید.

• کلاینت اندروید StormDNS GG

  یک اپلیکیشن اندروید دیگر که بر مبنای StormDNS ساخته شده است. این پروژه توسط RevocGG توسعه داده شده است و می‌توانید آن را در لینک بالا مشاهده کنید.

• ابزار ساخت کانفیگ فارسی برای StormDNS - آدرس وب جهت ساخت کانفیگ

  این ابزار به شما کمک می‌کند تا کانفیگ‌های StormDNS را به زبان فارسی و با توضیحات کامل بسازید. این پروژه توسط datacoder-io توسعه داده شده است و می‌توانید آن را در لینک بالا مشاهده کنید.

بخش ۵.۲: رفع مشکل اشغال بودن پورت ۵۳ (در سرور لینوکس) 🛑

در اکثر توزیع‌های لینوکس، پورت 53 توسط systemd-resolved اشغال است. اگر سرور بالا نیامد:

sudo nano /etc/systemd/resolved.conf

و این مقدار را بگذارید:

DNSStubListener=no

سپس:

sudo systemctl restart systemd-resolved

⚠️ اخطار مهم: روی یک سرور نمی‌توانید همزمان چند پروژه‌ی تونل DNS را روی پورت 53 اجرا کنید.

بخش ۶: 🛠️ معماری و نحوهٔ کار سیستم

پروژه StormDNS با ترکیب Session Multiplexing، Resolver Balancing، Packet Duplication، لایه‌ی ARQ اختصاصی و Deferred Session Runtime روی بستر UDP/DNS محدودیت‌های تونل‌های معمول را دور می‌زند.

بخش ۶.۱: 🌐 نمای کلی معماری دیاگرام

graph TD
    subgraph Client_Side ["🖥️ سیستم کاربر (Client)"]
        App["📱 برنامه‌ها (مرورگر، تلگرام و...)"]
        Proxy["🧦 پروکسی محلی SOCKS5 / TCP"]
        LDNS["📛 Local DNS (اختیاری)"]
        ResolverRuntime["⚡ Balancer + Duplication + Resolver Health"]
        ClientARQ["🔄 ARQ + Session/Stream Runtime"]
    end

    subgraph DNS_Network ["🌐 شبکه عمومی DNS"]
        R1["📡 Resolver 1"]
        R2["📡 Resolver 2"]
        RN["📡 Resolver N"]
    end

    subgraph Server_Side ["🖥️ سرور خارج از کشور (Server)"]
        UDP["📥 UDP Listener + Request Workers"]
        Sessions["🧠 Session Store + Deferred Workers"]
        ServerARQ["🔄 Server ARQ + Packed Control Blocks"]
        DNSUp["📛 DNS Upstream / Cache"]
        Out["🌐 Direct Dial یا External SOCKS5"]
    end

    App --> Proxy
    App --> LDNS
    Proxy --> ClientARQ
    LDNS --> ClientARQ
    ClientARQ --> ResolverRuntime
    ResolverRuntime --> R1
    ResolverRuntime --> R2
    ResolverRuntime --> RN
    R1 --> UDP
    R2 --> UDP
    RN --> UDP
    UDP --> Sessions
    Sessions --> ServerARQ
    Sessions --> DNSUp
    ServerARQ --> Out
    DNSUp --> UDP

بخش ۶.۲: 🔄 جریان و چرخهٔ حیات پکت‌ها

sequenceDiagram
    participant App as 📱 برنامه کاربر
    participant Client as 🖥️ کلاینت
    participant DNS as 📡 Resolverها
    participant Server as 🖥️ سرور
    participant Target as 🌐 مقصد نهایی

    App->>Client: ایجاد اتصال SOCKS5 / TCP
    Note over Client: ساخت Session/Stream<br/>رمزنگاری، ARQ، انتخاب Resolver
    Client->>DNS: ارسال DNS Query با Duplication و Balancing
    DNS->>Server: تحویل Query به NS سرور
    Note over Server: Checksum / Cookie / Session lookup<br/>Deferred setup / ARQ / Queueing
    Server->>Target: اتصال مستقیم یا از طریق SOCKS5 خارجی
    Target-->>Server: دریافت پاسخ مقصد
    Note over Server: قرار دادن دیتا در ARQ<br/>ساخت ACK و Packed Control Blocks
    Server-->>DNS: DNS Response
    DNS-->>Client: پاسخ DNS
    Note over Client: ARQ reorder / ACK consume / تحویل به برنامه
    Client-->>App: داده سالم و مرتب

بخش ۶.۳: 🧠 مفاهیم کلیدی استفاده‌شده

بخش ۷: ⚙️ نکات فنی پیشرفته

• ⚡ اتصال مستقیم یا از طریق SOCKS5 خارجی: اگر USE_EXTERNAL_SOCKS5 = false باشد، سرور مستقیم به مقصد وصل می‌شود. اگر true باشد، از SOCKS5 خارجی عبور می‌کند، به صورت عمومی برنامه نیازی به نصب یا استفاده از سرور ساکس خارجی ندارد، پس میتوانید این گزینه را خاموش نگه دارید.
• 🧠 بخش Resolver failover روی هر stream: اگر یک stream روی resolver بد گیر کند، resolver ترجیحی‌اش می‌تواند جابه‌جا شود.
• 📦 تکرار blockهای کنترلی: سرور می‌تواند آخرین packed control block را چند turn تکرار کند تا روی لینک lossy احتمال رسیدن ACKهای حیاتی بیشتر شود.
• 🔒 کلید سمت سرور: اگر encrypt_key.txt وجود نداشته باشد، سرور هنگام startup آن را می‌سازد.

🤝 مشارکت (Contributing)

ما از تمام مشارکت‌ها استقبال می‌کنیم. لطفاً اگر ایده، باگ یا بهبود عملکردی دارید، از طریق Issue یا Pull Request آن را مطرح کنید.

Issues

Pull Requests

📄 مجوز (License)

این پروژه تحت مجوز MIT منتشر شده است. برای جزئیات بیشتر به فایل LICENSE مراجعه کنید.

👨‍💻 توسعه‌دهنده (Developer)

توسعه‌داده‌شده با ❤️ توسط: nullroute1970

🍴 فورک (Fork)

این پروژه فورکی از MasterDnsVPN است — نسخه v2026.04.05.191930-7757d2d توسط masterking32.