Pingora 是什么

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

Pingora 经过实战检验，因为它已经为超过几年的时间每秒超过 4000 万的互联网请求提供服务。

功能亮点

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

使用 Pingora 的理由

• 安全性 是您的首要任务：Pingora 是一个更安全的内存选择，适用于用 C/C++ 编写的服务
• 您的服务对性能敏感：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。