Files
TunnelX/README.fa.md
T
MaxFan 8283b9d6d1 Prepare release v1.2.27
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-17 19:20:44 +03:30

9.2 KiB

TunnelX

فارسی | English

TunnelX یک نرم‌افزار آزاد و رایگان برای ویندوز است که توسط MaxFan ساخته شده و برای مدیریت تونل، وی‌پی‌ان و Split Tunneling استفاده می‌شود. این برنامه می‌تواند ترافیک برنامه‌های انتخاب‌شده، مقصدهای مشخص، یا کل سیستم را از تونل عبور دهد و هم‌زمان مسیر عادی شبکه را برای مقصدهای محلی یا مستثنی‌شده حفظ کند.

کاربرد برنامه

TunnelX برای زمانی ساخته شده که کاربر نمی‌خواهد تمام ترافیک سیستم از وی‌پی‌ان عبور کند. با این برنامه می‌توان فقط برنامه‌هایی مثل مرورگر، تلگرام، ابزارهای توسعه یا برنامه‌های مشخص دیگر را وارد تونل کرد و بقیه ترافیک سیستم را روی اینترنت عادی نگه داشت. همچنین در صورت نیاز، حالت Full-route برای عبور کل سیستم از تونل در دسترس است.

قابلیت‌ها

  • Split tunneling بر اساس برنامه‌های انتخاب‌شده در ویندوز
  • حالت Full-route برای تونل کردن کل سیستم
  • پشتیبانی از جریان‌های V2Ray بر پایه Xray-core و sing-box
  • پشتیبانی از OpenVPN Community با فایل‌های .ovpn برای Split tunneling برنامه‌های انتخاب‌شده
  • پروکسی SOCKS5 محلی روی 127.0.0.1 برای ابزارهایی که تنظیم پروکسی داخلی دارند
  • تغییر مسیر DNS، مسدودسازی IPv6، محافظ نشت، عیب‌یابی route و تاریخچه مصرف تونل
  • رابط کاربری فارسی‌محور برای ویندوز

پشتیبانی از OpenVPN

TunnelX می‌تواند نسخه نصب‌شده OpenVPN Community و فایل انتخابی .ovpn کاربر را اجرا کند و سپس سیاست Split tunneling خودش را اعمال کند؛ یعنی فقط برنامه‌ها و مقصدهای انتخاب‌شده از تونل OpenVPN عبور می‌کنند.

OpenVPN همراه TunnelX توزیع نمی‌شود. برای این حالت باید OpenVPN Community را جداگانه نصب کنید، فایل .ovpn را در TunnelX انتخاب کنید و در صورت نیاز نام کاربری و رمز عبور OpenVPN را داخل برنامه وارد کنید. نصب بودن OpenVPN Connect به‌تنهایی برای این حالت کافی نیست، چون آن برنامه مسیرها و DNS را با کلاینت خودش مدیریت می‌کند.

نکته‌های مسیر و دامنه

قانون‌های Include و Exclude هم خود دامنه واردشده و هم زیردامنه‌های آن را پوشش می‌دهند. برای نمونه، افزودن githubusercontent.com پس از resolve شدن DNS شامل raw.githubusercontent.com هم می‌شود. اگر یک کلاینت HTTPS در مرحله بررسی certificate revocation خطا داد، ممکن است میزبان‌های OCSP/CRL آن از مسیر انتخابی قابل دسترسی نباشند؛ در این حالت خود برنامه دانلودکننده یا دامنه‌های revocation مربوطه را هم در لیست لزومی قرار دهید.

تصاویر برنامه

داشبورد اتصال تنظیم پروفایل و سرور
داشبورد اتصال TunnelX تنظیم پروفایل و سرور TunnelX
انتخاب برنامه‌ها برای تونل تنظیمات تونل
انتخاب برنامه‌ها برای تونل در TunnelX تنظیمات تونل در TunnelX

دانلود

فایل‌های آماده اجرا از بخش Releases پروژه منتشر می‌شوند:

دانلود آخرین نسخه از GitHub Releases

فایل‌های منتشرشده توسط GitHub Actions ساخته و آپلود می‌شوند. برای هر فایل اجرایی standalone، فایل checksum با پسوند .sha256 هم منتشر می‌شود و در متن هر Release لینک اجرای workflow قرار می‌گیرد.

نسخه پیشنهادی برای کاربران، فایل standalone و self-contained است. این نسخه به نصب جداگانه .NET Runtime نیاز ندارد.

نیازمندی‌های اجرا

  • ویندوز 10/11
  • ویندوز ۶۴ بیتی: win-x64
  • دسترسی Administrator هنگام اجرا، چون مدیریت route و packet interception به سطح دسترسی بالا نیاز دارد
  • نسخه‌های ۳۲ بیتی ویندوز در حال حاضر پشتیبانی نمی‌شوند

ساخت از سورس

برای توسعه یا ساخت دستی، .NET 8 SDK لازم است:

dotnet build AppTunnel.sln -c Release
dotnet publish AppTunnel\AppTunnel.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:EnableCompressionInSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None -p:DebugSymbols=false

جزئیات بیشتر در docs/BUILD.md آمده است. ایده‌ها و برنامه‌های آینده در docs/ROADMAP.md نگهداری می‌شوند.

مجوز

TunnelX تحت مجوز GPL-3.0-or-later منتشر شده است. استفاده تجاری با رعایت شرایط GPL مجاز است. اجزای شخص ثالث همراه پروژه مجوزهای خودشان را دارند. برای جزئیات بیشتر:

  • LICENSE
  • THIRD_PARTY_NOTICES.md
  • docs/LEGAL.md

پشتیبانی، سفارشی‌سازی و حمایت مالی

TunnelX آزاد و رایگان است. حمایت مالی کاملا اختیاری است و فقط به نگهداری و توسعه پروژه کمک می‌کند.

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

گزینه‌های حمایت و راه‌های تماس از طریق GitHub Sponsors/Funding یا فایل docs/DONATE.md در دسترس هستند.

نکته ایمنی و سلب مسئولیت

TunnelX یک ابزار شبکه، تونل و مدیریت مسیر است. فقط در محیط‌هایی از آن استفاده کنید که اجازه استفاده از وی‌پی‌ان، پروکسی، packet capture و تغییر route را دارید. این پروژه مشاوره حقوقی ارائه نمی‌دهد.

این نرم‌افزار همان‌گونه که هست ارائه می‌شود، بدون هیچ‌گونه ضمانت، و نگهدارنده پروژه تعهدی برای ارائه بروزرسانی، رفع اشکال، پشتیبانی یا ادامه دسترسی دائمی ندارد.