TunnelX/README.fa.md

TunnelX

فارسی | English

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

وضعیت پروژه: پیش‌انتشار. قبل از انتشار عمومی فایل اجرایی، نکات ساخت و انتشار را در docs/BUILD.md بررسی کنید.

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

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 را با کلاینت خودش مدیریت می‌کند.

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

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

انتخاب برنامه‌ها برای تونل	تنظیمات تونل

دانلود

فایل‌های آماده اجرا از بخش 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 منتشر شده است. اجزای شخص ثالث همراه پروژه مجوزهای خودشان را دارند. برای جزئیات بیشتر:

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

حمایت مالی

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

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

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

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

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