Pingora 教程
Pingora 是由 Cloudflare 开发并开源的高性能网络代理框架，使用 Rust 编写，目标是替代传统的 Nginx 反向代理架构。
它通过模块化设计、异步运行时与内建安全机制，为开发者提供构建高并发、高可靠网络服务的全新方式。
🧭 教程目标
本教程面向 初学者与进阶用户，内容涵盖从环境安装、配置文件、HTTP 代理构建，到内部运行机制与高级主题。
通过阅读本教程，你将学习：
- 如何安装并运行 Pingora；
- 如何构建 HTTP/HTTPS 代理服务；
- 如何实现优雅重启、错误处理与监控；
- 如何与 Prometheus 集成；
- 深入理解 Pingora 的异步运行时与线程模型；
- 学习 Pingora 的内部机制与性能优化技巧。
📘 教程结构
| 章节 | 内容简介 |
|---|---|
| 用户指南 | 总览 Pingora 的核心功能与使用方式 |
| 运行 Pingora 服务器 | 启动与管理服务实例 |
| 启动与停止 | 控制服务生命周期的基本命令 |
| 优雅重启与关闭 | 无中断服务升级与安全关闭 |
| 配置文件 | 学习配置语法与常用选项 |
| 守护进程 & Systemd 集成 | 生产环境部署方式 |
| 错误处理与日志 | Panic 处理、错误日志与监控 |
| 构建 HTTP 代理 | 实现基础代理功能的实战 |
| 请求生命周期 | 理解请求在代理中的完整流转过程 |
| 连接管理与复用 | 提升性能的关键优化点 |
| 限速、故障切换与监控 | 保障服务稳定性的机制 |
| 高级与内部主题 | 线程模型、BoringSSL、异步阻塞、Tracing 等 |
🚀 开始学习
点击左侧导航栏中的 「用户指南」 开始你的 Pingora 学习之旅。
💡 提示：建议你在阅读时配合官方仓库示例，一步步实践，效果更佳。
📚 相关资源
- 官方仓库：https://github.com/cloudflare/pingora
- 官方文档：https://developers.cloudflare.com/pingora/
- Rust 官方站点：https://www.rust-lang.org/
相关内容
- 高级主题 (WIP) 探索 Pingora 的高级特性，包括内部机制、异步运行时、线程模型和自定义扩展。
- 后台服务 学习如何在 Pingora 中配置和运行后台服务，包括定时任务、异步执行和守护进程管理。
- 异步上下文中的阻塞代码 学习如何在 Pingora 异步运行时中处理阻塞代码，确保高并发请求环境下的性能和稳定性。
- 构建 HTTP 代理 学习如何使用 Pingora 构建 HTTP 代理服务，包括基本请求转发、上游配置和自定义过滤器。
- 配置文件 了解 Pingora 的配置文件结构、主要参数及其作用，学习如何为不同场景编写高效、清晰的配置。
- 连接池与复用 学习如何在 Pingora 中使用连接池和连接复用，提高代理服务的性能和资源利用率。