Home

KernelHttp Wiki

面向 Windows 内核驱动的纯内核态 HTTP/HTTPS 客户端库

KernelHttp 是一个纯内核态的 HTTP/HTTPS 客户端库，专为 Windows 内核驱动开发设计。它从底层开始构建，实现了内核可用的客户端协议栈：HTTP/1.1、HTTP/2、WebSocket，以及 TLS 1.2/1.3 握手、记录保护和证书验证。

• 🔒 纯内核态：不依赖 WinHTTP / WinINet / SChannel
• 🌐 WSK 传输 + 🔐 CNG/BCrypt 密码学
• 🎯 两层 API：高层 khttp / kws 与底层 engine（Kh*）
• 🔄 连接池、异步、证书锁定、响应解码（gzip/deflate/br/compress）

📚 导航

入门

• 快速开始 · 构建与测试

协议参考

• 能力账本（必读）· 架构总览
• HTTP/1.1 协议 · HTTP/2 与 HPACK · WebSocket 协议
• TLS 与证书 · 密码学层

API 参考

• 高层 API（khttp/kws） · 底层 API（engine）
• 配置项与常量 · 客户端类
• 传输层（ITransport/WSK） · NTSTATUS 错误码

机制

• 连接池 · 异步模型 · 内存模型

实战 / 项目

• Cookbook 样例 · 常见问题 FAQ
• 路线图与非目标 · 术语表 · 贡献指南

---

English

KernelHttp Wiki

A pure kernel-mode HTTP/HTTPS client library for Windows kernel drivers

KernelHttp is a pure kernel-mode HTTP/HTTPS client library for Windows kernel driver development. Built from the ground up, it implements a kernel-friendly client protocol stack: HTTP/1.1, HTTP/2, WebSocket, and TLS 1.2/1.3 handshake, record protection, and certificate validation.

• 🔒 Pure kernel-mode: no WinHTTP / WinINet / SChannel dependency
• 🌐 WSK transport + 🔐 CNG/BCrypt cryptography
• 🎯 Two-layer API: high-level khttp / kws and low-level engine (Kh*)
• 🔄 Connection pool, async, certificate pinning, response decoding

📚 Navigation

Getting started: Getting Started · Build & Test

Protocol reference: Capability Matrix (read first) · Architecture · HTTP/1.1 · HTTP/2 & HPACK · WebSocket · TLS & Certificates · Cryptography

API reference: High-Level API · Low-Level API · Configuration · Client Classes · Transport Layer · NTSTATUS

Mechanics: Connection Pool · Async Model · Memory Model

Guides / project: Cookbook · FAQ · Roadmap · Glossary · Contributing