指令参考

proxy_requests

proxy_requests 指令控制 NGINX 是否可以在 stream 模块中处理传入的代理请求。 — NGINX Stream Core

proxy_requests
streamstream server
语法proxy_requests on | off;
默认值off
上下文stream, stream server
模块NGINX Stream Core
参数1

说明

`proxy_requests` 指令在 NGINX Stream 模块中用于将流连接转发到上游服务器，使 NGINX 能够作为 TCP 和 UDP 流量的反向代理。该指令允许管理员指定是否应在指定的 stream server 块中接受代理请求。启用时，NGINX 可以通过维护连接状态来处理会话，并允许客户端与上游服务器通过已配置的 stream 代理设置进行通信。 该指令接受一个参数，可设置为 `off` 或 `on`。将其设置为 `on` 允许 NGINX 将传入请求作为代理请求处理，而 `off` 则禁用此功能，实际效果是终止任何传入连接而不进行代理。在使用此指令时需要考虑应用行为，因为错误使用可能导致意外的连接关闭或在代理被禁用时尝试连接时服务不可用。 在实际使用中，`proxy_requests` 的使用必须与其他 stream 指令仔细配合，以确保网络请求的正确流动和路由。例如，与 `proxy_pass` 指令组合使用时，它可以简化涉及多个上游服务器以维护用户会话或数据流的复杂网络场景。

配置示例

stream {
    server {
        listen 1234;
        proxy_requests on;
        proxy_pass backend_servers;
    }
}
⚠

使用 `proxy_requests off;` 可能会无意中阻止有效的代理请求，导致连接被终止。

⚠

确保将该指令设置在正确的上下文中（即 'stream' 或 'stream server'），因为在其他上下文中使用会导致配置错误。

相关指令

proxy_passlistenserver