wasm_socket_connect_timeout

设置 NGINX 中建立 WebAssembly 套接字连接的超时时间。

语法wasm_socket_connect_timeout time;
默认值none
上下文http, server, location
参数1

说明

wasm_socket_connect_timeout 指令指定在使用 Proxy-Wasm 功能时,NGINX 中等待 WebAssembly (Wasm) 套接字连接建立的最长时间。该指令可在 httpserverlocation 上下文中使用,允许在服务器配置的不同部分进行灵活设置。通过强制超时限制可以防止连接挂起,在高流量场景或网络较慢的情况下尤其有用。

该指令的参数是一个时间值,可以用秒或类似 60s1m 等时间格式指定。当在指定的超时时间内未建立连接时,将产生错误,允许 NGINX 服务器继续其操作而不会被无限期阻塞。这对于保持服务响应性至关重要,尤其是在使用 WebAssembly 模块实现如 API 网关或边缘处理等功能时。

您还可以根据应用的预期性能和通过 WebAssembly 执行的操作特性设置不同的超时值。调整该指令有助于在响应速度与因网络状况导致的实际连接延迟之间取得平衡。

配置示例

wasm {
    module my_filter /path/to/filter.wasm;
}

http {
    wasm_socket_connect_timeout 30s;
    server {
        listen 9000;
        location / {
            proxy_wasm my_filter;
            proxy_pass http://backend;
        }
    }
}

确保超时值符合您应用对连接的预期;过短可能会导致连接错误。

使用过长的超时值可能会因响应缓慢而导致用户体验下降。

← 返回所有指令