Nginx Gzip Filter 模塊源碼分析：壓縮流程與關鍵數據結構

Nginx Gzip Filter 模塊源碼分析：壓縮流程與關鍵數據結構

參考 zlib 官方 API：deflateInit2。模塊分為頭部過濾器 ngx_http_gzip_header_filter 和主體過濾器 ngx_http_gzip_body_filter。

Header Filter 階段

1. 驗證配置，決定是否啟用 gzip 壓縮。
2. 為請求創建上下文 ctx，雙向關聯 request。
3. 根據 gzip_buffers 設置 wbits、memlevel，計算需預分配內存大小 allocated。
4. 向響應頭插入 Content-Encoding: gzip。
5. 刪除 Content-Length（壓縮後大小未知）。

Body Filter 階段

1. 獲取 ctx，將輸入鏈 in 的 buf 複製到 ctx->in（ngx_http_gzip_filter_buffer）。
2. 調用 ngx_http_gzip_filter_deflate_start：分配 preallocated 空間，初始化 z_stream 結構（設置分配/釋放回調、輸入輸出緩衝區）。
3. ngx_chain_add_copy 將 in 的 buf 掛入 ctx->in。
4. ngx_http_gzip_filter_add_data：設置 zstream->next_in/avail_in，判斷是否為最後一個 buf（決定 flush 模式）。
5. ngx_http_gzip_filter_get_buf：創建臨時輸出 buf（大小 conf->bufs.size），設置 zstream->next_out。
6. ngx_http_gzip_filter_deflate：調用 deflate() 執行壓縮。
7. 再次 add_data 處理剩餘輸入。
8. 調用 ngx_http_next_body_filter(r, ctx->out) 將壓縮後的輸出鏈傳遞給下一個過濾器，實現輸出流重定向。

關鍵數據結構

• ngx_http_gzip_ctx_t：保存 z_stream、輸入/輸出鏈、預分配內存指針、flush 模式、allocated 大小等。
• z_stream：zlib 核心結構，包含輸入輸出指針、可用空間、內存管理回調、壓縮狀態等。