waitress Documentation v1.1.0

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

摘要

文档介绍了Waitress，一个用于Web框架的WSGI服务器，支持多种平台和Python版本。它解决了其他WSGI服务器在平台支持和文档上的不足，提供了更好的日志记录功能和配置方式。文档详细列出了各个版本的更新内容，包括新功能、bug修复和性能优化，并提供了使用说明和API参考。

AI总结

《waitress Documentation v1.1.0》是对Waitress（一个纯Python的WSGI服务器）的官方文档。以下是文档的核心内容总结：

### 1. **简介**
- **初始版本**：0.1于2011年12月30日发布。
- **目标**：提供广泛平台支持，适用于需要跨平台（Windows、Unix、Python 2/3）和跨运行时环境（如PyPy、CPython）的Web框架。
- **优势**：
- 解决了现有WSGI服务器在平台支持上的不足（如Gunicorn不支持Windows，Paste不支持Python 3）。
- 通过统一的平台支持，降低文档和用户混淆。
- 尽管性能不是最优，但适合需要稳定性和广泛兼容性的场景。

### 2. **已知问题**
- **不支持SSL**：Waitress本身不支持SSL，需通过其他工具（如Nginx）实现。

### 3. **功能与改进**
- **版本更新**：
- **1.1.0（2017-10-10）**：
- 支持`python -mwaitress`启动。
- 修复HTTP动词大小写问题，不再接受小写动词。
- 改进非ASCII字符URL处理，避免直接关闭连接，返回400错误。
- **1.0.2（2017-02-04）**：
- 支持Python 3.6。
- 修复Linux下的libc问题，避免因DNS不可用导致服务中断。
- **1.0.1（2016-10-22）**：
- 修复IPv6在Windows上的支持问题。
- 解决Windows下字符串端口传递的错误。
- **1.0.0（2016-08-31）**：
- 支持IPv6和多套接字监听。
- 修复`getaddrinfo`问题，支持绑定到本地主机。
- 安全性改进：移除包含下划线的HTTP头，防止潜在的安全问题。
- **其他功能**：
- 支持WSGI文件包装协议（`wsgi.file_wrapper`）。
- 支持Unix域套接字。
- 提供命令行工具`waitress-serve`，用于运行WSGI应用。
- 支持并行测试和PID依赖的端口/套接字。

### 4. **安全性**
- **HTTP头处理**：
- 移除包含下划线的HTTP头，防止与短横线的混淆。
- 禁止包含换行符/回车符的HTTP头和状态码，防止HTTP响应拆分攻击。
- **异常处理**：
- 修复了`start_response`在异常情况下的行为，避免数据未发送时错误重放。

### 5. **支持与开发**
- **资源**：
- 官方网站：[http://pylonsproject.org/](http://pylonsproject.org/)
- 问题追踪：[http://github.com/Pylons/waitress/issues](http://github.com/Pylons/waitress/issues)
- 邮件列表：[http://groups.google.com/group/pylons-devel](http://groups.google.com/group/pylons-devel)
- IRC频道：#pyramid
- **贡献指南**：[http://docs.pylonsproject.org/index.html#contributing](http://docs.pylonsproject.org/index.html#contributing)

### 6. **总结**
- Waitress是一个为Web框架作者设计的轻量级、跨平台的WSGI服务器，特别适合需要广泛平台支持的场景。
- 其核心目标是通过统一的平台支持，降低文档负担和用户混淆。
- 通过多次版本更新，解决了多项性能、兼容性和安全性问题，同时新增了对IPv6、Unix套接字和Python 3.6+的支持。
- 尽管在性能上不一定是最快的，但其稳定性和广泛的平台支持使其成为一个可靠的选择。