Pingora

Pingora 是什么

Pingora 是一个 Rust 框架，用于构建快速、可靠和可编程的网络系统。

Pingora 经过实战检验，已经为超过 4000 万互联网请求/秒提供服务数年之久。

主要特性

• 异步 Rust：快速可靠
• HTTP 1/2 端到端代理
• 基于 OpenSSL 或 BoringSSL 的 TLS
• gRPC 和 WebSocket 代理
• 优雅重载
• 可自定义的负载均衡和故障转移策略
• 支持多种可观察性工具

使用 Pingora 的理由

• 安全是您的首要任务：对于用 C/C++ 编写的服务，Pingora 是一个更安全的内存替代方案
• 您的服务对性能敏感：Pingora 快速高效
• 您的服务需要广泛的定制化：Pingora 代理框架提供的 API 具有高度可编程性

入门指南

查看我们的快速入门指南，了解构建负载均衡器是多么简单。

我们的用户指南涵盖了更多主题，如如何配置和运行 Pingora 服务器，以及如何基于 Pingora 框架构建自定义 HTTP 服务器和代理逻辑。

所有 crate 的 API 文档也可用。

工作空间中的重要 crate

• Pingora：用于构建网络系统和代理的"面向公众"的 crate
• Pingora-core：定义协议、功能和基本特征的 crate
• Pingora-proxy：构建 HTTP 代理的逻辑和 API
• Pingora-error：Pingora crate 中使用的通用错误类型
• Pingora-http：HTTP 头定义和 API
• Pingora-openssl 和 pingora-boringssl：SSL 相关扩展和 API
• Pingora-ketama：Ketama 一致性算法
• Pingora-limits：高效计数算法
• Pingora-load-balancing：pingora-proxy 的负载均衡算法扩展
• Pingora-memory-cache：异步内存缓存，带缓存锁以防止缓存雪崩
• Pingora-timeout：更高效的异步计时器系统
• TinyUfo：pingora-memory-cache 背后的缓存算法

系统要求

系统

Linux 是我们的一级环境和主要关注点。

我们将尽最大努力使大多数代码能在 Unix 环境中编译。这是为了让开发者和用户能更轻松地在类 Unix 环境（如 macOS）中使用 Pingora 进行开发（尽管某些功能可能缺失）。

我们将同时支持 x86_64 和 aarch64 架构。

Rust 版本

Pingora 采用 6 个月的滚动 MSRV（最低支持的 Rust 版本）策略。这意味着我们将接受升级 MSRV 的 PR，只要新使用的 Rust 版本至少已发布 6 个月。

我们当前的 MSRV 是 1.72。

构建要求

本仓库中的一些 crate 依赖于额外的工具和库，必须满足这些要求才能构建它们：

• 确保系统上安装了 Clang（用于 boringssl）
• 确保系统上安装了 Perl 5（用于 openssl）

贡献

请参阅我们的贡献指南。

许可证

本项目采用 Apache License, Version 2.0 许可。