Skip to content
github-actions[bot] edited this page Aug 16, 2026 · 26 revisions

Performance

Titanium targets low-overhead MITM proxying: connection pooling, HTTP/2 multiplexing, and buffer reuse. Numbers below are Release measurements with RpsLoadProbe (and BenchmarkDotNet / Basic example where noted). Absolute RPS varies by hardware, OS, and background load — compare within a table, not across Windows vs Linux.

For pooling knobs and certificate first-visit tuning, see Performance and pooling.

Measurement environment

Windows (developer laptop)

OS Windows 11 (10.0.26200)
CPU 11th Gen Intel Core i7-1185G7 @ 3.00 GHz (8 logical processors)
RAM 31.8 GiB
Runtime .NET 10.0.10
nginx nginx/Windows 1.31.3
Harness RpsLoadProbe Release; arms run sequentially

Linux (GitHub-hosted ubuntu-latest)

OS Ubuntu 24.04.4 LTS
CPU AMD EPYC 7763 (4 logical processors on the VM)
RAM 15.6 GiB
Runtime .NET 10.0.11
nginx nginx/1.24.0 (Ubuntu)
Harness RpsLoadProbe Release; median of 3 repeats where noted

How to read the tables: each row is one client → origin path. Sustainable = last concurrency that still met error/latency SLOs. Peak = highest RPS observed in that ramp. Blank cells with Not possible mean that product cannot do that path. Not measured means the path exists but we have not published a number for that OS yet.

pwsh tools/RpsLoadProbe/run-rps.ps1 -Mode compare-same
pwsh tools/RpsLoadProbe/run-rps.ps1 -Mode compare-terminate
pwsh tools/RpsLoadProbe/run-rps.ps1 -Mode compare-bridges

Windows — Titanium vs nginx

Client / origin columns: HTTP version and whether TLS is used (plain = cleartext, TLS = encrypted, QUIC = HTTP/3).

Client Origin TWP sustain TWP peak nginx sustain nginx peak
HTTP/1 · plain HTTP/1 · plain 29,376 29,376 24,587 24,587
HTTP/1 · TLS HTTP/1 · plain 21,803 21,803 13,826 14,424
HTTP/1 · TLS HTTP/1 · TLS 22,540 22,540 Not possible (no MITM) Not possible
HTTP/2 · TLS HTTP/1 · plain 7,373 7,373 5,898 14,920
HTTP/2 · TLS HTTP/2 · TLS 6,168 6,168 Not possible (no MITM) Not possible
HTTP/2 · TLS HTTP/2 · plain 6,889 6,889 Not possible Not possible
HTTP/2 · plain HTTP/1 · plain 10,757 11,088 Not possible Not possible
HTTP/2 · plain HTTP/2 · plain 6,344 6,344 Not possible Not possible
HTTP/2 · plain HTTP/2 · TLS 6,036 6,036 Not possible Not possible
HTTP/2 · plain HTTP/3 · QUIC 7,587 7,949 Not possible (no QUIC) Not possible
HTTP/3 · QUIC HTTP/1 · plain 2,246 3,541 Not possible (no QUIC) Not possible
HTTP/3 · QUIC HTTP/2 · TLS 1,842 1,842 Not possible (no QUIC) Not possible
HTTP/3 · QUIC HTTP/3 · QUIC 7,335 7,335 Not possible (no QUIC) Not possible
HTTP/1 · TLS HTTP/2 · TLS 8,843 8,843 Not possible Not possible
HTTP/1 · TLS HTTP/3 · QUIC 13,499 13,499 Not possible (no QUIC) Not possible
HTTP/2 · TLS HTTP/3 · QUIC 5,055 5,055 Not possible (no QUIC) Not possible

Windows sources: compare-same / compare-terminate / compare-bridges / reverse-http2-to-h2c / reverse-h2c* (warmup 1s; measure 3–4s; concurrency up to 32 or 64). All published TWP arms 0% error.

nginx/Windows is a limited port. Use it for same-OS comparison only — not as the industry nginx baseline.

Linux — Titanium vs nginx

Median of 3 repeats from Actions run 31936930781 (compare-terminate; warmup 2s / measure 8s; concurrency 8, 16, 32, 64). Linux nginx is the authoritative nginx baseline.

Client Origin TWP sustain TWP peak nginx sustain nginx peak
HTTP/1 · plain HTTP/1 · plain Not measured Not measured Not measured Not measured
HTTP/1 · TLS HTTP/1 · plain 17,040 17,040 27,225 27,225
HTTP/1 · TLS HTTP/1 · TLS Not measured Not measured Not possible (no MITM) Not possible
HTTP/2 · TLS HTTP/1 · plain 10,271 10,271 18,131 18,131
HTTP/2 · TLS HTTP/2 · TLS Not measured Not measured Not possible (no MITM) Not possible
HTTP/2 · TLS HTTP/2 · plain Not measured Not measured Not possible Not possible
HTTP/2 · plain HTTP/1 · plain Not measured Not measured Not possible Not possible
HTTP/2 · plain HTTP/2 · plain Not measured Not measured Not possible Not possible
HTTP/2 · plain HTTP/2 · TLS Not measured Not measured Not possible Not possible
HTTP/2 · plain HTTP/3 · QUIC Not measured Not measured Not possible (no QUIC) Not possible
HTTP/3 · QUIC HTTP/1 · plain Not measured (no msquic on runner) Not measured Not possible (no QUIC) Not possible
HTTP/3 · QUIC HTTP/2 · TLS Not measured Not measured Not possible (no QUIC) Not possible
HTTP/3 · QUIC HTTP/3 · QUIC Not measured Not measured Not possible (no QUIC) Not possible
HTTP/1 · TLS HTTP/2 · TLS Not measured Not measured Not possible Not possible
HTTP/1 · TLS HTTP/3 · QUIC Not measured Not measured Not possible (no QUIC) Not possible
HTTP/2 · TLS HTTP/3 · QUIC Not measured Not measured Not possible (no QUIC) Not possible

On this GHA shape, TWP H1 TLS ÷ nginx H1 TLS ≈ 0.63. Absolute RPS swings by VM; prefer the ratio and median across repeats.

Why isn’t HTTP/3 > HTTP/2 > HTTP/1 in raw RPS?

For tiny JSON responses (~64 B) on loopback, that ordering is not expected: topology (TLS hop count, terminate vs MITM) dominates; HTTP/2 and HTTP/3 help multiplexing, not single-origin tiny-GET RPS.

Other measurements

What Result
HTTPS TTFB vs direct (median, 14 hosts) Cold ≈ parity (−1 ms); warm −25 ms (proxy faster)
HTTP/1 loopback GET (no body intercept) ~186 µs, ~17.5 KB allocated / request
Basic example footprint (Release, after load) ~74 MB working set · ~24–29 MB private bytes
dotnet run -c Release --project benchmarks/Titanium.Web.Proxy.Benchmarks -- --filter '*Throughput*'
Benchmark Setup Mean Allocated / op
HTTP/1 GET through proxy Passthrough 186 µs 17.5 KB
HTTP/2 multiplexed GETs 10 concurrent streams 3.0 ms / batch ~14 KB / request

Raising limits on large hosts

There is no artificial upper clamp on server defaults. Per-endpoint overrides:

Knob Scope Default Override
ProxyServer.MaxCachedConnections process, per upstream host 128 any ≥ 1
ProxyEndPoint.MaxCachedConnections endpoint → pool depth for that EP’s sessions null (use server) e.g. 256 on reverse EP
ProxyEndPoint.MaxConcurrentClients endpoint admission null (off) any ≥ 1
ResourceLimits.MaxConcurrentStreamsPerConnection H2 streams 256 ProxyResourceLimits.Create(...)
TransparentQuicProxyEndPoint.MaxInboundBidirectionalStreams H3 100 (probe uses 256) property on EP
ForwardCleartext transparent TLS terminate false true + decrypt
proxy.MaxCachedConnections = 512;
proxy.ResourceLimits = ProxyResourceLimits.Create(
    /* … */,
    maxConcurrentStreamsPerConnection: 1000,
    maxCachedConnectionsPerHost: 512,
    /* … */);

var ep = new TransparentProxyEndPoint(IPAddress.Any, 443, decryptSsl: true)
{
    ForwardHost = "127.0.0.1",
    ForwardPort = 8080,
    ForwardCleartext = true,
    MaxCachedConnections = 256,
    GenericCertificateName = "example.com"
};
ep.BeforeSslAuthenticate += (_, a) =>
{
    a.UpstreamHttpProtocol = UpstreamHttpProtocol.Http11;
    a.AllowHttpProtocolTranslation = true; // HTTP/2 client → HTTP/1 origin
    return Task.CompletedTask;
};

Clone this wiki locally