waitress Documentation v2.1.0

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

摘要

文档详细介绍了Waitress服务器在v2.1.0版本中的更新内容，包括支持预绑定套接字以允许使用已绑定的套接字进行激活，修复了多个安全性和兼容性问题，更新了文档以包含paste.translogger的文档，并移除了对Python 2.7和3.5的支持，增加了对Python 3.10的支持。文档还提到了其他改进，如优化内存使用、处理非HTTP/1.0或1.1请求、改进错误处理机制等。

AI总结

### Waitress 文档总结（版本 2.1.0）

#### 1. 新功能与改进
- **反向代理支持**：新增对预绑定套接字的支持，允许使用已绑定的套接字，适用于需要 socket activation 的初始化系统。
- **服务器头省略**：通过设置 `ident=None` 或 `ident=''` 可以省略服务器头信息。
- **文档更新**：整合了 Pyramid 的 `paste.translogger` 文档，重新组织和清理了文档内容。
- **调试支持**：新增 `log_untrusted_proxy_headers` 选项，便于调试反向代理头部问题。
- **性能优化**：优化了内存使用，修复了长期连接中的输出缓冲问题，避免缓冲区无限制增长。

#### 2. 兼容性与移除
- **Python 版本支持**：
- 移除对 Python 2.7 和 3.5 的支持。
- 完全支持 Python 3.6+（包括 3.10）。
- **asyncore 支持**：将 asyncore 移植到 Waitress 内部（`waitress.wasyncore`），以应对未来 Python 标准库移除 asyncore 的情况。

#### 3. 安全性改进
- **请求头处理**：移除包含下划线的 HTTP 头部，以避免潜在的安全问题。
- **内容长度处理**：修复 Content-Length 头部解析问题，新增对逗号分隔值的支持，并在无法解析时返回 400 错误。

#### 4. Bug 修复
- **HTTP 响应处理**：不再发送 Transfer-Encoding 或 Content-Length 头部（针对 1xx、204、304 状态码），忽略 WSGI 应用发送的消息正文，严格遵循 HTTP 标准。
- **内存泄漏修复**：修复了客户端意外关闭连接时的内存泄漏问题。
- **队列深度警告**：优化队列深度警告逻辑，仅在所有线程忙时显示警告。
- **应用迭代器关闭**：修复应用迭代器在关闭时未正确清理数据的问题。

#### 5. 其他改进
- **IPv6 支持**：支持绑定 IPv4 和 IPv6 套接字，允许通过地址和端口列表指定多个绑定。
- **文件包装器改进**：修复 `wsgi.file_wrapper` 中的文件属性问题，支持范围请求。
- **客户端断开检测**：新增 `waitress.client_disconnected` 回调，允许任务在客户端断开时取消操作。

#### 6. 版本兼容性
- 默认值调整保持与旧版本兼容，但建议用户在配置中显式设置相关变量以避免未来版本变化影响。

#### 7. 其他说明
- Waitress 是一个生产级别的纯 Python WSGI 服务器，支持 HTTP/1.0 和 HTTP/1.1，适用于 Unix 和 Windows（支持 PyPy 3）。
- 项目文档和更多详细信息可参考 [Pylons 项目文档](https://docs.pylonsproject.org/projects/waitress/en/latest/)。