讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

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

大瑶姑娘_2769

大瑶姑娘_2769

发布时间:2026-11-19 21:19:05

|

720人浏览过

|

来源于php中文网

原创

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"}。开发者可根据这些参数决定是否启用压缩及设置资源上限。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
nginx 重启
nginx 重启

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

423

2023.07.27

nginx 配置详解
nginx 配置详解

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

4367

2023.08.04

nginx配置详解
nginx配置详解

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

7325

2023.08.04

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

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

601

2024.02.23

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

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

1516

2024.07.09

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

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

3998

2024.08.07

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

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

122

2026.01.13

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

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

617

2026.01.13

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

20

2026.11.17

热门下载

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

精品课程

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

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn