Module proxy 

WebSocket proxy handler for frame-level inspection.

This module provides WebSocket frame inspection by intercepting data in Pingora’s body filters after a 101 upgrade. Frames are parsed from the byte stream, sent to agents for inspection, and filtered based on agent decisions.

Architecture

After a 101 upgrade, Pingora treats the bidirectional data as “body” bytes. We intercept these in request_body_filter (client→server) and response_body_filter (server→client), parse WebSocket frames, and apply agent decisions.

Client → [body_filter] → Frame Parser → Agent → Forward/Drop/Close
                               ↓
Server ← [body_filter] ← Frame Parser ← Agent ← Forward/Drop/Close

Structs

CloseReason

Reason for closing the WebSocket connection

WebSocketHandler

WebSocket frame handler for body filter integration.

WebSocketHandlerBuilder

Builder for WebSocketHandler

Enums

ProcessResult

Result of processing WebSocket data

Traits

FrameInspector

Trait for WebSocket frame inspection.