Proxy Traffic

APXY captures all HTTP and HTTPS traffic passing through the proxy with full request and response details.

How it works

When you run apxy start, APXY acts as a man-in-the-middle proxy:

1. HTTP traffic is intercepted and logged automatically
2. HTTPS traffic can be inspected when SSL interception is enabled for that domain
3. All captured traffic is stored in a SQLite database for querying

Web UI

In the Capture group, the Traffic view (http://localhost:8082) shows live traffic as it flows through the proxy:

• Live streaming — traffic appears in real time via Server-Sent Events (SSE)
• Density toggle — switch between comfortable and compact views for high-volume capture
• Protocol tabs — filter by All, HTTP, HTTPS, WebSocket, or JSON
• Click any row to see full request/response details, headers, body, timing, and TLS info
• Filter panel — pin filters, save presets, and search by URL/host/method

Use the Setup group to confirm readiness before you begin capturing, and use Analyze views when you want higher-level summaries of the session.

CLI

Start the proxy

apxy start

Additional startup flags for SSL and proxy chaining:

# Deep inspect specific domains from startup
apxy start --ssl-domains "api.example.com,api.staging.com"
 
# Bypass cert-pinned apps (tunnel without inspection)
apxy start --bypass-domains "app.datadoghq.com,*.apple.com"
 
# Intercept all HTTPS traffic
apxy start --mitm-all
 
# Chain through an upstream proxy
apxy start --upstream-proxy "http://proxy.corp.com:3128"
 
# Project-scoped config isolation
apxy start --project-dir ./my-project

See CLI Reference for the full flags reference.

Sessions

Traffic is organized into sessions. Each proxy startup creates a new session. Imported HAR files create a har_import session. Sessions make it easy to isolate and filter traffic from different debugging runs.

System proxy (macOS)

On macOS, apxy start automatically routes all system traffic through APXY. No -x flag needed.

What happens:

1. Auto-detects your active network service (Wi-Fi, Ethernet, etc.)
2. Configures macOS HTTP & HTTPS proxy to localhost:<port>
3. On Ctrl+C, automatically restores original proxy settings

# Override the network service
apxy start --network-service "Ethernet"
 
# Skip system proxy entirely (manual -x mode)
apxy start --no-system-proxy

Manual proxy mode

If you prefer not to use system-wide proxy:

# Start without system proxy
apxy start --no-system-proxy
 
# Route individual requests through the proxy
curl -x http://localhost:8080 https://httpbin.org/get
 
# Or set environment variables
eval $(apxy env)

Stopping the proxy

Press Ctrl+C in the terminal, or from another terminal:

apxy stop

apxy stop sends SIGTERM to the running process and disables the system proxy as a safety net.

Linux setup

On Linux, set proxy environment variables manually:

apxy start --no-system-proxy
 
export http_proxy=http://localhost:8080
export https_proxy=http://localhost:8080

Or use the convenience command:

eval $(apxy env)

For terminal-first inspection, continue to Logs and Request & Response Viewer.