Skip to content
moqtap

Proxy Mode

Overview

Section titled “Overview”

In proxy mode, moqtap sits between your application and the real MoQT relay, forwarding all traffic while logging everything in both directions.

Your App  ←→  moqtap Proxy  ←→  Real Relay

How it works

Section titled “How it works”
  1. moqtap starts a local QUIC/WebTransport endpoint
  2. Your app connects to moqtap instead of the real relay
  3. moqtap forwards all messages to the upstream relay
  4. Every message in both directions is logged and displayed in the UI

TLS handling

Section titled “TLS handling”
  • moqtap generates a local CA keypair on first run (~/.moqtap/ca/)
  • For WebTransport clients: use serverCertificateHashes to pin the proxy’s cert
  • For native QUIC: trust the moqtap CA or skip verification

Use cases

Section titled “Use cases”
  • Debug your app’s MoQT behavior without modifying the app code
  • See both sides of the conversation (what your app sends vs. what the relay sends)
  • Test how your app handles specific relay responses