waitress Documentation v1.4.0

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

摘要

《waitress Documentation v1.4.0》详细介绍了Waitress，一个用于生产的纯Python WSGI服务器，支持HTTP/1.0和HTTP/1.1协议。Waitress不依赖外部库，仅使用Python标准库中的模块，兼容CPython 2.7+和Python 3.4+，以及PyPy 1.6.0。文档涵盖了Waitress的使用方法、日志记录、反向代理设置、设计理念、与zope.server的差异、API参数、文件包装支持、命令行工具、套接字激活等内容。此外，文档还列出了Waitress的版本历史、已知问题（如不支持原生TLS）、支持和开发信息，以及如何报告问题和获取帮助。

AI总结

《Waitress Documentation v1.4.0》 总结：

**核心观点**
Waitress 是一个生产级的纯 Python WSGI 服务器，性能良好，依赖仅为 Python 标准库。它支持 HTTP/1.0 和 HTTP/1.1，适用于 CPython（Python 2.7+ 和 Python 3.4+）以及 PyPy 1.6.0+。Waitress 旨在提供简单、可靠的 WSGI 服务，适用于多种部署场景。

**关键信息**
1. **主要功能**：
- 支持 HTTP/1.1 分块传输编码（Transfer-Encoding: chunked）。
- 提供日志记录功能，默认输出到 Waitress 日志器。
- 支持通过 `waitress-serve` 命令行工具启动服务。

2. **安全与修复**：
- 修复了 HTTP 管道请求处理不当的问题，明确设置 `Connection: close` 头以通知客户端关闭连接。
- 禁止在 HTTP 头字段名和冒号之间出现空格，返回 400 Bad Request。
- 移除不受信任的代理头，防止下游 WSGI 应用误用这些头信息进行安全决策。

3. **兼容性与支持**：
- 支持 IPv6，可同时监听多个套接字（IPv4 和 IPv6）。
- 支持 Python 3.6，并逐步弃用 Python 2.6 和 Python 3.2。
- 提供对 X-Forwarded-* 和 Forwarded (RFC7239) 头的支持，适用于反向代理场景。

4. **开发与支持**：
- 通过 Pylons Project 网站、GitHub 问题跟踪器和邮件列表提供支持。
- 可通过 GitHub 获取最新版本和开发分支。

**总结**
Waitress 是一个轻量级、高性能的 WSGI 服务器，专注于生产环境的稳定性和安全性。它通过持续的安全修复和功能增强，确保在各种部署场景下的可靠运行。开发者可以通过官方渠道获取支持并参与其开发。