waitress Documentation v3.0.1

• 语言: 英语
• 格式: .epub
• 来源: docs.pylonsproject.org

摘要

Waitress是一个纯Python的WSGI服务器，适用于生产环境，性能良好。它仅依赖Python标准库，支持CPython 3.8+和PyPy 3（Python 3.8+），兼容Unix和Windows系统。Waitress支持HTTP/1.0和HTTP/1.1协议，并提供日志记录、反向代理支持等特性。文档详细介绍了Waitress的使用方法、API参数、设计差异等，并提供了版本更新历史、已知问题及支持信息。

AI总结

**《waitress Documentation v3.0.1》总结**

**核心观点：**
Waitress 是一个高质量的纯 Python WSGI 服务器，旨在提供生产级别的性能。它支持 HTTP/1.0 和 HTTP/1.1，适用于 CPython（Python 3.8+）和 PyPy 3（UNIX）。Waitress 不依赖外部库，仅使用 Python 标准库中的模块。

**关键信息：**

1. **版本更新与修复：**
- **3.0.1（未发布）:** 修复了因半开套接字导致的 busy looping 问题，并停止在传递头值前去除空格。
- **3.0.0（2024-02-04）:** 无重大变更。
- **1.2.0（2019-01-15）:** 修复了与代理头相关的安全问题，支持 `X-Forwarded-*` 和 `Forwarded` 头，并增加了对 `trusted_proxy` 的配置选项。
- **1.1.0（2017-10-10）:** 支持 Python 3.6，修复了非 ASCII 字节请求和 HTTP 动词大小写问题。
- **1.0.2（2017-02-04）:** 修复了 Linux 上的 DNS 问题，支持 IPv6。

2. **主要功能：**
- 支持 HTTP/1.1 的 `Transfer-Encoding: chunked` 响应。
- 提供 `wsgi.file_wrapper` 协议支持，优化文件传输。
- 支持反向代理配置，允许通过 `X-Forwarded-*` 和 `Forwarded` 头修改 WSGI 环境。

3. **已知问题：**
- Waitress 本身不支持 TLS，建议通过反向代理（如 Nginx）处理 HTTPS。

4. **支持与开发：**
- 官方支持通过 Pylons Project 网站、GitHub 问题跟踪系统和 Pylons-discuss 邮件列表提供。
- 源代码托管在 [GitHub](https://github.com/Pylons/waitress/) 上，可通过 Git 获取最新版本。

5. **API 与配置：**
- `waitress.serve` 是主要的启动函数，支持多种配置选项，如监听地址、线程数、缓冲区大小等。
- 默认配置项包括 `backlog=1024`、`recv_bytes=8192`、`send_bytes=1` 等。

**总结：**
Waitress 是一个轻量级、高性能的 WSGI 服务器，适合生产环境使用。它通过不断更新修复问题，并增加了对现代 HTTP 协议和安全特性的支持。虽然不支持原生 TLS，但可以通过反向代理解决。开发者可以通过官方渠道获取支持和参与开发。