waitress Documentation v2.1.1

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

摘要

文档介绍了Waitress在版本2.1.1中的更新，包括支持预绑定套接字列表以允许使用socket激活，修复了对特定HTTP响应的处理，增加了对asyncore的内置支持以应对未来Python标准库的变化，以及改进了文档结构和兼容性。

AI总结

### Waitress 2.1.1 文档总结

#### 1. 新功能
- **预绑定套接字支持**：Waitress 现在支持接受已预绑定的套接字列表，而不是自行创建套接字。此功能适用于使用激活套接字的初始化系统或其他系统。
- **服务器头信息控制**：通过设置 `ident=None` 或 `ident=''`，可以省略服务器头信息。

#### 2. Bug修复
- **HTTP 标准遵循改进**：修复了在处理 1xx、204 和 304 响应时发送 `Transfer-Encoding` 或 `Content-Length` 头的问题，确保完全忽略 WSGI 应用程序发送的消息正文，严格遵循 HTTP 标准。
- **性能优化**：修复了线程在尝试向慢客户端发送数据时卡死的问题。

#### 3. 兼容性改进
- **asyncore 的整合**：将 `asyncore` 移植到 Waitress 中（作为 `waitress.wasyncore`），以应对 Python 3.8 或更高版本中可能移除 `asyncore` 的情况。

#### 4. 文档更新
- 整合了 Pyramid 的 `paste.translogger` 文档，并对文档进行了重新组织和清理，提高了可读性。

#### 5. 安全性改进
- **HTTP 头处理**：移除了包含下划线的 HTTP 头，以防止潜在的安全问题。
- **安全漏洞修复**：修复了与请求走私/拆分相关的安全问题，确保不会处理不可打印的字符。

#### 6. 其他改进
- **IPv6 支持**：支持在多个套接字上监听，包括 IPv4 和 IPv6。
- **WSGI 文件包装协议支持**：增加了对 `wsqi.file_wrapper` 协议的支持。

#### 7. 版本历史
- 2.1.1 版本于 2022 年 3 月 16 日发布。

#### 8. 使用示例
- 基本使用：`from waitress import serve; serve(wsgiapp)`
- 监听多个端口：`serve(wsgiapp, listen='*:8080 [::]:9090 *:6543')`
- UNIX 套接字支持：`serve(wsgiapp, unix_socket='/path/to/unix.sock')`

总结：Waitress 2.1.1 版本在功能、性能和安全性方面均有显著提升，支持更多灵活的配置和更高的安全性。