cpp-httplib：一份头文件里的阻塞式 HTTP/HTTPS 能力
此專案圍繞「A C++ header-only HTTP/HTTPS server and client library. [!NOTE] BoringSSL (best-effort): BoringSSL builds under CPPHTTPLIB_OPENSSL_SUPPORT and is exercised by CI against current upstream.」建置，聚焦實際場景的開源實作，提供可重用的工具鏈與整合方式。
秒懂
- 它是什麼？
- cpp-httplib 是 C++11、跨平台、单文件 header-only 的 HTTP/1.1 客户端与服务器库，TLS 通过多种后端提供。
- 適合誰用？
- 适合需要快速嵌入小型 HTTP/1.1 客户端或服务端、并能接受阻塞式 socket I/O 的 C++ 项目；不适合需要 HTTP/2、HTTP/3、非阻塞模型或 32 位安全保证的人。先用 `httplib.h` 跑通 HTTP 示例，再分别验证 TLS 证书、SAN 主机名、mTLS、超时和大响应行为。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 1 天前。
- 用什麼語言寫的？
- 主要是 C++（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
单文件带来的接入路径
README 把 cpp-httplib 定义为 C++11、跨平台、单文件 header-only HTTP/HTTPS 库，最直接的接入方式是把 `httplib.h` 加入项目。服务端可创建 `httplib::Server`，客户端可创建 `httplib::Client`；HTTPS 则使用对应 SSL 类型并启用宏。 yhirose-cpp-httplib-deep-analysis
这种分发方式适合小型工具、测试服务和需要少量依赖的应用，但不等于编译、线程和 TLS 配置都自动解决。项目应把头文件版本和编译器选项固定下来，并在目标平台上执行真实请求，而非只验证 include 成功。 yhirose-cpp-httplib-deep-analysis
yhirose-cpp-httplib-deep-analysis 在本节的核验记录应围绕 单文件带来的接入路径 展开：固定当前版本、输入样本和运行环境，记录实际输出、错误信息与资源变化，并把与 README 不一致的结果单独列出。第 1 节不能用另一项目的结论替代，尤其要保留本项目的命令、文件路径、协议或权限名称。还要注明测试日期、使用的操作系统、依赖版本和清理动作，让下一次复核可以区分代码变化、环境差异与数据差异。
阻塞式 I/O 是关键取舍
README 明确说明库使用 blocking socket I/O。如果需求是 non-blocking socket I/O，这不是合适的库；它也只支持 HTTP/1.1，HTTP/2 和 HTTP/3 尚未实现。这个边界会影响并发模型、连接复用、事件循环和协议协商。 yhirose-cpp-httplib-deep-analysis
使用前应列出请求量、连接数、线程模型和上游协议。对低复杂度服务可以先用官方 server/client 示例验证；若应用需要接入已有异步 reactor，不能只因为 API 看起来简单就把阻塞调用塞进事件线程。 yhirose-cpp-httplib-deep-analysis
yhirose-cpp-httplib-deep-analysis 在本节的核验记录应围绕 阻塞式 I/O 是关键取舍 展开：固定当前版本、输入样本和运行环境，记录实际输出、错误信息与资源变化，并把与 README 不一致的结果单独列出。第 2 节不能用另一项目的结论替代，尤其要保留本项目的命令、文件路径、协议或权限名称。还要注明测试日期、使用的操作系统、依赖版本和清理动作，让下一次复核可以区分代码变化、环境差异与数据差异。
HTTP 服务器与客户端样例
服务端示例在 `0.0.0.0:8080` 注册 `/hi` GET 路由并返回 `Hello World!`；HTTPS 服务端则使用 `SSLServer`。客户端示例访问 `https://yhirose.github.io`，通过 `Get` 获取状态码和 body。 yhirose-cpp-httplib-deep-analysis
验证时应把监听地址、端口、路由、响应内容和错误分开记录。服务端至少测试正常请求、未知路径、并发请求和关闭流程；客户端应检查无响应对象时的 error，而不是直接解引用结果。README 给出的是最小示例，不是完整鉴权、限流或生产反向代理方案。 yhirose-cpp-httplib-deep-analysis
yhirose-cpp-httplib-deep-analysis 在本节的核验记录应围绕 HTTP 服务器与客户端样例 展开：固定当前版本、输入样本和运行环境，记录实际输出、错误信息与资源变化，并把与 README 不一致的结果单独列出。第 3 节不能用另一项目的结论替代，尤其要保留本项目的命令、文件路径、协议或权限名称。还要注明测试日期、使用的操作系统、依赖版本和清理动作，让下一次复核可以区分代码变化、环境差异与数据差异。
TLS 后端与编译宏
TLS 支持 OpenSSL、Mbed TLS 和 wolfSSL，分别通过 `CPPHTTPLIB_OPENSSL_SUPPORT`、`CPPHTTPLIB_MBEDTLS_SUPPORT` 和 `CPPHTTPLIB_WOLFSSL_SUPPORT` 启用。OpenSSL 要求 3.0 或更高版本，Mbed TLS 支持 2.x、3.x、4.x，wolfSSL 5.x 需要以 `--enable-opensslall` 构建。 yhirose-cpp-httplib-deep-analysis
BoringSSL 在 OpenSSL 宏下属于 best-effort，因 API 不保证稳定，偶尔破坏构建是已知风险。它要求消费者使用 C++14 或更高版本，主机名校验遵循 RFC 6125 的 SAN-only 行为，不回退到 CN。不同后端应分别编译和运行 TLS 测试。 yhirose-cpp-httplib-deep-analysis
yhirose-cpp-httplib-deep-analysis 在本节的核验记录应围绕 TLS 后端与编译宏 展开：固定当前版本、输入样本和运行环境，记录实际输出、错误信息与资源变化，并把与 README 不一致的结果单独列出。第 4 节不能用另一项目的结论替代，尤其要保留本项目的命令、文件路径、协议或权限名称。还要注明测试日期、使用的操作系统、依赖版本和清理动作，让下一次复核可以区分代码变化、环境差异与数据差异。
证书校验与 mTLS
客户端可以用 `set_ca_cert_path` 指定 CA bundle，也可以关闭服务端证书校验；后者只适合明确隔离的测试。库提供 `ssl_error()` 和 `ssl_backend_error()`，便于区分 TLS 层错误与后端错误。还可以设置自定义证书校验回调，读取 subject、issuer、depth、预校验结果和 SAN。 yhirose-cpp-httplib-deep-analysis
双向 TLS 场景下，服务端构造函数接收客户端 CA，客户端提供证书和私钥；两端也支持 `PemMemory`，适合凭据来自环境变量或秘密管理器。测试应覆盖错误 CA、过期证书、SAN 不匹配、mTLS 缺少客户端证书和正确握手，不能只测 localhost。 yhirose-cpp-httplib-deep-analysis
yhirose-cpp-httplib-deep-analysis 在本节的核验记录应围绕 证书校验与 mTLS 展开：固定当前版本、输入样本和运行环境，记录实际输出、错误信息与资源变化，并把与 README 不一致的结果单独列出。第 5 节不能用另一项目的结论替代，尤其要保留本项目的命令、文件路径、协议或权限名称。还要注明测试日期、使用的操作系统、依赖版本和清理动作，让下一次复核可以区分代码变化、环境差异与数据差异。
WebSocket、数据流与平台边界
README 的主要定位是 HTTP/HTTPS，但功能列表还包括 Stream API、Server-Sent Events 和 WebSocket。WebSocket 客户端有 `httplib::ws::WebSocketClient`，wss 场景也有 PemMemory 构造路径。具体消息生命周期、线程安全和断线行为需要继续阅读 README-stream.md、README-sse.md 与 README-websocket.md。 yhirose-cpp-httplib-deep-analysis
32 位平台明确不受支持。即便能编译，项目也没有对 32 位环境做安全审查，可能存在整数截断等问题，且只影响 32 位平台的安全报告会被关闭。仓库提供的是轻量 HTTP/1.1 组件，不应包装成全协议、全平台的网络栈。 yhirose-cpp-httplib-deep-analysis
yhirose-cpp-httplib-deep-analysis 在本节的核验记录应围绕 WebSocket、数据流与平台边界 展开：固定当前版本、输入样本和运行环境，记录实际输出、错误信息与资源变化，并把与 README 不一致的结果单独列出。第 6 节不能用另一项目的结论替代，尤其要保留本项目的命令、文件路径、协议或权限名称。还要注明测试日期、使用的操作系统、依赖版本和清理动作，让下一次复核可以区分代码变化、环境差异与数据差异。
編輯結論
适合需要快速嵌入小型 HTTP/1.1 客户端或服务端、并能接受阻塞式 socket I/O 的 C++ 项目；不适合需要 HTTP/2、HTTP/3、非阻塞模型或 32 位安全保证的人。先用 `httplib.h` 跑通 HTTP 示例，再分别验证 TLS 证书、SAN 主机名、mTLS、超时和大响应行为。
社群筆記