waitress Documentation v2.1.1

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

摘要

Waitress是一个生产级别的纯Python WSGI服务器，具有良好的性能和跨平台支持。文档详细介绍了其功能、设计、API以及不同版本的更新内容，包括安全性修复、对IPv6的支持、对Unix域套接字的支持、对HTTP/1.1协议的兼容性改进等。此外，文档还提供了使用说明、配置选项和部署建议。

AI总结

Waitress 是一个纯 Python 的 WSGI 服务器，旨在提供生产级别的性能和可靠性。以下是文档内容的总结：

### 核心功能
- **生产级性能**：适用于生产环境，性能表现良好。
- **无外部依赖**：仅依赖 Python 标准库。
- **跨平台支持**：支持 Unix、Windows 系统，兼容 CPython 和 PyPy（Python 3.7+）。
- **协议支持**：支持 HTTP/1.0 和 HTTP/1.1。

### 版本更新
#### 2.1.1（2023-03-16）
- **安全修复**：
- 修复了分块编码扩展的安全漏洞，防止 HTTP 请求欺骗攻击。
- 验证分块长度是否为有效十六进制字符，阻止潜在的安全风险。
- **新功能**：
- 添加 `REQUEST_URI` 环境变量，类似于 nginx 的 `request_uri`。
- 提高数据传输效率，直接将数据发送到套接字。

#### 2.0.0（2021-03-07）
- **弃用通知**：多处默认参数更改，需及时更新配置。
- **改进**：
- 修复了多接口监听导致的启动崩溃问题。
- 新增 `server_name` 参数，明确服务器名称配置。
- 支持通过 `ident=None` 省略服务器标识。

#### 其他版本
- **1.2.1**：修复了 IPv6 地址在 `REMOTE_ADDR` 中的显示问题。
- **1.2.0**：增强反向代理支持，改进日志记录。
- **0.8.7**：支持 Unix � domain sockets，修复多项 bug。

### 安全性
- 过滤包含下划线的 HTTP 头，防止潜在的安全漏洞。
- 防止 HTTP 响应拆分攻击，严格验证头和状态行。

### 兼容性
- 支持多套接字监听，包括 IPv4 和 IPv6，允许混合使用。
- 移除对 Python 2.6 和 3.2 的支持，专注于 newer versions。

### 使用建议
- **反向代理**：通过 Nginx 或 Apache 处理 SSL 和 TLS。
- **配置**：注意弃用参数，及时调整配置以避免兼容性问题。

### 资源
- **文档**：详细说明 API、参数和使用方法。
- **支持**：通过 GitHub 问题跟踪、邮件列表和 IRC 频道获取帮助。

### 为什么选择 Waitress？
- 解决 N-by-M 文档负担，提供跨平台和语言版本支持。
- 适合需要广泛平台支持的 web 框架作者和开发者。

总结：Waitress 是一个稳定、可靠且易于使用的 WSGI 服务器，适合需要跨平台支持和生产环境性能的应用。