waitress Documentation v3.0.1

《Waitress Documentation v3.0.1》总结： Waitress 是一个高质量的纯 Python WSGI 服务器，旨在提供可接受的性能，且仅依赖于 Python 标准库。它支持 HTTP/1.0 和 HTTP/1.1，运行在 CPython（Python 3.8+）和 PyPy 3（UNIX 上）环境中。 ### 主要更新和特性： 1. **IPv6 支持**：Waitress 现在可以监听多个套接字，包括 IPv4 和 IPv6。用户可以通过传递以空格分隔的地址列表来指定监听地址。 ```python serve(wsgiapp, listen='0.0.0.0:8080 [::]:9090 *:6543') ``` 2. **安全性增强**：Waitress 现在会丢弃客户端发送的包含下划线的 HTTP 头，以防止下划线和连字符混淆导致的安全问题。 3. **Python 版本支持**：不再支持 Python 2.6 和 3.7，新增对 Python 3.11、3.12 和 PyPy 3.9、3.10 的支持。 4. **默认设置更新**：`clear_untrusted_proxy_headers` 默认设置为 `True`，以增强安全性。 5. **Bug 修复**： - 修复了 macOS 上因套接字消失导致的服务器崩溃问题。 - 修复了 HTTP 请求方法和版本验证的问题，确保符合 HTTP 标准。 - 修复了 HEAD 请求响应后不关闭连接的问题。 - 修复了在多线程环境下可能导致的套接字竞争条件问题。 ### 其他特性与改进： - **命令行工具**：新增 `waitress-serve` 命令行工具，无需额外配置即可运行 WSGI 应用。 - **Unix 域套接字支持**：支持监听 Unix 域套接字。 - **日志和错误处理**：标准化日志输出，修复了错误处理中的 Unicode 编码问题。 ### 已知问题与支持： 文档中列出了已知问题，并提供了支持和开发的资源链接。 ### 总结： Waitress 3.0.1 版本通过引入 IPv6 支持、增强安全性、修复多个关键 Bug 以及扩展 Python 版本支持，进一步提升了其作为生产级 WSGI 服务器的稳定性和性能。