waitress Documentation v1.3.1

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

摘要

文档介绍了 Waitress 服务器的最新版本（v1.3.1）及其更新内容。主要更新包括：支持预绑定套接字列表、允许通过设置 ident=None 省略服务器头、修复了 Transfer-Encoding 和 Content-Length 的处理问题、将 asyncore 内部化为 waitress.wasyncore 以应对 Python 标准库移除 asyncore 的情况，以及重新整理文档。此外，还包括对 IPv6 的支持、多套接字监听功能、安全增强（如丢弃包含下划线的 HTTP 头）、反向代理配置支持、使用 url_prefix 前缀影响 SCRIPT_NAME 和 PATH_INFO 等功能。文档还详细说明了如何配置反向代理和使用 Forwarded 头。

AI总结

《waitress Documentation v1.3.1》总结如下：

### 主要更新和功能

1. **支持预绑定套接字**
- Waitress 现在支持接受已预绑定的套接字列表，允许使用已激活的套接字。此功能不包含对 init 系统或其他创建激活套接字的系统的原生支持。

2. **服务器头省略**
- 通过设置 `ident=None` 或 `ident=''`，可以省略服务器头。

3. **Bug修复**
- 修复了对 1xx、204 和 304 响应的处理，不再发送 `Transfer-Encoding` 或 `Content-Length`，并忽略 WSGI 应用程序发送的消息正文，以符合 HTTP 标准。

4. **兼容性更新**
- 将 `asyncore` 作为 `waitress.wasyncore` 内部 vendoring，以应对未来 Python 标准库移除 `asyncore` 的情况。建议使用 `asyncio` 替代。

5. **文档更新**
- 整合了 `paste.translogger` 的文档，重新组织并清理了现有文档，提高可读性。

6. **反向代理支持**
- 配置 Apache 时，设置 `RequestHeader set X-Forwarded-Proto https`。
- 通过 `trusted_proxy_headers` 配置信任的代理头，支持 `X-Forwarded-*` 和 `Forwarded` 标准头。

7. **URL 前缀支持**
- 使用 `url_prefix` 参数设置默认的 URL 前缀，影响 `SCRIPT_NAME` 和 `PATH_INFO`，适用于反向代理场景。

8. **设计改进**
- 使用 `wasyncore` 处理异步 I/O，通过线程服务请求。`asyncore` 已 deprecated，建议使用 `asyncio` 替代。

### 其他重要信息

- **旧版本更新**
- **1.0.0 版本**：增加了 IPv6 支持和多套接字监听功能，支持通过 `listen` 参数指定多个地址和端口。弃用 Python 2.6 支持。
- **0.9.0 版本**：不再支持 Python 3.2 和 2.6，增强了安全保护，防止 HTTP 响应分隔攻击。
- **0.8.4 版本**：新增命令行工具 `waitress-serve`，支持 Unix 域套接字，修复了大缓冲区溢出问题。

### 总结

文档详细介绍了 Waitress 的功能、更新、配置和安全注意事项，帮助用户更好地理解和使用该服务器。核心内容包括新功能、bug修复、兼容性改进、安全增强和文档优化。