Version 0.31.0

CHANGELOG.md

@@ -1,5 +1,17 @@
 # Change Log
 
+## 0.31.0 (2024-09-27)
+
+### Added
+
+Improve `ProxyHeadersMiddleware` (#2468) and (#2231):
+
+- Fix the host for requests from clients running on the proxy server itself.
+- Fallback to host that was already set for empty x-forwarded-for headers.
+- Also allow to specify IP Networks as trusted hosts. This greatly simplifies deployments
+  on docker swarm/kubernetes, where the reverse proxy might have a dynamic IP.
+    - This includes support for IPv6 Address/Networks.
+
 ## 0.30.6 (2024-08-13)
 
 ### Fixed

docs/deployment.md

@@ -385,7 +385,8 @@ For more information, check [`ProxyHeadersMiddleware`](https://github.com/encode
 
 ### Client Port
 
-Currently if the `ProxyHeadersMiddleware` is able to retrieve a trusted client value then the client's port will be set to `0`. This is because port information is lost when using these headers.
+Currently if the `ProxyHeadersMiddleware` is able to retrieve a trusted client value then the client's port will be set to `0`.
+This is because port information is lost when using these headers.
 
 ### UNIX Domain Sockets (UDS)
 
@@ -396,7 +397,6 @@ For example:
 - when NGINX itself is running behind a UDS it will add the literal `unix:` as the client in the `X-Forwarded-For` header.
 - When Uvicorn is running behind a UDS the initial client will be `None`.
 
-
 ### Trust Everything
 
 Rather than specifying what to trust, you can instruct Uvicorn to trust all clients using the literal `"*"`.

uvicorn/__init__.py

@@ -1,5 +1,5 @@
 from uvicorn.config import Config
 from uvicorn.main import Server, main, run
 
-__version__ = "0.30.6"
+__version__ = "0.31.0"
 __all__ = ["main", "run", "Config", "Server"]