socket_buffer_size
指令 `wasm_socket_buffer_size` 在 NGINX 中为 Wasm 模块设置套接字缓冲区大小。
Proxy-Wasm support for Nginx powered by wasmtime
语法wasm_socket_buffer_size size;
默认值none
上下文
参数1
说明
指令 wasm_socket_buffer_size 是 NGINX Proxy-Wasm 模块的一部分，允许用户为由 WebAssembly (Wasm) 模块处理的套接字通信设置缓冲区大小。当指定该指令时，它会配置为套接字操作（如从套接字读取或向套接字写入）使用的缓冲区分配的内存量。这可以根据预期的数据负载以及与上游服务器或客户端的交互来优化性能。
该指令接受一个参数，用于指定缓冲区大小，可以使用标准大小后缀来定义（例如 k 表示千字节，m 表示兆字节），从而根据应用需求配置不同的大小。正确设置该值可以确保在高吞吐场景下套接字不会成为瓶颈，尤其是在频繁发生对延迟敏感的操作的环境中。配置错误或默认值过低可能导致丢包或请求失败，而过大的缓冲区则可能导致内存使用效率低下。
重要的是在 NGINX 配置的 http 块中包含 wasm_socket_buffer_size，该设置会对在该上下文中实例化的所有 Wasm 模块生效。因此，关于缓冲区大小的决策应考虑已部署 Wasm 模块对套接字系统施加的总体需求。
配置示例
http {
wasm_socket_buffer_size 8k;
# Further configuration for Wasm modules...
}⚠
确保缓冲区大小在 http 上下文中设置，放在其他地方会导致错误。
⚠
避免将缓冲区大小设置得明显大于典型的网络有效载荷，因为这可能会浪费内存。
⚠
在选择缓冲区大小时，权衡延迟与吞吐量之间的性能取舍。