卫月启动器添加代理设置功能

src/XIVLauncher.Common.Http/ProxyConfigSnapshot.cs

@@ -0,0 +1,20 @@
+namespace XIVLauncher.Common.Http;
+
+/// <summary>
+///     代理配置快照, 由应用设置层提供, 避免公共库依赖 UI 层类型
+/// </summary>
+public sealed record ProxyConfigSnapshot
+(
+    string  Type,
+    string  Host,
+    int     Port,
+    string? Username = null,
+    string? Password = null
+)
+{
+    public bool IsDisabled =>
+        string.IsNullOrWhiteSpace(Host)
+        || Port is < 1 or > 65535
+        || string.IsNullOrWhiteSpace(Type)
+        || string.Equals(Type, "None", StringComparison.OrdinalIgnoreCase);
+}

src/XIVLauncher.Common.Http/XLHttpClientFactory.cs

@@ -8,12 +8,14 @@ public static HttpClient Create
     (
         TimeSpan             connectTimeout,
         int                  maxConnectionsPerServer,
-        DecompressionMethods automaticDecompression
+        DecompressionMethods automaticDecompression,
+        IWebProxy?           proxy = null
     )
     {
         var handler = new SocketsHttpHandler
         {
             UseProxy                       = true,
+            Proxy                          = proxy,
             ConnectTimeout                 = connectTimeout,
             MaxConnectionsPerServer        = maxConnectionsPerServer,
             EnableMultipleHttp2Connections = true,

src/XIVLauncher.Common.Http/XLProxyProvider.cs

@@ -0,0 +1,85 @@
+using System.Net;
+using Serilog;
+
+namespace XIVLauncher.Common.Http;
+
+/// <summary>
+///     启动器全局代理提供者, 由启动流程根据代理配置构建一次。
+///     HTTP/HTTPS/SOCKS5 由 SocketsHttpHandler 原生支持。
+/// </summary>
+public static class XLProxyProvider
+{
+    public static IWebProxy? Current { get; private set; }
+
+    public static void Apply(ProxyConfigSnapshot? config)
+    {
+        var webProxy = BuildWebProxy(config);
+        Current      = webProxy is null ? null : new SdoScopedProxy(webProxy);
+
+        Log.Information
+        (
+            "[XLProxyProvider] 代理配置已应用 (仅对盛趣域名 *.sdo.com / *.jijiagames.com 生效): {Proxy}",
+            webProxy is WebProxy { Address: not null } proxy ? proxy.Address.ToString() : "无"
+        );
+    }
+
+    public static IWebProxy? BuildWebProxy(ProxyConfigSnapshot? config)
+    {
+        if (config is null || config.IsDisabled)
+            return null;
+
+        try
+        {
+            var scheme = config.Type.Trim().ToLowerInvariant() switch
+            {
+                "http"   => "http",
+                "https"  => "https",
+                "socks5" => "socks5",
+                _        => null
+            };
+
+            if (scheme == null)
+            {
+                Log.Warning("[XLProxyProvider] 不支持的代理类型: {ProxyType}", config.Type);
+                return null;
+            }
+
+            var proxy = new WebProxy($"{scheme}://{config.Host.Trim()}:{config.Port}");
+
+            if (!string.IsNullOrWhiteSpace(config.Username))
+                proxy.Credentials = new NetworkCredential(config.Username, config.Password);
+
+            return proxy;
+        }
+        catch (Exception ex)
+        {
+            Log.Warning(ex, "[XLProxyProvider] 构建代理配置失败: {ProxyHost}:{ProxyPort} ({ProxyType})", config.Host, config.Port, config.Type);
+            return null;
+        }
+    }
+
+    /// <summary>
+    ///     仅对盛趣域名 (*.sdo.com / *.jijiagames.com) 生效的代理包装:
+    ///     其余目标一律直连, 避免 GitHub / Dalamud / NuGet 等流量被错误导入代理。
+    /// </summary>
+    private sealed class SdoScopedProxy(IWebProxy inner) : IWebProxy
+    {
+        public ICredentials? Credentials
+        {
+            get => inner.Credentials;
+            set => inner.Credentials = value;
+        }
+
+        public Uri? GetProxy(Uri destination) =>
+            IsSdoHost(destination.Host) ? inner.GetProxy(destination) : destination;
+
+        public bool IsBypassed(Uri host) =>
+            !IsSdoHost(host.Host);
+
+        private static bool IsSdoHost(string host) =>
+            string.Equals(host, "sdo.com", StringComparison.OrdinalIgnoreCase)
+            || host.EndsWith(".sdo.com", StringComparison.OrdinalIgnoreCase)
+            || string.Equals(host, "jijiagames.com", StringComparison.OrdinalIgnoreCase)
+            || host.EndsWith(".jijiagames.com", StringComparison.OrdinalIgnoreCase);
+    }
+}

src/XIVLauncher.Common/Game/Launcher.cs

@@ -4,6 +4,7 @@
 using Serilog;
 using XIVLauncher.Common.Constant;
 using XIVLauncher.Common.Game.Exceptions;
+using XIVLauncher.Common.Http;
 using XIVLauncher.Common.Util;
 
 namespace XIVLauncher.Common.Game;
@@ -13,7 +14,7 @@ public partial class Launcher
     public delegate Process? GameStarter(GameStartRequest request);
 
     public RestartMonitor RestartMonitor { get; } = new();
-    public HttpClient     MockHttpClient { get; } = new(new HttpClientHandler { UseCookies = true });
+    public HttpClient     MockHttpClient { get; } = new(new HttpClientHandler { UseCookies = true, Proxy = XLProxyProvider.Current });
 
     public FFXIVProcess? LaunchGame
     (

src/XIVLauncher.DCTravel/DCTravelClient.cs

@@ -3,6 +3,7 @@
 using System.Text.Json.Nodes;
 using Serilog;
 using XIVLauncher.Common.Constant;
+using XIVLauncher.Common.Http;
 using XIVLauncher.Login;
 using XIVLauncher.Login.Workflow;
 
@@ -78,7 +79,8 @@ public DCTravelClient(string nSessionID)
             CookieContainer        = cookieContainer,
             UseCookies             = true,
             AllowAutoRedirect      = true,
-            AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate | DecompressionMethods.Brotli
+            AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate | DecompressionMethods.Brotli,
+            Proxy                  = XLProxyProvider.Current
         };
         httpClient = new HttpClient(handler)
         {

src/XIVLauncher.GamePatchV3/GameFileDownloader.cs

@@ -6,6 +6,7 @@
 using System.Text;
 using Serilog;
 using XIVLauncher.Common.Constant;
+using XIVLauncher.Common.Http;
 using XIVLauncher.GamePatchV3.Integrity;
 using XIVLauncher.GamePatchV3.Integrity.Models;
 
@@ -27,7 +28,11 @@ public class GameFileDownloader : IDisposable
     private string dataVersion     = null!;
 
     public GameFileDownloader()
-        : this(new SocketsHttpHandler())
+        : this(new SocketsHttpHandler
+               {
+                   UseProxy = true,
+                   Proxy    = XLProxyProvider.Current
+               })
     {
     }
 

src/XIVLauncher.GamePatchV3/GamePatchMetadataClient.cs

@@ -1,7 +1,9 @@
 using System.Diagnostics;
+using System.Net;
 using System.Text.Json;
 using Serilog;
 using XIVLauncher.Common.Constant;
+using XIVLauncher.Common.Http;
 using XIVLauncher.GamePatchV3.Integrity.Models;
 using XIVLauncher.GamePatchV3.Models;
 using XIVLauncher.GamePatchV3.Update.Models;
@@ -15,7 +17,14 @@ public sealed class GamePatchMetadataClient : IDisposable
         PropertyNameCaseInsensitive = true
     };
 
-    private readonly HttpClient client = new();
+    private readonly HttpClient client = new
+    (
+        new SocketsHttpHandler
+        {
+            UseProxy = true,
+            Proxy    = XLProxyProvider.Current
+        }
+    );
 
     public void Dispose() =>
         client.Dispose();

src/XIVLauncher.GamePatchV3/Update/GamePatchInstaller.cs

@@ -11,6 +11,7 @@
 using System.Xml.Linq;
 using Serilog;
 using XIVLauncher.Common.Constant;
+using XIVLauncher.Common.Http;
 using XIVLauncher.GamePatchV3.Integrity.Models;
 using XIVLauncher.GamePatchV3.Models;
 using XIVLauncher.GamePatchV3.Update.Models;
@@ -25,7 +26,14 @@ public sealed class GamePatchInstaller : IDisposable
         PropertyNameCaseInsensitive = true
     };
 
-    private readonly HttpClient client = new()
+    private readonly HttpClient client = new
+    (
+        new SocketsHttpHandler
+        {
+            UseProxy = true,
+            Proxy    = XLProxyProvider.Current
+        }
+    )
     {
         DefaultRequestVersion = HttpVersion.Version20,
         DefaultVersionPolicy  = HttpVersionPolicy.RequestVersionOrLower

src/XIVLauncher.GamePatchV3/XIVLauncher.GamePatchV3.csproj

@@ -25,6 +25,7 @@
     </ItemGroup>
     <ItemGroup>
         <ProjectReference Include="..\XIVLauncher.Common\XIVLauncher.Common.csproj"/>
+        <ProjectReference Include="..\XIVLauncher.Common.Http\XIVLauncher.Common.Http.csproj"/>
     </ItemGroup>
     <ItemGroup>
         <InternalsVisibleTo Include="XIVLauncher.Test"/>

src/XIVLauncher.Login/Channels/LoginChannelContext.cs

@@ -3,6 +3,7 @@
 using Serilog;
 using XIVLauncher.Account.DeviceProfiles;
 using XIVLauncher.Common.Constant;
+using XIVLauncher.Common.Http;
 using XIVLauncher.Common.Util;
 using XIVLauncher.Login.Client;
 using XIVLauncher.Login.Exceptions;
@@ -29,7 +30,8 @@ public LoginChannelContext(DeviceProfileSnapshot deviceProfile)
         var loginHandler = new HttpClientHandler
         {
             UseCookies      = true,
-            CookieContainer = loginCookies
+            CookieContainer = loginCookies,
+            Proxy           = XLProxyProvider.Current
         };
 
         loginHttpClient = new HttpClient(loginHandler);

src/XIVLauncher.Login/Models/LoginArea.cs

@@ -7,10 +7,15 @@ namespace XIVLauncher.Login.Models;
 
 public class LoginArea
 {
-    private static readonly HttpClient Client = XLHttpClientFactory.Create(TimeSpan.FromSeconds(30), int.MaxValue, DecompressionMethods.None);
-
-    static LoginArea() =>
-        Client.Timeout = TimeSpan.FromSeconds(30);
+    private static readonly Lazy<HttpClient> Client = new
+    (
+        () =>
+        {
+            var client = XLHttpClientFactory.Create(TimeSpan.FromSeconds(30), int.MaxValue, DecompressionMethods.None, XLProxyProvider.Current);
+            client.Timeout = TimeSpan.FromSeconds(30);
+            return client;
+        }
+    );
 
     [JsonProperty("Areaid")]
     public string AreaID { get; set; } = null!;
@@ -45,7 +50,7 @@ public static async Task<LoginArea[]> Get()
         request.Headers.Add("Accept", "*/*");
         request.Headers.Add("Host",   "ff.dorado.sdo.com");
 
-        using var response = await Client.SendAsync(request);
+        using var response = await Client.Value.SendAsync(request);
         response.EnsureSuccessStatusCode();
 
         var text = await response.Content.ReadAsStringAsync();

src/XIVLauncher/Settings/LauncherSettingsV3.cs

@@ -274,6 +274,19 @@ public bool KeepPatches
 
     #endregion
 
+    #region 网络代理配置
+
+    /// <summary>
+    ///     启动器网络代理配置 (与主配置一并存储)
+    /// </summary>
+    public ProxySettings ProxySettings
+    {
+        get;
+        set => Set(ref field, value);
+    } = new();
+
+    #endregion
+
     #region 账户与安全配置
 
     /// <summary>
@@ -480,6 +493,7 @@ out Exception?         exception
         {
             var json = File.ReadAllText(sourcePath, Encoding.UTF8);
             settings = JsonSerializer.Deserialize<LauncherSettingsV3>(json, JsonOptions) ?? new LauncherSettingsV3();
+            settings.SanitizeProxySettings();
             var migrated = settings.MigrateWeGamePath();
             settings.Attach(attachPath);
             if (migrated)
@@ -504,6 +518,23 @@ private bool MigrateWeGamePath()
         return true;
     }
 
+    /// <summary>
+    ///     加载后清理代理配置: 补齐缺失的配置对象并校验密码字段可解密
+    /// </summary>
+    private void SanitizeProxySettings()
+    {
+        ProxySettings ??= new ProxySettings();
+
+        foreach (var profile in ProxySettings.Profiles)
+        {
+            if (!string.IsNullOrWhiteSpace(profile.ProxyPasswordEncrypted) && profile.GetPassword() == null)
+            {
+                Log.Warning("[LauncherSettingsV3] 代理密码解密失败, 已清空密码字段: {ProfileName}", profile.DisplayName);
+                profile.ProxyPasswordEncrypted = string.Empty;
+            }
+        }
+    }
+
     private static string? MoveBrokenConfig(string configPath)
     {
         if (!File.Exists(configPath))