如何配置lighttpd服务器以解压客户端发送的gzip格式HTTP请求

好问题！lighttpd 默认并没有像处理响应压缩那样内置专门的请求解压模块，但我们可以通过 mod_magnet 配合 Lua 脚本来实现这个功能，刚好能解决你在低带宽环境下上传大请求体（比如10MB固件）的痛点。

下面是具体的实现步骤：

1. 启用必要的lighttpd模块 #

首先修改你的lighttpd.conf配置文件，启用mod_magnet（用来拦截并修改请求）和可选的mod_setenv（辅助管理请求头）：

server.modules += ( "mod_magnet" )
server.modules += ( "mod_setenv" )

2. 编写Lua解压脚本 #

创建一个名为decompress_request.lua的脚本，用来检测gzip编码的请求体并完成解压。脚本需要依赖Lua的zlib库，所以先确保你的系统安装了对应包（比如Debian/Ubuntu上安装lua-zlib，CentOS上安装lua-zlib或lua5.1-zlib）。

脚本内容如下：

local function decompress_gzip(req)
    -- 检查请求是否携带gzip编码标识
    local content_encoding = req.env["HTTP_CONTENT_ENCODING"]
    if not content_encoding or not string.find(content_encoding:lower(), "gzip") then
        return -- 非gzip请求，直接跳过
    end

    -- 读取原始请求体
    local content_length = tonumber(req.env["CONTENT_LENGTH"])
    if not content_length or content_length <= 0 then
        req:respond{ status = 400, body = "Empty or invalid request body" }
        return
    end

    local raw_body = req:read(content_length)
    if not raw_body then
        req:respond{ status = 400, body = "Failed to read request body" }
        return
    end

    -- 执行gzip解压
    local zlib = require("zlib")
    local decompressor = zlib.inflate()
    local decompressed_body, eof, _, _ = decompressor(raw_body)

    if not decompressed_body or not eof then
        req:respond{ status = 400, body = "Invalid gzip compressed content" }
        return
    end

    -- 更新请求体和请求头，让后端能正确处理
    req:set_body(decompressed_body)
    req.env["HTTP_CONTENT_ENCODING"] = nil -- 移除编码标识
    req.env["CONTENT_LENGTH"] = tostring(#decompressed_body) -- 更新内容长度
    -- 如果你后端期望固定的Content-Type，这里可以强制设置，比如你的JSON场景
    req.env["CONTENT_TYPE"] = "application/json"
end

-- 触发解压逻辑
decompress_gzip(request)

3. 配置mod_magnet拦截目标请求 #

在lighttpd.conf中添加规则，让脚本只作用于你需要处理压缩请求的路径（比如你的API端点）：

-- 替换为你的实际API路径，比如/api/开头的请求
$HTTP["url"] =~ "^/api/" {
    magnet.attract-physical-path = ( "/usr/local/lighttpd/scripts/decompress_request.lua" )
}

记得把/usr/local/lighttpd/scripts/替换为你存放Lua脚本的实际路径，同时确保lighttpd进程对该脚本有读取权限。

额外注意事项 #

• 大文件处理：如果处理超大请求体（比如几十MB的固件），上述脚本是一次性读取全部内容到内存，可能会有内存压力。如果需要优化，可以改用流式解压的方式（Lua zlib支持流式处理），避免内存占用过高。
• 后端兼容性：确保你的后端服务能正确读取mod_magnet修改后的请求体，大部分CGI/FastCGI后端都能直接处理，无需额外配置。
• 测试验证：可以先用小体积的压缩请求测试，确认解压逻辑正常后，再测试大文件上传场景，同时监控lighttpd的内存和CPU占用情况。

内容的提问来源于stack exchange，提问作者Bedřich Schindler