Skip to content

Provisional ProxySettingsPolicy proposal #4237

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Nov 11, 2025
Merged

Provisional ProxySettingsPolicy proposal #4237

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
feb37ae
Provisional ProxySettingsPolicy proposal
ciarams87 Nov 7, 2025
9003805
Add non goal for layer 4 routes
ciarams87 Nov 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions docs/proposals/proxy-settings.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@

# Enhancement Proposal-4067: Proxy Settings Policy

- Issue: https://github.com/nginx/nginx-gateway-fabric/issues/4067
- Status: Provisional

## Summary

This Enhancement Proposal introduces the `ProxySettingsPolicy` API that allows Cluster Operators and Application Developers to configure NGINX's proxy buffering and connection settings between the NGINX Gateway Fabric dataplane and upstream applications.

## Goals

- Define proxy settings for buffering configuration.
- Define an API for proxy settings that is extensible to support additional proxy directives in the future.
- Outline the attachment points (Gateway and HTTPRoute/GRPCRoute) for the proxy settings policy.
- Describe the inheritance behavior of proxy settings when multiple policies exist at different levels.

## Non-Goals

- Define the complete set of all proxy directives (only buffering directives are in scope for initial implementation).
- Support for stream (TCP/UDP) proxy buffering configurations (only HTTP/GRPCRoutes are in scope for initial implementation).
Loading