waitress Documentation v1.1.0

《Waitress Documentation v1.1.0》 总结了 Waitress WSGI 服务器的核心功能、配置选项、API 参数及其历史版本更新。以下是文档的核心内容和关键信息： ### 1. **配置与使用** - Waitress 支持通过 PasteDeploy 配置文件进行声明式配置，允许使用 `PrefixMiddleware` 设置 `PATH_INFO` 和 `SCRIPT_NAME`。 - 示例配置： ```ini [app:myapp] use = egg:mypackage#myapp [filter:paste_prefix] use = egg:PasteDeploy#prefix [pipeline:main] pipeline = paste_prefix myapp [server:main] use = egg:waitress#main listen = 127.0.0.1:8080 ``` ### 2. **API 参数** - `waitress.serve` 函数支持多种参数，包括监听地址、端口、线程数、连接限制等。例如： ```python serve(app, listen='0.0.0.0:8080', threads=4, url_scheme='http', connection_limit=1000) ``` - `listen` 参数支持 IPv4 和 IPv6 地址，格式为 `host:port`，支持通配符和多个地址。 ### 3. **主要功能** - **多协议支持**：支持 HTTP/1.1 的 `Transfer-Encoding: chunked` 响应。 - **文件包装器**：支持 `wsgi.file_wrapper` 协议，优化文件传输。 - **安全性**：默认丢弃包含下划线的 HTTP 头，防止潜在的安全问题。 ### 4. **命令行工具** - `waitress-serve` 是 Waitress 的命令行工具，允许直接运行 WSGI 应用，参数与 `waitress.serve` 函数一致，但使用连字符代替下划线。 ### 5. **版本更新** - **1.1.0 (2017-10-10)**：支持通过 `python -mwaitress` 调用；不再允许小写 HTTP 方法。 - **1.0.0 (2016-08-31)**：支持 IPv6；修复了在没有互联网连接时绑定到本地地址的问题。 - **0.9.0 (2016-04-15)**：增加了对 HTTP 响应拆分的检查，提升了安全性。 - **0.8.4 (2013-05-24)**：引入了 `waitress-serve` 命令行工具，支持 Unix 域套接字。 ### 6. **已知问题** - 在处理非 ASCII URL 时，Waitress 会返回 400 Bad Request，而不是直接关闭连接。 ### 总结： Waitress 是一个功能丰富的 WSGI 服务器，支持多种配置方式和协议，尤其适合在生产环境中使用。其命令行工具 `waitress-serve` 简化了开发和生产部署的流程，同时通过不断更新提升了安全性和兼容性。