jingrow/gunicorn
1
0
Fork 0
mirror of https://github.com/frappe/gunicorn.git synced 2026-07-02 18:51:31 +08:00
Code Issues Packages Projects Releases Wiki Activity

Fix http_protocols documentation to use string syntax

Browse Source 
The http_protocols setting expects a comma-separated string, not a list.
Updated all examples in the HTTP/2 guide.

Fixes #3561
This commit is contained in:
Benoit Chesneau 2026-03-26 15:04:34 +01:00
parent d43acb8fe0
commit 7057fc9f89
3 changed files with 11 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
docs/content/2026-news.md
View File

@ -12,6 +12,9 @@
- **ASGI Chunked EOF Handling**: Add `finish()` method to callback parser to handle - **ASGI Chunked EOF Handling**: Add `finish()` method to callback parser to handle
chunked encoding edge case where connection closes before final CRLF after zero-chunk chunked encoding edge case where connection closes before final CRLF after zero-chunk
- **HTTP/2 Documentation**: Fix `http_protocols` examples to use comma-separated string
instead of list syntax ([#3561](https://github.com/benoitc/gunicorn/issues/3561))
### Security ### Security
- **ASGI Parser Header Validation**: Add security checks per RFC 9110/9112: - **ASGI Parser Header Validation**: Add security checks per RFC 9110/9112:

10
docs/content/guides/http2.md
View File

@ -47,7 +47,7 @@ Or in a configuration file:
```python ```python
# gunicorn.conf.py # gunicorn.conf.py
http_protocols = ["h2", "h1"] http_protocols = "h2, h1"
``` ```
The order matters for ALPN negotiation - protocols are tried in order of preference. The order matters for ALPN negotiation - protocols are tried in order of preference.
@ -77,7 +77,7 @@ Or in a configuration file:
# gunicorn.conf.py # gunicorn.conf.py
certfile = "/path/to/server.crt" certfile = "/path/to/server.crt"
keyfile = "/path/to/server.key" keyfile = "/path/to/server.key"
http_protocols = ["h2", "h1"] http_protocols = "h2, h1"
``` ```
### HTTP/2 Settings ### HTTP/2 Settings
@ -95,7 +95,7 @@ Example configuration:
```python ```python
# gunicorn.conf.py # gunicorn.conf.py
http_protocols = ["h2", "h1"] http_protocols = "h2, h1"
http2_max_concurrent_streams = 200 http2_max_concurrent_streams = 200
http2_initial_window_size = 1048576 # 1MB http2_initial_window_size = 1048576 # 1MB
``` ```
@ -391,7 +391,7 @@ certfile = "/etc/letsencrypt/live/example.com/fullchain.pem"
keyfile = "/etc/letsencrypt/live/example.com/privkey.pem" keyfile = "/etc/letsencrypt/live/example.com/privkey.pem"
# HTTP/2 # HTTP/2
http_protocols = ["h2", "h1"] http_protocols = "h2, h1"
http2_max_concurrent_streams = 100 http2_max_concurrent_streams = 100
``` ```
@ -412,7 +412,7 @@ keyfile = "/path/to/server.key"
ssl_version = "TLSv1_2" # Minimum TLS 1.2 for HTTP/2 ssl_version = "TLSv1_2" # Minimum TLS 1.2 for HTTP/2
# HTTP/2 # HTTP/2
http_protocols = ["h2", "h1"] http_protocols = "h2, h1"
http2_max_concurrent_streams = 100 http2_max_concurrent_streams = 100
http2_initial_window_size = 65535 http2_initial_window_size = 65535
``` ```

3
docs/content/news.md
View File

@ -12,6 +12,9 @@
- **ASGI Chunked EOF Handling**: Add `finish()` method to callback parser to handle - **ASGI Chunked EOF Handling**: Add `finish()` method to callback parser to handle
chunked encoding edge case where connection closes before final CRLF after zero-chunk chunked encoding edge case where connection closes before final CRLF after zero-chunk
- **HTTP/2 Documentation**: Fix `http_protocols` examples to use comma-separated string
instead of list syntax ([#3561](https://github.com/benoitc/gunicorn/issues/3561))
### Security ### Security
- **ASGI Parser Header Validation**: Add security checks per RFC 9110/9112: - **ASGI Parser Header Validation**: Add security checks per RFC 9110/9112: