# Pingora 教程

URL: https://caijiao.org/pingora/
Source: docs/pingora/index.md
Description: Pingora 是 Cloudflare 开源的下一代网络代理框架，基于 Rust 构建，旨在提供高性能、可扩展和安全的网络服务能力。本教程将从基础到高级，带你全面掌握 Pingora 的使用与原理。

Pingora 是由 **Cloudflare** 开发并开源的高性能网络代理框架，使用 **Rust** 编写，目标是替代传统的 Nginx 反向代理架构。

![Pingora Banner](/images/pingora/pingora_banner.png)

它通过模块化设计、异步运行时与内建安全机制，为开发者提供构建高并发、高可靠网络服务的全新方式。

## 🧭 教程目标

本教程面向 **初学者与进阶用户**，内容涵盖从环境安装、配置文件、HTTP 代理构建，到内部运行机制与高级主题。  
通过阅读本教程，你将学习：

- 如何安装并运行 Pingora；
- 如何构建 HTTP/HTTPS 代理服务；
- 如何实现优雅重启、错误处理与监控；
- 如何与 Prometheus 集成；
- 深入理解 Pingora 的异步运行时与线程模型；
- 学习 Pingora 的内部机制与性能优化技巧。

## 📘 教程结构

| 章节 | 内容简介 |
|------|-----------|
| 用户指南 | 总览 Pingora 的核心功能与使用方式 |
| 运行 Pingora 服务器 | 启动与管理服务实例 |
| 启动与停止 | 控制服务生命周期的基本命令 |
| 优雅重启与关闭 | 无中断服务升级与安全关闭 |
| 配置文件 | 学习配置语法与常用选项 |
| 守护进程 & Systemd 集成 | 生产环境部署方式 |
| 错误处理与日志 | Panic 处理、错误日志与监控 |
| 构建 HTTP 代理 | 实现基础代理功能的实战 |
| 请求生命周期 | 理解请求在代理中的完整流转过程 |
| 连接管理与复用 | 提升性能的关键优化点 |
| 限速、故障切换与监控 | 保障服务稳定性的机制 |
| 高级与内部主题 | 线程模型、BoringSSL、异步阻塞、Tracing 等 |

## 🚀 开始学习

点击左侧导航栏中的 **「用户指南」** 开始你的 Pingora 学习之旅。  

> 💡 提示：建议你在阅读时配合官方仓库示例，一步步实践，效果更佳。

## 📚 相关资源

- 官方仓库：[https://github.com/cloudflare/pingora](https://github.com/cloudflare/pingora)
- 官方文档：[https://developers.cloudflare.com/pingora/](https://developers.cloudflare.com/pingora/)
- Rust 官方站点：[https://www.rust-lang.org/](https://www.rust-lang.org/)