waitress Documentation v3.0.1

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

摘要

The document details updates to the Waitress WSGI server, including new features like support for pre-bound sockets, improved logging, and enhanced security measures such as handling reverse proxy headers and clearing untrusted proxy headers. It also covers compatibility changes, bug fixes, and deprecations, including the removal of support for older Python versions and the introduction of warnings for connection limits. The documentation emphasizes security improvements and performance optimizations, such as proper handling of HTTP/1.1 standards and response headers.

AI总结

《Waitress Documentation v3.0.1》总结如下：

### 核心功能与改进
1. **反向代理支持增强**
- 新增`trusted_proxy_count`、`trusted_proxy_headers`、`clear_untrusted_proxy_headers`和`log_untrusted_proxy_headers`等参数，用于更灵活地处理反向代理头，提升安全性。
- 默认设置保持向后兼容，但未来版本可能会更改，建议用户在配置中显式设置这些参数以确保行为一致。

2. **套接字激活支持**
- 支持预绑定的套接字列表，允许使用`init`系统或其他工具创建的激活套接字。相关文档可参考[GitHub PR #215](https://github.com/Pylons/waitress/pull/215)。

3. **服务器头省略功能**
- 通过设置`ident=None`或`ident=''`，可以省略服务器头，提供更多灵活性。

4. **日志记录改进**
- 整合了来自Pyramid的`paste.translogger`文档，重新组织和清理了文档结构，提升易读性和实用性。

5. **HTTP标准合规性**
- 不再发送`Transfer-Encoding`或`Content-Length`头对1xx（信息性）、204（无内容）和304（未修改）响应，并忽略WSGI应用发送的消息正文，严格遵循HTTP标准。

6. **安全增强**
- 禁止WSGI应用设置`hop-by-hop`头（如`Connection`、`Transfer-Encoding`等），避免潜在的安全风险。
- 新增对`Forwarded`头（RFC7239）的支持，增强反向代理环境下的安全性。

7. **兼容性改进**
- 将`asyncore`内联到Waitress中（`waitress.wasyncore`），以应对未来Python标准库可能移除`asyncore`的情况。

8. **性能与稳定性**
- 优化了队列请求机制，改为在通道中队列化请求，而非任务，提升处理效率。
- 修复了`Expect: 100-continue`响应的处理问题，确保正确响应客户端的预期。

### 重要修复
- **内存泄漏与异常处理**
- 修复了由于套接字半开导致的`select()`忙等待问题，避免资源耗尽。
- 修复了头长度计算错误问题，避免返回`413 Request Entity Too Large`错误。

- **日志与调试**
- 默认启用日志记录，调用`logging.basicConfig()`以显示回溯和警告信息，默认输出到控制台。
- 所有输出统一通过`waitress`日志器处理，避免部分情况下的标准错误直接输出。

### 兼容性与版本支持
- **Python版本**
- 支持Python 3.8+和PyPy 3.8+，不再支持Python 2.7、3.2、3.5等旧版本。

- **TLS支持**
- Waitress本身不直接支持TLS，建议在反向代理后使用SSL终止功能。

### 已知问题
- **不支持TLS**
- Waitress不直接支持TLS，需通过反向代理处理SSL。

### 开发与支持
- **社区与资源**
- 主要支持与开发信息可参考Pylons Project官网[https://pylonsproject.org/](https://pylonsproject.org/)。
- 问题报告、讨论组和IRC频道等信息详见文档末尾。

### 总结
Waitress是一个高性能的纯Python WSGI服务器，支持HTTP/1.0和HTTP/1.1，适用于生产环境。v3.0.1版本在反向代理支持、安全性、日志记录和兼容性方面均有重要改进，同时修复了多项关键问题，提升了稳定性和可靠性。建议用户根据需求更新配置，以充分利用新功能并确保系统安全。