开源 · MIT 许可 · .NET 8+

让 HTTP 请求 所见即所得

HttpAgent 是一个高性能、灵活且易用的 .NET HTTP 开源库，提供全面的 HTTP 功能支持。内置工业级报文透视引擎（Profiler），彻底终结第三方 API 对接的“黑匣子”时代。
9 种 HTTP 谓词SSE · WebSocket压力测试声明式请求零第三方依赖.NET 8+
dotnet add package HttpAgent
开始阅读文档Gitee 仓库
HttpAgent Profiler — 报文透视引擎
Request Headers:  User-Agent            Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36 Edg/150.0.0.0  Content-Type          application/json; charset=utf-8Request Body (StringContent, total: 24 bytes):  {"id":1,"name":"furion"}General:  Request URL           https://localhost:7044/HttpRemote/AddModel?query1=1&query2=furion  Request Method        POST  Status Code           200 OK  HTTP Version          1.1  HTTP Content          StringContent  Content Type          application/json; charset=utf-8  Request Duration (ms) 2.00Response Headers:  Date                  Sat, 15 Aug 2026 11:58:16 GMT  Server                Kestrel  Transfer-Encoding     chunked  Content-Type          application/json; charset=utf-8Response Body (HttpConnectionResponseContent, total: 24 bytes):  {"id":1,"name":"furion"}
无需 Fiddler / Wireshark，控制台即见全部报文
98%单元与集成测试覆盖率
9HTTP 请求谓词支持
18+内置核心能力
MIT许可协议 · 支持 .NET 8+
功能特性

功能全景

从基础请求到生产级治理能力，HttpAgent 一站式提供，零第三方依赖
  • 工业级报文透视引擎Profiler 控制台洞察报文，无需 Fiddler/Wireshark 抓包工具
  • 全面的 HTTP 方法支持GET、POST、PUT、DELETE、PATCH、HEAD、TRACE、OPTIONS、QUERY
  • 文件传输上传下载一体化，实时传输进度监控
  • 实时通信SSE 实时推送 + WebSocket 双工通信
  • 代理与微服务集成HTTP 代理与请求转发
  • 高性能 · 跨平台无依赖内存优化 + 连接池管理，无需任何外部依赖
  • 轮询机制标准轮询与长轮询，间隔自由定制
  • 测试工具集压力/性能/模拟测试，自动生成详细报告
  • 请求管理与日志审计请求拦截机制 + HTTP 日志审计
  • 弹性与容错自动重试、指数退避、超时、熔断降级
  • 响应转换与自动解压自定义转换 + gzip/deflate/brotli/zstd 自动解压
  • Access Token 自动管理自动刷新注入，401 自动重试
  • 配额与 ETag 缓存日/周/月/终身窗口策略 + 304 缓存复用
  • Media 类型与 MessagePack预设 MediaType 处理 + MessagePack 序列化
  • WebService 与 ODataSOAP/RESTful 全支持 + OData 标准查询
  • cURL 命令解析原生 cURL 字符串一键发起请求
  • 声明式请求属性注解与接口定义
  • 全平台 · 高质量Console/Web/WASM/WinForms/WPF/MAUI · .NET 8+ · 98% 覆盖率
超级引擎

两大「开挂」能力

不止是 HTTP 客户端库 —— 工坊所见即所得生成代码，AI 助手随时解答官方文档。
工坊可视化代码生成器
可视化配置 HTTP 请求，一键生成可直接运行的 HttpAgent 代码。
所见即所得，边配置边生成
覆盖 GET/POST/上传/下载等常用场景
支持 cURL 命令一键导入解析
生成代码零依赖，复制即可运行
进入工坊
HttpAgent 助手AI 文档问答
基于全部官方文档的 AI 助手，用法、API、示例代码随问随答。
所有回答严格基于官方文档
支持 DeepSeek 与 OpenAI 双模型
Ctrl+Q 随时唤起，全站可用
选中任意文字即可「问 AI」就地追问
系统架构

架构一览

构建器 → 内容处理器 → HttpClient → 内容转换器 → 响应，全链路可插拔、可扩展。
查看高清架构图（drawio 源文件）(opens in new tab)想了解每个组件的职责？从 HTTP 远程请求概述 开始阅读。
互动示例

五种姿势，任你选择

谓词方法、链式构建器、声明式接口、cURL 命令与 JSON 配置，都能得到同样强大的能力
// 一行代码获取网站内容var content = await httpRemoteService.GetAsStringAsync("https://furion.net/");// 泛型返回强类型结果var user = await httpRemoteService.GetAsAsync<User>("https://api.example.com/user/1");
快速上手

四步上手，一分钟跑通

从安装到第一个请求，只需要一杯咖啡的时间
  1. 1安装 NuGet 包
    在任意 .NET 8+ 应用（Console / Web / WinForms / WPF / MAUI）中执行：$ dotnet add package HttpAgent查看文档 →
  2. 2注册服务
    在 Program.cs 中调用 AddHttpRemote() 注册 HTTP 远程请求服务：$ services.AddHttpRemote();查看文档 →
  3. 3发送第一个请求
    注入 IHttpRemoteService，一行代码获取网站内容：$ await httpRemoteService.GetAsStringAsync("https://furion.net/");查看文档 →
  4. 4开启请求分析工具
    链式调用 Profiler()，控制台即刻呈现完整请求/响应报文：$ builder => builder.Profiler()查看文档 →

准备好消灭 HTTP 调试的黑盒了吗？

覆盖 GET/POST/PUT/DELETE 等全部谓词、文件传输、SSE/WebSocket、压测、声明式请求——所有能力都内置工业级流量分析引擎。
浏览文档访问代码仓库支持项目