Nginx WebSocket 代理如何配置压缩传输支持

大瑶姑娘_2769

大瑶姑娘_2769

2026-11-19

720人浏览

原创

nginx 代理 websocket 连接时,默认不支持对二进制帧或文本帧进行内容压缩(如 gzip),因为 http 的 `gzip` 模块仅处理应用层响应体,而 websocket 是独立的双向协议。要实现传输压缩,必须在 nginx 配置中启用 `permessage-deflate` 扩展,这通常依赖于 nginx 编译时是否加载了 `ngx_http_websocket_module` 或使用了支持该特性的第三方模块(如 tengine 或 openresty 的 lua 实现)。对于标准 nginx,最可行的方案是在客户端与 nginx 之间协商压缩,或在 nginx 与后端之间通过后端服务自身处理压缩。以下是一个基于 openresty (nginx + lua) 实现 websocket 压缩代理的完整示例,它展示了如何在代理层拦截并处理压缩请求。

Nginx WebSocket 代理如何配置压缩传输支持

如何验证 Nginx 是否支持 permessage-deflate

要验证当前 Nginx 实例是否具备压缩能力,需检查其编译参数或运行时的模块列表。标准开源 Nginx 并不内置 WebSocket 压缩功能,因此直接配置 `gzip on;` 无效。若使用 OpenResty,可通过 Lua 脚本动态处理握手阶段的 `Sec-WebSocket-Extensions` 头。以下代码演示了如何检测客户端支持的扩展并返回协商结果。

Nginx WebSocket 代理如何配置压缩传输支持

-- openresty_lua_ws_compression.lua
local websocket = require "websocket"

-- 初始化 WebSocket 对象
local ws = websocket:new()

-- 在 handshake 阶段处理扩展协商
function _M.handshake(ws)
    local extensions = ws:get_header("sec-websocket-extensions")
    if extensions and string.find(extensions, "permessage-deflate") then
        -- 如果客户端支持,我们同意并启用压缩
        ws:set_extension("permessage-deflate")
        return true
    end
    return false
end

-- 启动监听
ws:listen({host = "0.0.0.0", port = 8080})
while true do
    local client = ws:accept()
    if client then
        coroutine.wrap(function()
            client:handshake()
            while true do
                local msg, typ = client:recv()
                if not msg then break end
                -- 回显消息,压缩由底层库自动处理
                client:send(msg, typ)
            end
        end)()
    end
end

预期结果:当客户端发送包含 Sec-WebSocket-Extensions: permessage-deflate 的握手请求时,服务器将接受该扩展,后续所有数据帧将以压缩形式传输。若客户端不支持,则降级为未压缩传输。

如何处理后端不支持压缩的情况

当后端服务无法处理压缩帧时,Nginx 代理层需要充当“解压器”和“压缩器”。这意味着 Nginx 必须接收来自客户端的压缩数据,解压后发送给后端,再将后端的响应压缩后发回客户端。这种双端转换会增加 CPU 开销,但能确保兼容性。以下代码展示了如何在 OpenResty 中手动解压和压缩数据。

Websocket Hub Patterns
Websocket Hub Patterns

可水平扩展的 WebSocket 中心模式,支持懒加载 Redis 订阅、连接注册表和优雅关闭。适用于构建可跨多实例扩展的实时 WebSocket 服务器。

下载

Nginx WebSocket 代理如何配置压缩传输支持

-- openresty_lua_ws_decompress_recompress.lua
local zlib = require "zlib"
local websocket = require "websocket"

local ws = websocket:new()

function _M.handle_connection(client)
    client:handshake()
    
    while true do
        local raw_msg, typ = client:recv()
        if not raw_msg then break end
        
        -- 判断是否为压缩帧 (R bit set)
        if typ == "binary" and string.byte(raw_msg, 1) & 0x80 ~= 0 then
            -- 解压数据
            local decompressor = zlib.inflate()
            local uncompressed = decompressor(raw_msg)
            decompressor:close()
            
            -- 发送未压缩数据给后端(假设后端只接受明文)
            ngx.log(ngx.INFO, "Sending uncompressed to backend: " .. uncompressed)
            -- 此处应调用后端 API,例如 ngx.socket.tcp
            
            -- 接收后端响应
            local backend_resp = ... -- 从后端获取响应
            
            -- 压缩响应发回客户端
            local compressor = zlib.deflate()
            local compressed = compressor(backend_resp)
            compressor:close()
            
            client:send(compressed, "binary")
        else
            -- 非压缩帧直接透传
            client:send(raw_msg, typ)
        end
    end
end

ws:listen({host = "0.0.0.0", port = 8081})
while true do
    local client = ws:accept()
    if client then
        coroutine.wrap(function()
            _M.handle_connection(client)
        end)()
    end
end

预期结果:客户端发送压缩帧时,Nginx 将其解压后转发给后端;后端返回的数据被 Nginx 压缩后再发给客户端。此过程确保了即使后端不支持 WebSocket 压缩,整体链路仍保持高效传输。

基于 Sec-WebSocket-Protocol 头的具体协商问题

在 WebSocket 握手过程中,Sec-WebSocket-Protocol 头用于指定子协议,而 Sec-WebSocket-Extensions 用于指定扩展(如压缩)。若客户端同时请求多个扩展,Nginx 需决定接受哪些。例如,若客户端发送 permessage-deflate; client_max_window_bits,Nginx 可限制最大窗口大小以控制内存使用。以下代码展示了如何解析并限制扩展参数。

-- openresty_lua_ws_ext_parser.lua
local function parse_extensions(header)
    local exts = {}
    for part in string.gmatch(header, "[^,]+") do
        local name, params = string.match(part, "^([^=;]+)(.*)$")
        if name then
            exts[name] = params or ""
        end
    end
    return exts
end

-- 示例输入
local header = "permessage-deflate; client_max_window_bits=15, server_max_window_bits=10"
local parsed = parse_extensions(header)

-- 输出检查结果
for k, v in pairs(parsed) do
    ngx.log(ngx.INFO, "Extension: " .. k .. ", Params: " .. v)
end

预期结果:解析后的表 parsed 包含键值对 {["permessage-deflate"] = "; client_max_window_bits=15, server_max_window_bits=10"}。开发者可根据这些参数决定是否启用压缩及设置资源上限。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

nginx websocket

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

423

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

4367

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

7325

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

601

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1516

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

3998

3

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

122

12

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

617

23

Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建
Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建

本指南详解Nginx在Windows、macOS及Linux系统的安装全流程。涵盖官方包解压、Homebrew一键部署、APT/YUM源配置及Docker容器化方案。无论新手或开发者,均可快速搭建运行环境,掌握跨平台核心指令,为后续配置与调优奠定坚实基础。

2026.03.16

179

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习