waitress Documentation v2.1.1

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

摘要

《waitress Documentation v2.1.1》详细记录了Waitress服务器的更新历史、功能改进、错误修复及兼容性调整。Waitress是一个WSGI服务器，支持多版本Python，具备IPv6支持、多socket监听、Unix域socket监听等功能。文档还提到Waitress在处理HTTP响应时的改进，如遵循HTTP标准、防止HTTP响应拆分攻击、优化数据传输等。此外，Waitress还修复了多个Bug，如内存泄漏问题、文件处理问题等，并增强了安全性，如拒绝包含下划线的HTTP头。

AI总结

《Waitress Documentation v2.1.1》主要介绍了Waitress（一个Python WSGI服务器）的更新、修复、兼容性改进和文档优化。以下是核心内容总结：

### 1. **新功能与改进**
- **Socket激活支持**：Waitress现在可以接受预绑定的socket列表，支持通过init系统或其他系统创建的socket激活。
- **Server头省略**：通过设置`ident=None`或`ident=''`，可以省略Server头。
- **IPv6支持**：Waitress现在支持监听多个socket，包括IPv4和IPv6，可以通过`listen`参数指定多个地址和端口。
- **性能优化**：当WSGI应用开始发送数据时，Waitress会尝试直接将数据发送到socket，减少主线程的唤醒，提升传输速度。

### 2. **Bug修复**
- **HTTP标准遵循**：Waitress不再为1xx、204或304响应发送`Transfer-Encoding`或`Content-Length`头，并忽略WSGI应用发送的消息体，确保符合HTTP标准。
- **地址解析修复**：移除了`getaddrinfo`调用中的`AI_ADDRCONFIG`，解决了在没有网络连接时无法绑定到localhost的问题。
- **内存管理**：修复了`BytesIO`对象未正确关闭导致的内存泄漏问题。

### 3. **兼容性**
- **Python版本支持**：Waitress不再支持Python 2.6和3.2，并完全支持Python 3.10。
- **asyncore集成**：Waitress将`asyncore`模块集成到自身中，以应对Python 3.8及以后版本中`asyncore`被移除的情况。

### 4. **安全性**
- **HTTP头处理**：Waitress会丢弃客户端发送的包含下划线的HTTP头，防止下划线/连字符混淆导致的安全问题。
- **HTTP响应拆分防护**：Waitress不再接受包含换行符或回车符的HTTP头和状态行，防止HTTP响应拆分攻击。

### 5. **文档优化**
- **文档重组与清理**：引入了`paste.translogger`的文档，并对现有文档进行了重组和清理，提升了文档的可读性和完整性。

### 6. **其他改进**
- **命令行工具**：新增了`waitress-serve`命令行工具，允许直接运行WSGI应用，无需额外配置。
- **并行测试支持**：支持通过PID依赖的端口或socket进行并行测试。

总结：Waitress v2.1.1在功能、性能、安全性和兼容性方面进行了多项改进和修复，同时优化了文档，提升了用户体验和系统安全性。