Prepare release v1.2.29

Co-authored-by: Cursor <cursoragent@cursor.com>

AppTunnel/AppTunnel.csproj

@@ -21,9 +21,9 @@
     <PackageLicenseExpression>GPL-3.0-or-later</PackageLicenseExpression>
     <NeutralLanguage>fa-IR</NeutralLanguage>
     <!-- Version Management -->
-    <Version>1.2.27</Version>
-    <AssemblyVersion>1.2.27.0</AssemblyVersion>
-    <FileVersion>1.2.27.0</FileVersion>
+    <Version>1.2.29</Version>
+    <AssemblyVersion>1.2.29.0</AssemblyVersion>
+    <FileVersion>1.2.29.0</FileVersion>
   </PropertyGroup>
   <ItemGroup>
     <PackageReference Include="CommunityToolkit.Mvvm" Version="8.2.2" />

AppTunnel/Services/TrafficRouterService.RouteManagement.cs

@@ -5,6 +5,8 @@ namespace AppTunnel.Services;
 
 public partial class TrafficRouterService
 {
+    private bool _vpnServerPhysicalRouteAdded;
+
     public bool IsFullRouteEnabled => _fullRouteEnabled;
 
     public bool SetFullRouteEnabled(bool enabled)
@@ -17,9 +19,19 @@ public partial class TrafficRouterService
             if (!AddVpnServerPhysicalRoute())
                 Logger.Warning("[FULL-ROUTE] Could not pin VPN server to the physical gateway; enabling full-route may fail.");
 
-            if (!TryRunRouteCommand($"add 0.0.0.0 mask 0.0.0.0 0.0.0.0 IF {_vpnInterfaceIndex} METRIC 1", out var stderr))
+            RemoveFullRouteDefault();
+            var gateway = GetVpnRouteGateway();
+            var added = TryRunRouteCommand($"add 0.0.0.0 mask 0.0.0.0 {gateway} IF {_vpnInterfaceIndex} METRIC 1", out var stderr);
+            if (!added && gateway != "0.0.0.0")
+            {
+                Logger.Warning($"[FULL-ROUTE] Failed to add VPN default route via {gateway}; retrying on-link gateway. stderr={stderr.Trim()}");
+                added = TryRunRouteCommand($"add 0.0.0.0 mask 0.0.0.0 0.0.0.0 IF {_vpnInterfaceIndex} METRIC 1", out stderr);
+            }
+
+            if (!added)
             {
                 Logger.Warning($"[FULL-ROUTE] Failed to add VPN default route: {stderr}");
+                RemoveVpnServerPhysicalRoute();
                 return false;
             }
 
@@ -32,6 +44,7 @@ public partial class TrafficRouterService
 
         RemoveExcludedDirectRoutes();
         RemoveFullRouteDefault();
+        RemoveVpnServerPhysicalRoute();
         _fullRouteEnabled = false;
         MarkPolicyTransitionGrace(TimeSpan.FromSeconds(25));
         CleanupRoutesForCurrentMode(dropStaleNat: true);
@@ -42,15 +55,28 @@ public partial class TrafficRouterService
 
     private bool AddVpnServerPhysicalRoute()
     {
+        _vpnServerPhysicalRouteAdded = false;
         if (string.IsNullOrWhiteSpace(_vpnServerIp) || _vpnServerIp == "0.0.0.0")
             return false;
         if (string.IsNullOrWhiteSpace(_physicalGatewayIp) || _physicalInterfaceIndex <= 0)
             return false;
 
         TryRunRouteCommand($"delete {_vpnServerIp}", out _);
-        return TryRunRouteCommand(
+        var added = TryRunRouteCommand(
             $"add {_vpnServerIp} mask 255.255.255.255 {_physicalGatewayIp} IF {_physicalInterfaceIndex} METRIC 1",
             out _);
+        _vpnServerPhysicalRouteAdded = added;
+        return added;
+    }
+
+    private void RemoveVpnServerPhysicalRoute()
+    {
+        if (!_vpnServerPhysicalRouteAdded)
+            return;
+
+        if (!string.IsNullOrWhiteSpace(_vpnServerIp) && _vpnServerIp != "0.0.0.0")
+            TryRunRouteCommand($"delete {_vpnServerIp}", out _);
+        _vpnServerPhysicalRouteAdded = false;
     }
 
     private void RemoveFullRouteDefault()
@@ -59,6 +85,9 @@ public partial class TrafficRouterService
         RemoveDefaultRouteOnVpn();
     }
 
+    private string GetVpnRouteGateway()
+        => string.IsNullOrWhiteSpace(_vpnGatewayIp) ? "0.0.0.0" : _vpnGatewayIp;
+
     /// <summary>
     /// Remove default routes (0.0.0.0/0) on the VPN interface so only
     /// explicitly added /32 host routes use the tunnel. Without this,
@@ -357,7 +386,7 @@ public partial class TrafficRouterService
     /// </summary>
     private bool TryAddRouteViaCommandLine(IPAddress dstIp)
     {
-        var gateway = string.IsNullOrWhiteSpace(_vpnGatewayIp) ? "0.0.0.0" : _vpnGatewayIp;
+        var gateway = GetVpnRouteGateway();
         var ok = TryRunRouteCommand($"add {dstIp} mask 255.255.255.255 {gateway} IF {_vpnInterfaceIndex} METRIC 1", out var stderr);
         if (!ok && Interlocked.Read(ref _statRoutesFailed) <= 10)
             Logger.Warning($"[ROUTE!] route.exe add {dstIp} via {gateway} stderr='{stderr.Trim()}'");

AppTunnel/Views/HelpTabView.xaml

@@ -3,13 +3,52 @@
              xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
              xmlns:services="clr-namespace:AppTunnel.Services">
 
+    <UserControl.Resources>
+        <Style x:Key="HelpCard" TargetType="Border" BasedOn="{StaticResource CardPanel}">
+            <Setter Property="Padding" Value="14,12"/>
+            <Setter Property="Margin" Value="0,0,0,10"/>
+        </Style>
+
+        <Style x:Key="HelpTitle" TargetType="TextBlock">
+            <Setter Property="FontSize" Value="14"/>
+            <Setter Property="FontWeight" Value="SemiBold"/>
+            <Setter Property="Foreground" Value="{StaticResource TextPrimaryBrush}"/>
+            <Setter Property="Margin" Value="0,0,0,6"/>
+        </Style>
+
+        <Style x:Key="HelpBody" TargetType="TextBlock">
+            <Setter Property="FontSize" Value="11"/>
+            <Setter Property="LineHeight" Value="18"/>
+            <Setter Property="TextWrapping" Value="Wrap"/>
+            <Setter Property="Foreground" Value="{StaticResource TextSecondaryBrush}"/>
+        </Style>
+
+        <Style x:Key="HelpChip" TargetType="Border">
+            <Setter Property="Background" Value="#0EFFFFFF"/>
+            <Setter Property="BorderBrush" Value="#14FFFFFF"/>
+            <Setter Property="BorderThickness" Value="1"/>
+            <Setter Property="CornerRadius" Value="9"/>
+            <Setter Property="Padding" Value="10,8"/>
+        </Style>
+
+        <Style x:Key="HelpExpander" TargetType="Expander">
+            <Setter Property="Foreground" Value="{StaticResource TextPrimaryBrush}"/>
+            <Setter Property="Background" Value="Transparent"/>
+            <Setter Property="BorderBrush" Value="#14FFFFFF"/>
+            <Setter Property="BorderThickness" Value="0,1,0,0"/>
+            <Setter Property="Padding" Value="0"/>
+            <Setter Property="Margin" Value="0,4,0,0"/>
+            <Setter Property="FontSize" Value="12"/>
+        </Style>
+    </UserControl.Resources>
+
     <ScrollViewer VerticalScrollBarVisibility="Auto"
                   HorizontalScrollBarVisibility="Disabled"
-                  Padding="0,14,0,12">
-        <StackPanel Margin="16,0">
+                  Padding="0,12,0,10">
+        <StackPanel Margin="14,0">
 
-            <!-- Overview -->
-            <Border Style="{StaticResource CardPanel}">
+            <!-- Header -->
+            <Border Style="{StaticResource HelpCard}">
                 <Grid>
                     <Grid.ColumnDefinitions>
                         <ColumnDefinition Width="*"/>
@@ -17,23 +56,22 @@
                     </Grid.ColumnDefinitions>
 
                     <StackPanel Grid.Column="0">
-                        <TextBlock Text="TunnelX"
-                                   FontSize="22"
+                        <TextBlock Text="راهنمای TunnelX"
+                                   FontSize="20"
                                    FontWeight="Bold"
                                    Foreground="{StaticResource TextPrimaryBrush}"/>
-                        <TextBlock Text="Split tunneling برای برنامه‌ها، مقصدها و حالت کل سیستم"
-                                   FontSize="11"
-                                   Foreground="{StaticResource TextSecondaryBrush}"
+                        <TextBlock Text="شروع سریع، پروفایل‌ها، بخش‌های اپ و عیب‌یابی در یک صفحه ساده."
+                                   Style="{StaticResource HelpBody}"
                                    Margin="0,4,0,0"/>
                     </StackPanel>
 
                     <Border Grid.Column="1"
-                            Background="#1AE8803A"
+                            Background="#14E8803A"
                             CornerRadius="8"
-                            Padding="10,5"
-                            VerticalAlignment="Center">
+                            Padding="9,4"
+                            VerticalAlignment="Top">
                         <TextBlock Text="{x:Static services:AppInfo.VersionText}"
-                                   FontSize="12"
+                                   FontSize="11"
                                    FontWeight="SemiBold"
                                    Foreground="{StaticResource AccentBrush}"
                                    FlowDirection="LeftToRight"/>
@@ -41,106 +79,162 @@
                 </Grid>
             </Border>
 
-            <!-- Project + Support -->
-            <Border Style="{StaticResource CardPanel}">
+            <!-- Primary Actions -->
+            <Border Style="{StaticResource HelpCard}">
                 <Grid>
                     <Grid.ColumnDefinitions>
                         <ColumnDefinition Width="*"/>
-                        <ColumnDefinition Width="12"/>
+                        <ColumnDefinition Width="10"/>
                         <ColumnDefinition Width="Auto"/>
                     </Grid.ColumnDefinitions>
 
                     <StackPanel Grid.Column="0">
-                        <TextBlock Style="{StaticResource SectionHeader}" Text="پروژه آزاد و حمایت"/>
-                        <TextBlock Text="{Binding AppCreatorText}"
-                                   FontSize="11"
-                                   Foreground="{StaticResource TextPrimaryBrush}"
-                                   Margin="0,0,0,4"/>
-                        <TextBlock Text="{Binding AppGitHubUrl}"
-                                   FontSize="10"
-                                   Foreground="{StaticResource AccentBrush}"
-                                   FlowDirection="LeftToRight"
-                                   TextWrapping="Wrap"/>
+                        <TextBlock Text="پروژه و بروزرسانی" Style="{StaticResource HelpTitle}"/>
+                        <TextBlock Text="{Binding UpdateStatusText}"
+                                   Style="{StaticResource HelpBody}"/>
                         <TextBlock Text="{Binding AppLicenseText, StringFormat=لایسنس: {0}}"
                                    FontSize="10"
                                    Foreground="{StaticResource TextSecondaryBrush}"
                                    FlowDirection="LeftToRight"
                                    Margin="0,5,0,0"/>
-                        <TextBlock Text="{Binding DonatePayPalText}"
-                                   FontSize="10"
-                                   Foreground="{StaticResource TextSecondaryBrush}"
-                                   FlowDirection="LeftToRight"
-                                   Margin="0,5,0,0"/>
-                        <TextBlock Text="{Binding CryptoDonationText}"
-                                   FontSize="10"
-                                   Foreground="{StaticResource TextSecondaryBrush}"
-                                   FontFamily="Consolas"
-                                   FlowDirection="LeftToRight"
-                                   TextWrapping="Wrap"
-                                   Margin="0,5,0,0"/>
                     </StackPanel>
 
                     <StackPanel Grid.Column="2"
                                 Orientation="Vertical"
-                                VerticalAlignment="Center"
-                                MinWidth="150">
-                        <Button Style="{StaticResource SecondaryButton}"
-                                Content="باز کردن گیت‌هاب"
-                                Command="{Binding OpenGitHubCommand}"
-                                Padding="14,8"/>
+                                MinWidth="145"
+                                VerticalAlignment="Center">
                         <Button Style="{StaticResource PrimaryButton}"
-                                Content="حمایت با پی‌پل"
-                                Command="{Binding OpenDonateCommand}"
-                                Padding="16,8"
-                                Margin="0,8,0,0"/>
-                        <Button Style="{StaticResource SecondaryButton}"
-                                Content="کپی اطلاعات حمایت"
-                                Command="{Binding CopyDonationInfoCommand}"
-                                Padding="14,8"
-                                Margin="0,8,0,0"/>
-                    </StackPanel>
-                </Grid>
-            </Border>
-
-            <!-- Updates -->
-            <Border Style="{StaticResource CardPanel}">
-                <Grid>
-                    <Grid.ColumnDefinitions>
-                        <ColumnDefinition Width="*"/>
-                        <ColumnDefinition Width="12"/>
-                        <ColumnDefinition Width="Auto"/>
-                    </Grid.ColumnDefinitions>
-
-                    <StackPanel Grid.Column="0">
-                        <TextBlock Style="{StaticResource SectionHeader}" Text="بروزرسانی"/>
-                        <TextBlock Text="{Binding UpdateStatusText}"
-                                   FontSize="11"
-                                   Foreground="{StaticResource TextSecondaryBrush}"
-                                   TextWrapping="Wrap"
-                                   LineHeight="18"/>
-                    </StackPanel>
-
-                    <StackPanel Grid.Column="2"
-                                Orientation="Vertical"
-                                VerticalAlignment="Center"
-                                MinWidth="150">
-                        <Button Style="{StaticResource SecondaryButton}"
                                 Content="{Binding UpdateButtonText}"
                                 Command="{Binding CheckForUpdatesCommand}"
-                                Padding="14,8"/>
-                        <Button Style="{StaticResource PrimaryButton}"
-                                Content="باز کردن صفحه انتشار"
+                                FontSize="11"
+                                Padding="12,7"/>
+                        <Button Style="{StaticResource SecondaryButton}"
+                                Content="صفحه انتشار"
                                 Command="{Binding OpenLatestReleaseCommand}"
-                                Padding="14,8"
-                                Margin="0,8,0,0"/>
+                                FontSize="11"
+                                Padding="12,7"
+                                Margin="0,6,0,0"/>
+                        <Button Style="{StaticResource SecondaryButton}"
+                                Content="GitHub"
+                                Command="{Binding OpenGitHubCommand}"
+                                FontSize="11"
+                                Padding="12,7"
+                                Margin="0,6,0,0"/>
                     </StackPanel>
                 </Grid>
             </Border>
 
-            <!-- Quick Path -->
-            <Border Style="{StaticResource CardPanel}">
+            <!-- Quick Start -->
+            <Border Style="{StaticResource HelpCard}">
                 <StackPanel>
-                    <TextBlock Style="{StaticResource SectionHeader}" Text="شروع سریع"/>
+                    <TextBlock Text="شروع سریع" Style="{StaticResource HelpTitle}"/>
+                    <UniformGrid Columns="2" Rows="2">
+                        <Border Style="{StaticResource HelpChip}" Margin="0,0,5,5">
+                            <StackPanel>
+                                <TextBlock Text="۱. پروفایل" FontSize="12" FontWeight="SemiBold"
+                                           Foreground="{StaticResource TextPrimaryBrush}"/>
+                                <TextBlock Text="کانفیگ را بسازید و نوع اتصال را انتخاب کنید."
+                                           Style="{StaticResource HelpBody}" FontSize="10" Margin="0,3,0,0"/>
+                            </StackPanel>
+                        </Border>
+                        <Border Style="{StaticResource HelpChip}" Margin="5,0,0,5">
+                            <StackPanel>
+                                <TextBlock Text="۲. برنامه‌ها" FontSize="12" FontWeight="SemiBold"
+                                           Foreground="{StaticResource TextPrimaryBrush}"/>
+                                <TextBlock Text="برنامه‌های داخل تونل را انتخاب یا دستی اضافه کنید."
+                                           Style="{StaticResource HelpBody}" FontSize="10" Margin="0,3,0,0"/>
+                            </StackPanel>
+                        </Border>
+                        <Border Style="{StaticResource HelpChip}" Margin="0,5,5,0">
+                            <StackPanel>
+                                <TextBlock Text="۳. قوانین" FontSize="12" FontWeight="SemiBold"
+                                           Foreground="{StaticResource TextPrimaryBrush}"/>
+                                <TextBlock Text="مقصدهای مستقیم یا اجباری را مشخص کنید."
+                                           Style="{StaticResource HelpBody}" FontSize="10" Margin="0,3,0,0"/>
+                            </StackPanel>
+                        </Border>
+                        <Border Style="{StaticResource HelpChip}" Margin="5,5,0,0">
+                            <StackPanel>
+                                <TextBlock Text="۴. اتصال" FontSize="12" FontWeight="SemiBold"
+                                           Foreground="{StaticResource TextPrimaryBrush}"/>
+                                <TextBlock Text="وصل شوید و سلامت، IP و مصرف را بررسی کنید."
+                                           Style="{StaticResource HelpBody}" FontSize="10" Margin="0,3,0,0"/>
+                            </StackPanel>
+                        </Border>
+                    </UniformGrid>
+                </StackPanel>
+            </Border>
+
+            <!-- Profile Types -->
+            <Border Style="{StaticResource HelpCard}">
+                <StackPanel>
+                    <TextBlock Text="نوع پروفایل" Style="{StaticResource HelpTitle}"/>
+                    <TextBlock Text="فقط فیلدهای مربوط به نوع انتخاب‌شده را پر کنید. هر پروفایل برنامه‌ها و قوانین مسیر خودش را نگه می‌دارد."
+                               Style="{StaticResource HelpBody}"/>
+
+                    <Expander Header="L2TP/IPsec" Style="{StaticResource HelpExpander}">
+                        <TextBlock Text="برای اتصال VPN ویندوز. آدرس سرور، نام کاربری، رمز عبور و Pre-Shared Key لازم است. اگر وصل نشد، PSK، فایروال و تنظیمات VPN ویندوز را بررسی کنید."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
+
+                    <Expander Header="V2Ray / Xray" Style="{StaticResource HelpExpander}">
+                        <TextBlock Text="لینک یا JSON کانفیگ را وارد کنید یا از کلیپ‌بورد پیست کنید. TunnelX معمولاً sing-box را اجرا می‌کند و برای قابلیت‌هایی مثل xhttp از Xray-core استفاده می‌کند."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
+
+                    <Expander Header="SOCKS5 / HTTP Proxy" Style="{StaticResource HelpExpander}">
+                        <TextBlock Text="برای پراکسی خارجی آماده. نوع پراکسی، آدرس، پورت و در صورت نیاز نام کاربری/رمز را وارد کنید. این با پراکسی داخلی 127.0.0.1 فرق دارد."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
+
+                    <Expander Header="OpenVPN" Style="{StaticResource HelpExpander}">
+                        <TextBlock Text="فایل ovpn را انتخاب کنید. OpenVPN Community باید جداگانه نصب باشد؛ OpenVPN Connect برای Split Tunneling مناسب نیست. اگر سرور رمز می‌خواهد، نام کاربری و رمز را در TunnelX وارد کنید."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
+                </StackPanel>
+            </Border>
+
+            <!-- App Areas -->
+            <Border Style="{StaticResource HelpCard}">
+                <StackPanel>
+                    <TextBlock Text="بخش‌های اپ" Style="{StaticResource HelpTitle}"/>
+
+                    <Expander Header="اتصال VPN" Style="{StaticResource HelpExpander}" IsExpanded="True">
+                        <TextBlock Text="پروفایل فعال، تست سرور، اتصال/قطع اتصال، IP خروجی، پینگ، مصرف و راهنمای پراکسی دستی اینجاست."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
+
+                    <Expander Header="برنامه‌ها" Style="{StaticResource HelpExpander}">
+                        <TextBlock Text="از لیست برنامه‌های پیدا شده انتخاب کنید یا فایل exe را دستی اضافه کنید. برای Store/MSIX/WebView2 برنامه را باز نگه دارید و بروزرسانی لیست را بزنید."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
+
+                    <Expander Header="قوانین مسیر" Style="{StaticResource HelpExpander}">
+                        <TextBlock Text="«مستقیم بماند» یعنی مقصد از تونل عبور نکند. «از تونل عبور کند» یعنی مقصد حتی بدون انتخاب برنامه وارد تونل شود. دامنه‌ها زیردامنه‌ها را هم پوشش می‌دهند."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
+
+                    <Expander Header="تنظیمات" Style="{StaticResource HelpExpander}">
+                        <TextBlock Text="پورت پراکسی محلی، MTU خودکار، DNS Optimization، Game Mode، اجرای خودکار ویندوز و اتصال خودکار اینجاست."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
+
+                    <Expander Header="ترافیک و تاریخچه" Style="{StaticResource HelpExpander}">
+                        <TextBlock Text="مدت اتصال، IP، مصرف تونل، مصرف خارج تونل، سلامت Split Tunnel، مصرف برنامه‌ها و تاریخچه اتصال‌ها را نشان می‌دهد."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
+
+                    <Expander Header="جزئیات و لاگ‌ها" Style="{StaticResource HelpExpander}">
+                        <TextBlock Text="از دکمه جزئیات، لاگ‌ها را با فیلتر خطا، هشدار، DNS یا Route ببینید. قبل از ارسال عمومی لاگ، رمزها، کلیدها، UUID و endpoint خصوصی را حذف کنید."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
+                </StackPanel>
+            </Border>
+
+            <!-- Essentials -->
+            <Border Style="{StaticResource HelpCard}">
+                <StackPanel>
+                    <TextBlock Text="نکات مهم" Style="{StaticResource HelpTitle}"/>
                     <Grid>
                         <Grid.ColumnDefinitions>
                             <ColumnDefinition Width="*"/>
@@ -153,206 +247,89 @@
                             <RowDefinition Height="Auto"/>
                         </Grid.RowDefinitions>
 
-                        <Border Grid.Row="0" Grid.Column="0" Background="#11FFFFFF" CornerRadius="8" Padding="12,10">
+                        <Border Grid.Row="0" Grid.Column="0" Style="{StaticResource HelpChip}">
+                            <TextBlock Text="حالت عادی: فقط برنامه‌های انتخاب‌شده و مقصدهای لزومی وارد تونل می‌شوند."
+                                       Style="{StaticResource HelpBody}" FontSize="10"/>
+                        </Border>
+                        <Border Grid.Row="0" Grid.Column="2" Style="{StaticResource HelpChip}">
+                            <TextBlock Text="Full Route: کل سیستم وارد تونل می‌شود؛ استثناها می‌توانند مستقیم بمانند."
+                                       Style="{StaticResource HelpBody}" FontSize="10"/>
+                        </Border>
+                        <Border Grid.Row="2" Grid.Column="0" Style="{StaticResource HelpChip}">
                             <StackPanel>
-                                <TextBlock Text="۱. پروفایل" FontSize="12" FontWeight="SemiBold"
+                                <TextBlock Text="پراکسی داخلی"
+                                           FontSize="11"
+                                           FontWeight="SemiBold"
                                            Foreground="{StaticResource TextPrimaryBrush}"/>
-                                <TextBlock Text="نوع اتصال را انتخاب کنید: L2TP، V2Ray/Xray یا اوپن‌وی‌پی‌ان. برای اسپلیت اوپن‌وی‌پی‌ان، نسخه Community لازم است؛ فایل .ovpn را انتخاب کنید و نام کاربری/رمز را در TunnelX وارد کنید."
-                                           FontSize="10" TextWrapping="Wrap"
-                                           Foreground="{StaticResource TextSecondaryBrush}" Margin="0,5,0,0"/>
+                                <TextBlock Text="برای ابزارهایی که آدرس محلی می‌خواهند:"
+                                           Style="{StaticResource HelpBody}" FontSize="10" Margin="0,3,0,0"/>
+                                <TextBlock Text="127.0.0.1:1080"
+                                           FontSize="11"
+                                           FontFamily="Consolas"
+                                           Foreground="{StaticResource AccentBrush}"
+                                           FlowDirection="LeftToRight"
+                                           Margin="0,3,0,0"/>
                             </StackPanel>
                         </Border>
-
-                        <Border Grid.Row="0" Grid.Column="2" Background="#11FFFFFF" CornerRadius="8" Padding="12,10">
-                            <StackPanel>
-                                <TextBlock Text="۲. تست سرور" FontSize="12" FontWeight="SemiBold"
-                                           Foreground="{StaticResource TextPrimaryBrush}"/>
-                                <TextBlock Text="قبل از اتصال، تست سرور را بزنید. برای TLS، handshake واقعی اندازه‌گیری می‌شود."
-                                           FontSize="10" TextWrapping="Wrap"
-                                           Foreground="{StaticResource TextSecondaryBrush}" Margin="0,5,0,0"/>
-                            </StackPanel>
-                        </Border>
-
-                        <Border Grid.Row="2" Grid.Column="0" Background="#11FFFFFF" CornerRadius="8" Padding="12,10">
-                            <StackPanel>
-                                <TextBlock Text="۳. برنامه‌ها" FontSize="12" FontWeight="SemiBold"
-                                           Foreground="{StaticResource TextPrimaryBrush}"/>
-                                <TextBlock Text="برنامه‌هایی که باید از تونل عبور کنند را در تب برنامه‌ها فعال کنید."
-                                           FontSize="10" TextWrapping="Wrap"
-                                           Foreground="{StaticResource TextSecondaryBrush}" Margin="0,5,0,0"/>
-                            </StackPanel>
-                        </Border>
-
-                        <Border Grid.Row="2" Grid.Column="2" Background="#11FFFFFF" CornerRadius="8" Padding="12,10">
-                            <StackPanel>
-                                <TextBlock Text="۴. اتصال" FontSize="12" FontWeight="SemiBold"
-                                           Foreground="{StaticResource TextPrimaryBrush}"/>
-                                <TextBlock Text="بعد از اتصال، کارت سلامت ترافیک را برای Leak، DNS، IPv6 و Route بررسی کنید."
-                                           FontSize="10" TextWrapping="Wrap"
-                                           Foreground="{StaticResource TextSecondaryBrush}" Margin="0,5,0,0"/>
-                            </StackPanel>
+                        <Border Grid.Row="2" Grid.Column="2" Style="{StaticResource HelpChip}">
+                            <TextBlock Text="سلامت: Leak باید صفر باشد. DNS، IPv6 و Route را بعد از اتصال بررسی کنید."
+                                       Style="{StaticResource HelpBody}" FontSize="10"/>
                         </Border>
                     </Grid>
                 </StackPanel>
             </Border>
 
-            <!-- Connection Types -->
-            <Border Style="{StaticResource CardPanel}">
+            <!-- Troubleshooting -->
+            <Border Style="{StaticResource HelpCard}">
                 <StackPanel>
-                    <TextBlock Style="{StaticResource SectionHeader}" Text="راهنمای نوع اتصال"/>
-                    <TextBlock Text="L2TP/IPsec"
-                               FontSize="12"
-                               FontWeight="SemiBold"
-                               Foreground="{StaticResource TextPrimaryBrush}"/>
-                    <TextBlock Text="آدرس سرور، نام کاربری، رمز عبور و Pre-Shared Key را وارد کنید؛ TunnelX اتصال ویندوز را ایجاد و مسیرها را مدیریت می‌کند."
-                               FontSize="11"
-                               LineHeight="18"
-                               TextWrapping="Wrap"
-                               Foreground="{StaticResource TextSecondaryBrush}"
-                               Margin="0,4,0,10"/>
+                    <TextBlock Text="عیب‌یابی سریع" Style="{StaticResource HelpTitle}"/>
 
-                    <TextBlock Text="V2Ray / Xray"
-                               FontSize="12"
-                               FontWeight="SemiBold"
-                               Foreground="{StaticResource TextPrimaryBrush}"/>
-                    <TextBlock Text="لینک یا کانفیگ V2Ray/Xray را در فیلد کانفیگ وارد کنید. TunnelX با sing-box/Xray تونل را بالا می‌آورد و برنامه‌های انتخابی را از آن عبور می‌دهد."
-                               FontSize="11"
-                               LineHeight="18"
-                               TextWrapping="Wrap"
-                               Foreground="{StaticResource TextSecondaryBrush}"
-                               Margin="0,4,0,10"/>
+                    <Expander Header="اتصال برقرار نمی‌شود" Style="{StaticResource HelpExpander}">
+                        <TextBlock Text="برنامه را با Administrator اجرا کنید. فایروال، آنتی‌ویروس، آدرس سرور، پورت، رمزها، PSK، نصب OpenVPN Community و اعتبار کانفیگ را بررسی کنید."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
 
-                    <TextBlock Text="OpenVPN"
-                               FontSize="12"
-                               FontWeight="SemiBold"
-                               Foreground="{StaticResource TextPrimaryBrush}"/>
-                    <TextBlock Text="TunnelX فایل اوپن‌وی‌پی‌ان را همراه خود توزیع نمی‌کند. برای اسپلیت‌تانلینگ باید نسخه Community نصب باشد، چون TunnelX باید فایل openvpn.exe را با کانفیگ سازگار با اسپلیت اجرا کند. نسخه Connect معمولاً مسیر و DNS را خودش تغییر می‌دهد و برای جدا کردن ترافیک برنامه‌ها مناسب نیست. در تب اتصال فایل .ovpn را انتخاب کنید و اگر سرور نیاز دارد، نام کاربری و رمز را در TunnelX وارد کنید."
-                               FontSize="11"
-                               LineHeight="18"
-                               TextWrapping="Wrap"
-                               Foreground="{StaticResource TextSecondaryBrush}"
-                               Margin="0,4,0,0"/>
+                    <Expander Header="ترافیک برنامه از تونل عبور نمی‌کند" Style="{StaticResource HelpExpander}">
+                        <TextBlock Text="برنامه را در تب برنامه‌ها فعال کنید. اگر چندپردازشی است، برنامه را باز نگه دارید و لیست برنامه‌ها را دوباره بارگذاری کنید."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
+
+                    <Expander Header="پراکسی کار نمی‌کند" Style="{StaticResource HelpExpander}">
+                        <TextBlock Text="برای پروفایل پراکسی، آدرس، پورت، نوع و اطلاعات ورود را بررسی کنید. برای ابزارهای محلی، آدرس 127.0.0.1 و پورت تنظیمات را وارد کنید."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
+
+                    <Expander Header="DNS، IPv6 یا Leak غیرعادی است" Style="{StaticResource HelpExpander}">
+                        <TextBlock Text="یک بار قطع و وصل کنید تا مسیرها و قوانین DNS دوباره ساخته شوند. اگر مشکل ماند، لاگ‌های DNS و Route را بررسی کنید."
+                                   Style="{StaticResource HelpBody}" Margin="0,8,0,0"/>
+                    </Expander>
                 </StackPanel>
             </Border>
 
-            <!-- Modes -->
-            <Grid>
-                <Grid.ColumnDefinitions>
-                    <ColumnDefinition Width="*"/>
-                    <ColumnDefinition Width="8"/>
-                    <ColumnDefinition Width="*"/>
-                </Grid.ColumnDefinitions>
-
-                <Border Grid.Column="0" Style="{StaticResource CardPanel}">
-                    <StackPanel>
-                        <TextBlock Style="{StaticResource SectionHeader}" Text="حالت انتخابی"/>
-                        <TextBlock Text="فقط برنامه‌های انتخاب‌شده و مقصدهای لزومی از تونل عبور می‌کنند. این حالت برای مصرف کمتر و کنترل دقیق‌تر پیشنهاد می‌شود."
-                                   FontSize="11"
-                                   LineHeight="19"
-                                   TextWrapping="Wrap"
-                                   Foreground="{StaticResource TextSecondaryBrush}"/>
-                    </StackPanel>
-                </Border>
-
-                <Border Grid.Column="2" Style="{StaticResource CardPanel}">
-                    <StackPanel>
-                        <TextBlock Style="{StaticResource SectionHeader}" Text="عبور کل سیستم"/>
-                        <TextBlock Text="وقتی Full Route روشن باشد، کل ترافیک ویندوز از تونل عبور می‌کند. برای تست یا زمانی که همه برنامه‌ها باید VPN داشته باشند مناسب است."
-                                   FontSize="11"
-                                   LineHeight="19"
-                                   TextWrapping="Wrap"
-                                   Foreground="{StaticResource TextSecondaryBrush}"/>
-                    </StackPanel>
-                </Border>
-            </Grid>
-
-            <!-- Rules + Apps -->
-            <Grid>
-                <Grid.ColumnDefinitions>
-                    <ColumnDefinition Width="*"/>
-                    <ColumnDefinition Width="8"/>
-                    <ColumnDefinition Width="*"/>
-                </Grid.ColumnDefinitions>
-
-                <Border Grid.Column="0" Style="{StaticResource CardPanel}">
-                    <StackPanel>
-                        <TextBlock Style="{StaticResource SectionHeader}" Text="برنامه‌ها"/>
-                        <TextBlock TextWrapping="Wrap" FontSize="11" LineHeight="19"
-                                   Foreground="{StaticResource TextSecondaryBrush}">
-برنامه‌های Store/MSIX و WebView2 ممکن است چند پردازش داشته باشند. اگر اپی دیده نشد، آن را باز کنید و دوباره بارگذاری برنامه‌ها را بزنید.
-                        </TextBlock>
-                    </StackPanel>
-                </Border>
-
-                <Border Grid.Column="2" Style="{StaticResource CardPanel}">
-                    <StackPanel>
-                        <TextBlock Style="{StaticResource SectionHeader}" Text="قوانین مسیر"/>
-                        <TextBlock TextWrapping="Wrap" FontSize="11" LineHeight="19"
-                                   Foreground="{StaticResource TextSecondaryBrush}">
-استثناها مقصد را مستقیم نگه می‌دارند. لزومی‌ها مقصد را حتی بدون انتخاب برنامه از تونل عبور می‌دهند. دامنه، IP و URL قابل استفاده است.
-                        </TextBlock>
-                    </StackPanel>
-                </Border>
-            </Grid>
-
-            <!-- Local Proxy + Diagnostics -->
-            <Grid>
-                <Grid.ColumnDefinitions>
-                    <ColumnDefinition Width="*"/>
-                    <ColumnDefinition Width="8"/>
-                    <ColumnDefinition Width="*"/>
-                </Grid.ColumnDefinitions>
-
-                <Border Grid.Column="0" Style="{StaticResource CardPanel}">
-                    <StackPanel>
-                        <TextBlock Style="{StaticResource SectionHeader}" Text="SOCKS5 داخلی"/>
-                        <TextBlock TextWrapping="Wrap" FontSize="11" LineHeight="19"
-                                   Foreground="{StaticResource TextSecondaryBrush}">
-پروکسی داخلی روی 127.0.0.1 اجرا می‌شود. پورت را قبل از اتصال انتخاب کنید؛ پورت‌های سیستم، رزرو و پورت‌های رایج توسعه محدود شده‌اند.
-                        </TextBlock>
-                        <Border Background="#11FFFFFF" CornerRadius="6" Padding="8" Margin="0,8,0,0">
-                            <TextBlock Text="127.0.0.1:1080"
-                                       FontSize="11"
-                                       FontFamily="Consolas"
-                                       Foreground="{StaticResource AccentBrush}"
-                                       FlowDirection="LeftToRight"/>
-                        </Border>
-                    </StackPanel>
-                </Border>
-
-                <Border Grid.Column="2" Style="{StaticResource CardPanel}">
-                    <StackPanel>
-                        <TextBlock Style="{StaticResource SectionHeader}" Text="کارت سلامت"/>
-                        <TextBlock TextWrapping="Wrap" FontSize="11" LineHeight="19"
-                                   Foreground="{StaticResource TextSecondaryBrush}">
-Leak باید صفر باشد. DNS نشان می‌دهد درخواست‌های DNS هدایت شده‌اند. IPv6 blocked یعنی مسیرهای IPv6 ناخواسته بسته شده‌اند. Route تعداد مسیرهای فعال و خطاها را نشان می‌دهد.
-                        </TextBlock>
-                    </StackPanel>
-                </Border>
-            </Grid>
-
-            <!-- Troubleshooting -->
-            <Border Style="{StaticResource CardPanel}">
+            <!-- Support -->
+            <Border Style="{StaticResource HelpCard}">
                 <StackPanel>
-                    <TextBlock Style="{StaticResource SectionHeader}" Text="عیب‌یابی سریع"/>
-
-                    <Expander Header="اتصال برقرار نمی‌شود" Foreground="{StaticResource TextPrimaryBrush}" Margin="0,4,0,0">
-                        <TextBlock Text="دسترسی Administrator، فایروال، پورت SOCKS5 و صحت کانفیگ را بررسی کنید. در کانفیگ‌های xhttp، هسته باید Xray باشد."
-                                   TextWrapping="Wrap" FontSize="11" LineHeight="19"
-                                   Foreground="{StaticResource TextSecondaryBrush}" Margin="0,8,0,0"/>
-                    </Expander>
-
-                    <Expander Header="ترافیک برنامه از تونل عبور نمی‌کند" Foreground="{StaticResource TextPrimaryBrush}" Margin="0,8,0,0">
-                        <TextBlock Text="برنامه را در تب برنامه‌ها فعال کنید. برای اپ‌های Store، برنامه را باز نگه دارید و لیست برنامه‌ها را دوباره بارگذاری کنید."
-                                   TextWrapping="Wrap" FontSize="11" LineHeight="19"
-                                   Foreground="{StaticResource TextSecondaryBrush}" Margin="0,8,0,0"/>
-                    </Expander>
-
-                    <Expander Header="سایت داخلی باید مستقیم باز شود" Foreground="{StaticResource TextPrimaryBrush}" Margin="0,8,0,0">
-                        <TextBlock Text="دامنه یا IP را به استثناها اضافه کنید. برای عبور اجباری یک مقصد از VPN، آن را به لزومی‌ها اضافه کنید."
-                                   TextWrapping="Wrap" FontSize="11" LineHeight="19"
-                                   Foreground="{StaticResource TextSecondaryBrush}" Margin="0,8,0,0"/>
-                    </Expander>
+                    <TextBlock Text="حمایت و تماس" Style="{StaticResource HelpTitle}"/>
+                    <TextBlock Text="{Binding AppCreatorText}" Style="{StaticResource HelpBody}"/>
+                    <TextBlock Text="{Binding AppGitHubUrl}"
+                               FontSize="10"
+                               Foreground="{StaticResource AccentBrush}"
+                               FlowDirection="LeftToRight"
+                               TextWrapping="Wrap"
+                               Margin="0,5,0,0"/>
+                    <StackPanel Orientation="Horizontal" Margin="0,10,0,0">
+                        <Button Style="{StaticResource SecondaryButton}"
+                                Content="حمایت با پی‌پل"
+                                Command="{Binding OpenDonateCommand}"
+                                FontSize="11"
+                                Padding="12,7"/>
+                        <Button Style="{StaticResource SecondaryButton}"
+                                Content="کپی اطلاعات حمایت"
+                                Command="{Binding CopyDonationInfoCommand}"
+                                FontSize="11"
+                                Padding="12,7"
+                                Margin="8,0,0,0"/>
+                    </StackPanel>
                 </StackPanel>
             </Border>
 

CHANGELOG.md

@@ -6,6 +6,30 @@
 
 ### فارسی
 
+## 1.2.29 - 2026-05-17
+
+### English
+
+- Expanded the GitHub README with Russian and Simplified Chinese summaries for international users.
+- Expanded the in-app Persian Help tab with fuller guidance for profiles, connection types, routing rules, logs, updates, and troubleshooting.
+
+### فارسی
+
+- توضیح‌های روسی و چینی ساده‌شده به README گیت‌هاب اضافه شد تا کاربران بین‌المللی سریع‌تر با کاربرد برنامه آشنا شوند.
+- تب راهنمای فارسی داخل برنامه با توضیح کامل‌تر درباره پروفایل‌ها، نوع‌های اتصال، قوانین مسیر، لاگ‌ها، بروزرسانی و عیب‌یابی گسترش پیدا کرد.
+
+## 1.2.28 - 2026-05-17
+
+### English
+
+- Fixed Full Route default-route installation by preferring the VPN gateway, retrying with an on-link gateway when needed, and cleaning up the pinned physical route to the tunnel server when Full Route is disabled.
+- Updated English/Persian README and in-app Help content for the new SOCKS/Proxy profile flow, connection types, routing notes, local data, and troubleshooting guidance.
+
+### فارسی
+
+- نصب default route در حالت Full Route اصلاح شد؛ ابتدا gateway تونل استفاده می‌شود، در صورت نیاز با gateway روی‌لینک دوباره تلاش می‌شود، و route فیزیکی ثابت‌شده برای سرور تونل هنگام خاموش شدن Full Route پاک‌سازی می‌شود.
+- README فارسی/انگلیسی و محتوای راهنمای داخل برنامه برای جریان جدید SOCKS/Proxy، نوع‌های اتصال، نکته‌های مسیر، داده‌های محلی و عیب‌یابی به‌روز شد.
+
 ## 1.2.27 - 2026-05-17
 
 ### English

README.fa.md

@@ -2,7 +2,7 @@
 
 # TunnelX
 
-فارسی | <span dir="ltr">[English](README.md)</span>
+فارسی | <span dir="ltr">[English](README.md)</span> | <span dir="ltr">[Русский](README.md#русский)</span> | <span dir="ltr">[简体中文](README.md#简体中文)</span>
 
 <span dir="ltr">TunnelX</span> یک نرم‌افزار آزاد و رایگان برای ویندوز است که توسط **<span dir="ltr">MaxFan</span>** ساخته شده و برای مدیریت تونل، وی‌پی‌ان و <span dir="ltr">Split Tunneling</span> استفاده می‌شود. این برنامه می‌تواند ترافیک برنامه‌های انتخاب‌شده، مقصدهای مشخص، یا کل سیستم را از تونل عبور دهد و هم‌زمان مسیر عادی شبکه را برای مقصدهای محلی یا مستثنی‌شده حفظ کند.
 
@@ -14,22 +14,69 @@
 
 - <span dir="ltr">Split tunneling</span> بر اساس برنامه‌های انتخاب‌شده در ویندوز
 - حالت <span dir="ltr">Full-route</span> برای تونل کردن کل سیستم
+- پشتیبانی از پروفایل‌های <span dir="ltr">L2TP/IPsec</span> ویندوز
 - پشتیبانی از جریان‌های <span dir="ltr">V2Ray</span> بر پایه <span dir="ltr">Xray-core</span> و <span dir="ltr">sing-box</span>
+- پشتیبانی از پروفایل‌های اختصاصی <span dir="ltr">SOCKS5/HTTP Proxy</span> با سرور، پورت، نام کاربری و رمز عبور جداگانه
 - پشتیبانی از <span dir="ltr">OpenVPN Community</span> با فایل‌های <span dir="ltr">`.ovpn`</span> برای <span dir="ltr">Split tunneling</span> برنامه‌های انتخاب‌شده
 - پروکسی <span dir="ltr">SOCKS5</span> محلی روی <span dir="ltr">`127.0.0.1`</span> برای ابزارهایی که تنظیم پروکسی داخلی دارند
 - تغییر مسیر <span dir="ltr">DNS</span>، مسدودسازی <span dir="ltr">IPv6</span>، محافظ نشت، عیب‌یابی <span dir="ltr">route</span> و تاریخچه مصرف تونل
+- مدیریت چند پروفایل، کپی/ویرایش کانفیگ‌ها، تست سرور، تشخیص <span dir="ltr">IP</span> خروجی و اعلان بروزرسانی
 - رابط کاربری فارسی‌محور برای ویندوز
 
+## شروع سریع
+
+1. آخرین فایل <span dir="ltr">standalone</span> را از بخش <span dir="ltr">GitHub Releases</span> دانلود کنید.
+2. برنامه را با دسترسی <span dir="ltr">Administrator</span> اجرا کنید؛ قابلیت‌های تغییر مسیر، <span dir="ltr">WinDivert</span> و مدیریت ترافیک به سطح دسترسی بالا نیاز دارند.
+3. از تب اتصال، یک کانفیگ جدید بسازید یا کانفیگ موجود را انتخاب کنید.
+4. نوع اتصال را انتخاب کنید: <span dir="ltr">L2TP/IPsec</span>، <span dir="ltr">V2Ray/Xray</span>، <span dir="ltr">SOCKS5/HTTP Proxy</span> یا <span dir="ltr">OpenVPN</span>.
+5. قبل از اتصال، تست سرور را اجرا کنید و سپس برنامه‌هایی را که باید از تونل عبور کنند در تب برنامه‌ها فعال کنید.
+6. در صورت نیاز، مقصدهای لزومی یا استثنا را اضافه کنید و بعد از اتصال کارت سلامت ترافیک، <span dir="ltr">DNS</span>، <span dir="ltr">IPv6</span> و <span dir="ltr">Route</span> را بررسی کنید.
+
+## انواع اتصال
+
+### <span dir="ltr">L2TP/IPsec</span>
+
+برای اتصال‌های <span dir="ltr">L2TP/IPsec</span>، آدرس سرور، نام کاربری، رمز عبور و <span dir="ltr">Pre-Shared Key</span> را وارد کنید. <span dir="ltr">TunnelX</span> اتصال ویندوز را ایجاد می‌کند و سپس مسیرها را بر اساس حالت انتخابی یا <span dir="ltr">Full-route</span> مدیریت می‌کند.
+
+### <span dir="ltr">V2Ray / Xray</span>
+
+لینک یا کانفیگ <span dir="ltr">V2Ray/Xray</span> را در پروفایل وارد کنید. برنامه برای کانفیگ‌های معمول از <span dir="ltr">sing-box</span> استفاده می‌کند و برای کانفیگ‌هایی که به قابلیت‌های خاص <span dir="ltr">Xray</span> مثل <span dir="ltr">xhttp</span> نیاز دارند، <span dir="ltr">Xray-core</span> را انتخاب می‌کند.
+
+### <span dir="ltr">SOCKS5/HTTP Proxy</span>
+
+اگر از پراکسی آماده استفاده می‌کنید، نوع پروفایل <span dir="ltr">SOCKS5/HTTP Proxy</span> را انتخاب کنید و سرور، پورت و در صورت نیاز نام کاربری و رمز عبور را وارد کنید. این حالت برای عبور برنامه‌های انتخاب‌شده از یک پراکسی خارجی مناسب است و با پراکسی محلی <span dir="ltr">`127.0.0.1`</span> تفاوت دارد.
+
 ## پشتیبانی از <span dir="ltr">OpenVPN</span>
 
 <span dir="ltr">TunnelX</span> می‌تواند نسخه نصب‌شده <span dir="ltr">OpenVPN Community</span> و فایل انتخابی <span dir="ltr">`.ovpn`</span> کاربر را اجرا کند و سپس سیاست <span dir="ltr">Split tunneling</span> خودش را اعمال کند؛ یعنی فقط برنامه‌ها و مقصدهای انتخاب‌شده از تونل <span dir="ltr">OpenVPN</span> عبور می‌کنند.
 
 <span dir="ltr">OpenVPN</span> همراه <span dir="ltr">TunnelX</span> توزیع نمی‌شود. برای این حالت باید <span dir="ltr">OpenVPN Community</span> را جداگانه نصب کنید، فایل <span dir="ltr">`.ovpn`</span> را در <span dir="ltr">TunnelX</span> انتخاب کنید و در صورت نیاز نام کاربری و رمز عبور <span dir="ltr">OpenVPN</span> را داخل برنامه وارد کنید. نصب بودن <span dir="ltr">OpenVPN Connect</span> به‌تنهایی برای این حالت کافی نیست، چون آن برنامه مسیرها و <span dir="ltr">DNS</span> را با کلاینت خودش مدیریت می‌کند.
 
+<span dir="ltr">TunnelX</span> برای سازگاری با <span dir="ltr">Split tunneling</span>، تنظیمات مسیر و <span dir="ltr">DNS</span> تحمیلی فایل <span dir="ltr">`.ovpn`</span> را کنترل می‌کند و در صورت تغییر <span dir="ltr">IP</span> تونل، <span dir="ltr">gateway</span>، <span dir="ltr">interface</span> یا مقصد ریموت هنگام <span dir="ltr">reconnect</span>، مسیر‌دهی داخلی خودش را دوباره راه‌اندازی می‌کند.
+
 ## نکته‌های مسیر و دامنه
 
 قانون‌های <span dir="ltr">Include</span> و <span dir="ltr">Exclude</span> هم خود دامنه واردشده و هم زیردامنه‌های آن را پوشش می‌دهند. برای نمونه، افزودن <span dir="ltr">`githubusercontent.com`</span> پس از resolve شدن <span dir="ltr">DNS</span> شامل <span dir="ltr">`raw.githubusercontent.com`</span> هم می‌شود. اگر یک کلاینت <span dir="ltr">HTTPS</span> در مرحله بررسی <span dir="ltr">certificate revocation</span> خطا داد، ممکن است میزبان‌های <span dir="ltr">OCSP/CRL</span> آن از مسیر انتخابی قابل دسترسی نباشند؛ در این حالت خود برنامه دانلودکننده یا دامنه‌های revocation مربوطه را هم در لیست لزومی قرار دهید.
 
+- مقصدهای استثناشده حتی برای برنامه‌های انتخاب‌شده مستقیم می‌مانند.
+- مقصدهای لزومی حتی اگر برنامه مربوطه انتخاب نشده باشد از تونل عبور می‌کنند.
+- برای برنامه‌های <span dir="ltr">Store/MSIX</span>، <span dir="ltr">WebView2</span> یا برنامه‌های چندپردازشی، برنامه را باز نگه دارید و فهرست برنامه‌ها را دوباره بارگذاری کنید.
+- اگر <span dir="ltr">Full-route</span> روشن باشد، کل ترافیک سیستم از تونل عبور می‌کند و قانون‌های مستقیم/استثنا همچنان برای نگه داشتن مقصدهای خاص روی مسیر عادی کاربرد دارند.
+
+## تنظیمات و داده‌های محلی
+
+پروفایل‌ها، برنامه‌های انتخاب‌شده، مقصدهای لزومی/استثنا، تاریخچه اتصال و لاگ‌ها روی دستگاه کاربر نگهداری می‌شوند و معمولاً در مسیر <span dir="ltr">`%LOCALAPPDATA%\TunnelX`</span> یا کنار برنامه قرار می‌گیرند. <span dir="ltr">TunnelX</span> عمداً تحلیل آماری یا <span dir="ltr">telemetry</span> برای نگهدارنده ارسال نمی‌کند.
+
+لاگ‌ها ممکن است شامل نام پردازش‌ها، نام دامنه‌ها، آدرس‌های <span dir="ltr">IP</span>، پورت‌ها و وضعیت اتصال باشند. قبل از ارسال عمومی لاگ در <span dir="ltr">GitHub Issues</span>، اطلاعات حساس مثل آدرس سرور خصوصی، کلیدها، <span dir="ltr">UUID</span>، رمزها و endpointهای شخصی را حذف کنید.
+
+## عیب‌یابی سریع
+
+- اگر اتصال برقرار نمی‌شود، اجرای برنامه با دسترسی <span dir="ltr">Administrator</span>، فایروال، درستی کانفیگ، پورت‌های پراکسی و نصب بودن پیش‌نیازهای مربوط به همان نوع اتصال را بررسی کنید.
+- اگر ترافیک یک برنامه از تونل عبور نمی‌کند، برنامه را در تب برنامه‌ها فعال کنید، برنامه را باز نگه دارید و فهرست برنامه‌ها را دوباره بارگذاری کنید.
+- اگر فقط یک سایت یا دامنه باید از تونل عبور کند، آن را به مقصدهای لزومی اضافه کنید؛ اگر باید مستقیم بماند، آن را به استثناها اضافه کنید.
+- اگر خطای <span dir="ltr">DNS</span> یا <span dir="ltr">IPv6</span> می‌بینید، کارت سلامت بعد از اتصال را بررسی کنید و در صورت نیاز یک‌بار قطع و وصل کنید تا مسیرها و قانون‌های <span dir="ltr">DNS</span> دوباره ساخته شوند.
+- اگر از <span dir="ltr">OpenVPN</span> استفاده می‌کنید و اتصال طولانی می‌شود، فایل <span dir="ltr">`.ovpn`</span>، نام کاربری/رمز و نصب بودن <span dir="ltr">OpenVPN Community</span> را بررسی کنید.
+
 ## تصاویر برنامه
 
 | داشبورد اتصال | تنظیم پروفایل و سرور |

README.md

@@ -1,29 +1,92 @@
 # TunnelX
 
-[فارسی](README.fa.md) | English
+[فارسی](README.fa.md) | English | [Русский](#русский) | [简体中文](#简体中文)
 
 TunnelX is a free and open-source Windows split-tunneling client built by **MaxFan**. It routes selected apps, selected destinations, or the whole system through supported tunnel cores while keeping local and excluded destinations on the normal network path.
 
+## Русский
+
+TunnelX — бесплатный клиент split tunneling для Windows от **MaxFan**. Он позволяет направлять через VPN, V2Ray/Xray, OpenVPN или SOCKS5/HTTP Proxy только выбранные приложения, выбранные домены/IP или весь системный трафик.
+
+Основные возможности: профили L2TP/IPsec, V2Ray/Xray, SOCKS5/HTTP Proxy и OpenVPN Community; выбор приложений для туннеля; правила include/exclude для доменов и IP; режим Full Route; локальный прокси `127.0.0.1`; отображение публичного выходного IP; история трафика; защита от DNS/IPv6/leak проблем.
+
+Для обычного использования скачайте последний standalone-файл из [GitHub Releases](https://github.com/MaxiFan/TunnelX/releases/latest), запустите TunnelX от имени Administrator, создайте профиль подключения, выберите приложения для туннеля и подключитесь. Отдельная установка .NET Runtime для standalone-сборки не требуется.
+
+## 简体中文
+
+TunnelX 是由 **MaxFan** 构建的免费 Windows 分流隧道客户端。它可以只让选定的应用、指定的域名/IP，或整个系统流量通过 VPN、V2Ray/Xray、OpenVPN 或 SOCKS5/HTTP Proxy，同时让本地或排除的目标继续走普通网络。
+
+主要功能包括：L2TP/IPsec、V2Ray/Xray、SOCKS5/HTTP Proxy 和 OpenVPN Community 配置文件；按应用分流；域名/IP include 与 exclude 规则；Full Route 全局模式；本地 `127.0.0.1` 代理；公网出口 IP 显示；流量历史；DNS、IPv6 与泄漏防护诊断。
+
+普通用户可以从 [GitHub Releases](https://github.com/MaxiFan/TunnelX/releases/latest) 下载最新 standalone 版本，以 Administrator 权限运行 TunnelX，创建连接配置，选择需要进入隧道的应用，然后连接。standalone 版本不需要单独安装 .NET Runtime。
+
 ## Features
 
 - App-based split tunneling for selected Windows processes
 - Full-route mode for whole-system tunneling
+- Windows L2TP/IPsec profile support
 - Xray-core / sing-box based V2Ray workflows
+- Dedicated SOCKS5/HTTP Proxy profiles with separate server, port, username, and password fields
 - OpenVPN Community support via user-provided `.ovpn` files for app-based split tunneling
 - Local SOCKS5 proxy for tools that need `127.0.0.1`
 - DNS redirect, IPv6 blocking, leak guard, route diagnostics, and traffic history
+- Multiple profiles, duplicate/edit flows, server tests, public exit IP detection, and release update checks
 - Persian-first Windows desktop UI
 
+## Quick Start
+
+1. Download the latest standalone release from GitHub Releases.
+2. Run TunnelX as Administrator. Route management, WinDivert, and packet interception require elevated privileges.
+3. Create a new profile or select an existing profile from the connection tab.
+4. Choose the connection type: L2TP/IPsec, V2Ray/Xray, SOCKS5/HTTP Proxy, or OpenVPN.
+5. Test the server, then enable the Windows apps that should use the tunnel.
+6. Add include or exclude destinations when needed, connect, and check the traffic health cards for DNS, IPv6, leaks, and route status.
+
+## Connection Types
+
+### L2TP/IPsec
+
+Enter the server address, username, password, and pre-shared key. TunnelX creates the Windows VPN connection and manages routes according to the selected-app policy or full-route mode.
+
+### V2Ray / Xray
+
+Paste a V2Ray/Xray link or JSON config into the profile. TunnelX uses sing-box for regular configs and switches to Xray-core for configs that require Xray-specific behavior such as `xhttp`.
+
+### SOCKS5/HTTP Proxy
+
+Use a SOCKS5/HTTP Proxy profile when you already have an external proxy endpoint. Enter the proxy server, port, and optional credentials. This is different from the local `127.0.0.1` SOCKS5 proxy, which is exposed after connection for tools that need a local proxy address.
+
 ## OpenVPN
 
 TunnelX can run an installed **OpenVPN Community** `openvpn.exe` with a user-selected `.ovpn` profile, then apply its own split-tunneling policy so only selected apps and included destinations use the OpenVPN tunnel.
 
 OpenVPN is not bundled with TunnelX. Install OpenVPN Community separately, select the `.ovpn` file in TunnelX, and enter the OpenVPN username/password if the server requires credentials. OpenVPN Connect alone is not enough for this mode because it manages routes and DNS through its own client.
 
+For split-tunnel compatibility, TunnelX prepares the OpenVPN config by controlling pushed route and DNS behavior. If OpenVPN reconnects and changes the tunnel IP, gateway, interface, or remote endpoint, TunnelX restarts its packet routing with the new values.
+
 ## Routing Notes
 
 Destination include/exclude rules match both the entered domain and its subdomains. For example, adding `githubusercontent.com` also covers `raw.githubusercontent.com` after DNS resolves it. Some HTTPS clients may still fail during certificate revocation checks if their OCSP/CRL hosts are not reachable through the selected route; add the downloader app or the relevant revocation domains to the include list when that happens.
 
+- Excluded destinations stay direct even for selected apps.
+- Included destinations use the tunnel even when the matching app is not selected.
+- For Store/MSIX, WebView2, or multi-process apps, keep the app open and refresh the app list.
+- In full-route mode, the whole system uses the tunnel; direct/exclude rules are still useful for keeping specific destinations on the normal route.
+
+## Local Data and Logs
+
+Profiles, selected apps, include/exclude destinations, connection history, and logs are stored on the user's Windows machine, typically under `%LOCALAPPDATA%\TunnelX` or next to the app depending on the feature. TunnelX does not intentionally send analytics or telemetry to the maintainer.
+
+Logs can contain process names, hostnames, IP addresses, ports, and connection state. Before posting logs publicly, remove server credentials, UUIDs, private keys, private endpoints, and other sensitive data.
+
+## Troubleshooting
+
+- If connection fails, check Administrator privileges, firewall rules, config validity, proxy ports, and prerequisites for the selected connection type.
+- If an app does not use the tunnel, enable it in the apps tab, keep it running, and refresh the app list.
+- If only one site or domain should use the tunnel, add it to include destinations. If it should stay direct, add it to exclusions.
+- If DNS or IPv6 status looks wrong, check the health cards after connection and reconnect once to rebuild routes and DNS rules.
+- For OpenVPN connection delays, verify the `.ovpn` file, credentials, and OpenVPN Community installation.
+
 ## Screenshots
 
 | Connection dashboard | Profile and server setup |
@@ -36,9 +99,9 @@ Destination include/exclude rules match both the entered domain and its subdomai
 
 ## Download
 
-Public downloads should be attached to GitHub Releases after release validation is complete:
+Public downloads are published through GitHub Releases:
 
-[GitHub project](https://github.com/MaxiFan/TunnelX)
+[Download the latest release](https://github.com/MaxiFan/TunnelX/releases/latest)
 
 Release assets are built and uploaded by GitHub Actions. Each published standalone executable includes a `.sha256` checksum file, and the release notes link back to the workflow run that produced the artifact.