waitress Documentation v1.1.0

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

摘要

《waitress Documentation v1.1.0》详细介绍了Waitress的功能、设计差异、API参数及其在PasteDeploy配置中的应用。文档涵盖了Waitress的版本更新历史，包括新特性如IPv6支持、命令行工具waitress-serve的引入，以及修复的Bug如HTTP动词大小写处理、IPv6在Windows上的支持问题。此外，文档还提供了Waitress的详细参数说明，如listen、host、port等，并解释了如何在开发和生产环境中使用Waitress。

AI总结

《Waitress Documentation v1.1.0》 总结了 Waitress WSGI 服务器的核心功能、配置选项、API 参数及其历史版本更新。以下是文档的核心内容和关键信息：

### 1. **配置与使用**
- Waitress 支持通过 PasteDeploy 配置文件进行声明式配置，允许使用 `PrefixMiddleware` 设置 `PATH_INFO` 和 `SCRIPT_NAME`。
- 示例配置：

     [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` 函数支持多种参数，包括监听地址、端口、线程数、连接限制等。例如：

     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` 简化了开发和生产部署的流程，同时通过不断更新提升了安全性和兼容性。