.Net HttpClient 使用代理功能

于 2025-05-14 13:29:07 发布
阅读量608 收藏 15
点赞数 8
分类专栏： HttpClient 专栏 文章标签： .net .Net HttpClient HttpClient 代理 c# HttpClient
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/bicijinlian/article/details/147952253
版权

HttpClient 使用代理功能

实际开发中，HttpClient 通过代理访问目标服务器是常见的需求。

本文将全面介绍如何在 .NET 中配置 HttpClient 使用代理（Proxy）功能，包括基础使用方式、代码示例、以及与依赖注入结合的最佳实践。

注意：运行代码之前，先开启Fiddler Classic及其代理功能，充当代理服务器。

初始化

开启Fiddler Classic及其代理功能，充当代理服务器

在这里插入图片描述

导入初始终化笔记文件，并且执行一次

#!import "./Ini.ipynb"

//共享变量
var fiddlerProxyAddress = "127.0.0.1:8888";

🧩 什么是代理？

代理（Proxy）是一种中间服务器，用于转发客户端请求到目标服务器。它常用于以下目的：

  • 访问受限资源：企业内网中，通过代理服务器访问外部资源；
  • 提高安全性和隐私保护：代理可隐藏真实 IP 地址，保护目标服务器的隐私和数据安全；
  • 提高性能：代理可使用请求缓存和负载均衡等，减少目标服务器的压力，提高性能；
  • 方便调试、测试
    • 代理服务器可记录请求和响应信息，方便调试和测试；
    • Fiddler Classic等软件，默认是抓不到 HttpClient 的请求的，需要将其设置为代理服务器，才能抓取到 HttpClient 的请求;

在 .NET HttpClient 中，可以通过多种方式来设置代理服务器。

🛠️ 设置 HttpClient 代理

✅ 基本方式使用（无用户名密码）

{   
    // 设置 SocketsHttpHandler 使用代理
    var handler = new SocketsHttpHandler()
    {
        UseProxy = true,
        Proxy = new WebProxy(fiddlerProxyAddress),
    };

    // 创建 HttpClient，并且请求
    using (var client = new HttpClient(handler))
    {
        var response = await client.GetAsync("https://www.baidu.com");
        
        Console.WriteLine($"响应状态：{response.StatusCode}");
    }
}

执行上面的单元格，应该在fiddler classic 中，抓到请求包：可以查看和管理详细信息.

在这里插入图片描述

✅ 带用户名和密码的代理

{   
    // 设置 SocketsHttpHandler 使用代理
    var handler = new SocketsHttpHandler()
    {
        UseProxy = true,
        Proxy = new WebProxy(fiddlerProxyAddress)
        {
            //正式项目：机密数据一定要脱敏处理或者使用环境变量、机密管理器等手段
            //因为Fiddler代理服务器，没有用户凭据要求，所以此处随意填写的。需要的话，真实填写正确的用户凭据。
            Credentials = new NetworkCredential("username", "password"),
        },
    };

    // 创建 HttpClient，并且请求
    using (var client = new HttpClient(handler))
    {
        var response = await client.GetAsync("https://www.baidu.com");
        Console.WriteLine($"响应状态：{response.StatusCode}");
    }
}

📦 在IoC和工厂中使用 Proxy [推荐方式]

在 ASP.NET Core 或基于 IServiceCollection 的项目中，可以通过 UseSocketsHttpHandler 扩展方法，统一管理代理服务器配置。

还可以根据客户端的命名不同，进行不同的代理服务器配置！

//IoC或工厂中设置代理
{
   //IoC
   var services = new ServiceCollection();

   //默认命名客户端
   services
      .AddHttpClient<HttpClient>(string.Empty)
      .ConfigureHttpClient(client => 
      {
         client.BaseAddress = new Uri(webApiBaseUrl);
         client.Timeout = TimeSpan.FromSeconds(10);
      })

      //配置代理服务器
      .UseSocketsHttpHandler(handlerBuilder =>
      {
         handlerBuilder.Configure((handler,s) => 
         {
            handler.Proxy = new WebProxy(fiddlerProxyAddress);
         }); 
      });

   //发送请求
   var factory = services.BuildServiceProvider().GetRequiredService<IHttpClientFactory>();

   //正常请求
   var defaultClient = factory.CreateClient();
   var defaultContent = await defaultClient.GetStringAsync("api/hello/ping");
   Console.WriteLine($"正常请求,响应内容为： {defaultContent}");
}

🔄 动态切换代理服务器

要根据请求的不同(请求地址、请求方法、请求头、请求参数等)，动态选择使用一同的代理服务器，可以使用Pipeline中间件，来管理。

///<summary>
/// 代理服务选择器中间件
/// 注意：此中间件会短路，必须设置为最后一个中间件
///</summary>
public class ProxySelectorLastHandler : DelegatingHandler
{
    /// <summary>
    /// 拦截请求，并动态设置代理
    /// 注意：会短路其它中间件，要放最后
    /// </summary>
    protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken ct)
    {
        Console.WriteLine("ProxySelectorLastHandler -> SendAsync -> Before");
        //动态选择示例
        var proxy = request.RequestUri.Host switch
        {
            string url when url.Contains("baidu") => new WebProxy("127.0.0.1:8888"),
            string url when url.Contains("qq") => new WebProxy("127.0.0.1:8888"),
            _ => null
        };

        InnerHandler = new SocketsHttpHandler
        {
            Proxy = proxy,
            UseProxy = proxy != null
        };


        //请求
        HttpResponseMessage response = await base.SendAsync(request, ct);

        Console.WriteLine("ProxySelectorLastHandler -> SendAsync -> After");

        return response;
    }
}

//日志中间件(管道类)
public class LoggerDelegatingHandler : DelegatingHandler
{
    protected override HttpResponseMessage Send(HttpRequestMessage request, CancellationToken cancellationToken)
    {
        Console.WriteLine("LoggerDelegatingHandler -> Send -> Before");

        HttpResponseMessage response = base.Send(request, cancellationToken);

        Console.WriteLine("LoggerDelegatingHandler -> Send -> After");

        return response;
    }

    protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
    {
        Console.WriteLine("LoggerDelegatingHandler -> SendAsync -> Before");

        HttpResponseMessage response = await base.SendAsync(request, cancellationToken);

        Console.WriteLine("LoggerDelegatingHandler -> SendAsync -> After");

        return response;
    }
}

//使用：ProxySelectorLastHandler必须设置为最后一个中间件
{
    var handlerLink = new LoggerDelegatingHandler()
    {
        InnerHandler = new ProxySelectorLastHandler(),
    };

    var myClient = new HttpClient(handlerLink);
    var response = await myClient.GetAsync("https://www.qq.com");

    Console.WriteLine(response.StatusCode);
    Console.WriteLine("---------------------------------------------------");
}


// ProxySelectorLastHandler 不是最后一个的话，其它中间件无效(被短路)
{
    var handlerLink = new ProxySelectorLastHandler()
    {
        InnerHandler = new LoggerDelegatingHandler (),
    };

    var myClient = new HttpClient(handlerLink);
    var response = await myClient.GetAsync("https://www.qq.com");

    Console.WriteLine(response.StatusCode);
}

//注意看输出：后面的没有日志中间件的任何输出

🔐 HTTPS 代理信任问题

当使用 HTTPS 代理时，可能会遇到 SSL/TLS 证书不被信任的问题，尤其是在测试环境中使用自签名证书。

✅解决方法一：忽略证书验证（⚠️ 注意：仅用于开发环境）

var handler = new HttpClientHandler
{
    Proxy = new WebProxy(fiddlerProxyAddress),
    UseProxy = true,
    ServerCertificateCustomValidationCallback = (message, cert, chain, errors) => true
};

using (var client = new HttpClient(handler))
{ 
    var response = await client.GetAsync("https://www.baidu.com");
    Console.WriteLine(response.StatusCode);
};

✅ 解决方法二：手动添加根证书信任

using System.Security;
using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;

var file = Environment.CurrentDirectory + "\\Assets\\FiddlerRoot.cer";
//Console.WriteLine(file);
var rootCert = System.Security.Cryptography.X509Certificates.X509CertificateLoader.LoadCertificateFromFile(file);

var handler = new HttpClientHandler
{
    Proxy = new WebProxy(fiddlerProxyAddress),
    UseProxy = true,
    ServerCertificateCustomValidationCallback = (request, cert, chain, errors) =>
    {
        //return true;
        return chain.ChainElements.Any(x => x.Certificate.Thumbprint == cert.Thumbprint); // 验证证书链包含指定根证书
    }
};

using (var client = new HttpClient(handler))
{ 
    var response = await client.GetAsync("https://www.baidu.com");
    Console.WriteLine(response.StatusCode);
};

📌 总结

通过本文，你应该掌握了以下内容：

  • 如何在 HttpClient 中直接设置代理
  • 如何在依赖注入系统中配置全局代理
  • 如何通过环境变量设置代理
  • 如何验证代理是否生效
  • 实际使用中的注意事项
  • 动态选择及证书信任
【微软技术栈】C#.NET 使用 HttpClient 类发出 HTTP 请求
Coding life, Coding world, Coding feature.
10-29 1139
本文介绍如何使用HttpClient类发出 HTTP 请求和处理响应。
c#httpclient 代理_C# System.Net.Http.HttpClient使用说明
weixin_39530437的博客
12-19 2569
一、System.Net.Http.HttpClient简介System.Net.Http是微软推出的最新的HTTP应用程序的编程接口，微软称之为“现代化的HTTP编程接口”，主要提供如下内容：1.用户通过HTTP使用现代化的WebService的客户端组件；2.能够同时在客户端与服务端同时使用的HTTP组件(比如处理HTTP标头和消息)，为客户端和服务端提...
.Net Core HttpClient处理响应压缩
farway000的博客
09-26 687
前言在上篇文章[ASP.NET Core中的响应压缩]中我们谈到了在ASP.NET Core服务端处理关于响应压缩的请求，服务端的主要工作就是根据Content-Encoding头...
.NET9中的HttpClient的优化更新
scixing的博客
02-14 368
.NET9中的HttpClient的优化更新
.Net 4.5中的HttpClient使用方法
zhaokunsummer的专栏
05-07 4036
原文http://www.cnblogs.com/TianFang/archive/2012/03/10/2389480.html .Net 4.5中增加了一个新的System.Net.Http.HttpClient名字空间（在 System.Net.Http.dll 中），用于发送 HTTP 请求和接收 HTTP 响应。 基本操作 和以前的HttpWebReques
HttpClient（二）HttpClient使用Ip代理与处理连接超时
a878787877的专栏
12-14 318
前言 　　其实前面写的那一点点东西都是轻轻点水，其实HttpClient还有很多强大的功能： 　　（1）实现了所有 HTTP 的方法（GET,POST,PUT,HEAD 等） 　　（2）支持自动转向 　　（3）支持 HTTPS 协议 　　（4）支持代理服务器等 一、HttpClient使用代理IP 1.1、前言 　　在爬取网页的时候，有的目标站点有反爬虫机制，对于频繁...
HttpClient使用和详解
swadian2008的博客
04-02 8793
目录 一、关于HttpClient 二、HttpClient使用步骤详解 1、创建一个HttpClient对象 A、HttpCLientConnectionManager B、HttpRoutePlanner C、RequestConfig 2、创建一个Request对象 3、执行Request请求 4、处理response 1）关闭和entity相关的content stre...
HttpClient详细使用示例
热门推荐
JustryDeng
07-14 56万+
HTTP 协议可能是现在 Internet 上使用得最多、最重要的协议了，越来越多的 Java 应用程序需要直接通过 HTTP 协议来访问网络资源。虽然在 JDK 的 java net包中已经提供了访问 HTTP 协议的基本功能，但是对于大部分应用程序来说，JDK 库本身提供的功能还不够丰富和灵活。HttpClient 是 Apache Jakarta Common 下的子项目，用...
HttpClient使用示例（post、json、设置代理）
Muscleheng的博客
03-07 5241
JDK 的 java net包中已经提供了访问 HTTP 协议的基本功能，但是，JDK 库本身提供的功能还不够丰富。HttpClient 是 Apache Jakarta Common 下的子项目，用来提供高效的、最新的、功能丰富的支持 HTTP 协议的客户端编程工具包，并且它支持 HTTP 协议最新的版本。 这里实现了几种常见的请求方式，包括请求、响应超时的设置； 所需jar包：...
MessengerPigeon:.NET HttpClient的轻量级支持类和扩展方法的集合，以简化HTTP请求。 :envelope:
04-18
在 .NET 开发中，HttpClient 类是用于发送 HTTP 请求的标准组件，而 MessengerPigeon 正是围绕这个核心类进行封装，以减少代码复杂性和提高可维护性。 在使用 MessengerPigeon 时，开发人员可以快速地发起 GET、...
ASP.NET MVC Web API HttpClient简介
10-27
*** MVC Web API HttpClient相较于早期版本的WebClient和HttpWebRequest，提供了更多先进的功能和更灵活的使用方式。 首先，HttpClient类本身具备很多优势和特性。第一个特性是，它允许开发者在HttpClient实例上...
.Net HttpClient 处理响应数据
bicijinlian的专栏
05-11 401
本文介绍了如何使用 HttpClient 处理响应数据，涵盖了初始化、响应状态处理及异常处理。首先，HttpClient 需进行初始化及全局设置。接着，通过判断响应码和调用 EnsureSuccessStatusCode 方法，确保请求的响应状态正常。对于异常响应，文章提供了多种处理方式：使用 try-catch 捕获常规异常；通过自定义 DelegatingHandler 实现管道统一处理异常；以及使用类型化客户端结合 AOP 进行统一拦截处理。这些方法能够有效处理 HTTP 请求中的异常情况，确保程序的
.Net HttpClient 概述
bicijinlian的专栏
05-09 1088
HttpClient是.NET中用于发送HTTP请求和接收响应的类，位于System.Net.Http命名空间下。它提供了现代化、灵活且强大的方式与Web服务通信。
22.【.NET8 实战--孢子记账--从单体到微服务--转向微服务】--单体转微服务--增加公共代码
喵叔
05-13 1101
本文介绍了在微服务架构中提取公共代码的步骤，重点包括日志记录、异常处理和Redis通用代码的整合。首先，创建了一个名为 SP.Common 的类库项目，并在其中分别建立了 Redis、ExceptionHandling 和 Logger 文件夹，用于存放相关代码。接着，详细讲解了Redis通用代码的实现，包括配置类、服务接口和具体实现，采用接口与实现分离的设计模式，并通过依赖注入和选项模式简化配置和使用。整体设计封装了底层StackExchange.Redis库的操作，提供了异常处理和日志记录，支持多种Re
.NET MAUI 基础知识
冰茶的博客
05-11 1064
NET Multi-platform App UI (.NET MAUI) 是微软推出的新一代跨平台UI框架，是Xamarin.Forms的继任者。它允许开发者使用单一的代码库和项目结构，创建可在Android、iOS、macOS和Windows上运行的本地应用程序。.NET MAUI采用C#和XAML作为开发语言，为开发者提供了统一的编程模型和API，简化了跨平台应用开发流程。
.Net Mqtt协议-MQTTNet（一）简介
天马3798
05-10 865
一、MQTTNet 简介 MQTTnet 是一个高性能的MQTT类库，支持.NET Core和.NET Framework。
.Net HttpClient 管理客户端(初始化与生命周期管理)
bicijinlian的专栏
05-10 793
HttpClient 的初始化和生命周期管理是确保应用程序高效运行的关键。HttpClient 应实例化一次并在整个应用程序生命周期内重复使用，以避免性能开销和内存泄漏。手动管理方式包括直接实例化、静态类或单例模式，但这些方法存在灵活性和优雅性不足的问题。推荐使用IoC容器、工厂模式（如IHttpClientFactory）和复原库Polly来更高效地管理HttpClient。通过连接池和请求管道的默认配置，结合这些高级管理方法，可以显著提升应用程序的性能和稳定性。
.NET NativeAOT 指南
最新发布
2401_82505179的博客
05-14 614
.NET NativeAOT（Ahead-of-Time Compilation）技术通过将C#代码直接编译为原生机器码，显著提升了应用程序的启动速度和运行效率，同时简化了部署流程并减少了应用体积。本文详细介绍了NativeAOT的定义、与传统JIT的对比、适用场景、核心优势、基本用法、编译流程、反射和动态依赖的处理、高级优化技巧、跨平台和静态链接构建、实际应用案例、常见问题与解决方案以及未来展望。NativeAOT特别适用于无服务器架构、嵌入式设备、高性能计算和跨平台部署等场景。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

bicijinlian

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值