# Titanium-Web-Proxy
**Repository Path**: jetydu/Titanium-Web-Proxy
## Basic Information
- **Project Name**: Titanium-Web-Proxy
- **Description**: A cross-platform asynchronous HTTP(S) proxy server in C#.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-05-12
- **Last Updated**: 2026-11-16
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Titanium Web Proxy
A lightweight, high-performance HTTP(S) proxy for Windows, Linux, and macOS.
**[Website](https://titaniumproxy.com)** · [Download](https://titaniumproxy.com/download) · [Docs](https://titaniumproxy.com/docs/getting-started) · [Releases](https://titaniumproxy.com/releases)
| Product | Best for |
|---------|----------|
| **Titanium.Cli** (`titanium` / `twp`)
[Download](https://titaniumproxy.com/download#cli) | Standalone reverse / edge proxy from the command line |
| **Titanium Inspector**
[Download](https://titaniumproxy.com/download#inspector) | Desktop MITM debugger — session grid, inspectors, AutoResponder, breakpoints, HAR export |
| **Titanium.Plus**
`titanium update --plus` (after installing CLI) | Optional extra features for CLI such as control plane, dashboard, observability |
| **Titanium.Web.Proxy**
[NuGet](https://www.nuget.org/packages/Titanium.Web.Proxy) | Embed a proxy (MITM and/or reverse) in a .NET app |
Requires .NET 10 or later for the library. CLI and Inspector downloads are self-contained (no SDK needed to run them).
[](https://github.com/justcoding121/titanium-web-proxy/actions/workflows/dotnetcore.yml)
[](https://www.nuget.org/packages/Titanium.Web.Proxy)
[](https://www.nuget.org/packages/Titanium.Web.Proxy)
## What you can do
- Decrypt and inspect HTTPS in a native desktop Inspector on Windows, macOS, and Linux — AutoResponder, Map Local/Remote, breakpoints, Composer, HAR, curl/fetch
- Speak modern HTTP — HTTP/2 by default, optional HTTP/3, WebSocket, gRPC, SSE, GraphQL rules in the same grid
- Run the same engine as a reverse / edge proxy from the CLI — YAML routes, load balancing and failover, retries, rate limits, response compression, gRPC-Web, TCP and UDP relay, ACME, live reload, Lua 5.4 and proxy-wasm scripting (`titanium scripting-deps`)
- Deploy on Kubernetes with a hardened container image, Helm charts (git, Release `.tgz`, or OCI), probes, a Gateway API / Ingress controller, and an optional Manager control plane; hot restart for TCP without a gap
- Observe it with Prometheus text, OTLP traces and metrics, and an access log; Plus adds a dashboard, OpenID Connect login, a response cache, fleet rate limits, xDS, and WAF screening
- Embed in .NET via NuGet (MIT); Inspector, Plus, and the xDS / GeoIP satellites are free for personal and education use (PolyForm Noncommercial)
- When a server blocks the proxy (TLS fingerprinting or other reasons), we detect it and automatically tunnel that traffic
Full catalog: [Features](https://titaniumproxy.com/docs/features). What is supported, partial, and not supported: [capability coverage](https://titaniumproxy.com/docs/capabilities). Protocol coverage: [protocol support matrix](https://github.com/justcoding121/titanium-web-proxy/wiki/Protocol-Support). HTTP/3 packaging: [HTTP/3 wiki](https://github.com/justcoding121/titanium-web-proxy/wiki/HTTP-3).
## Performance
Tiny keep-alive GET (~56 B) on common reverse wires, plus WebSocket and unary gRPC:

Heavier reverse load (64 KB GET/POST on typical wires):

**RPS** is requests per second (gRPC bars are **RPC/s**). Compared on the same harness vs **YARP**, **nginx**, **HAProxy**, and **Envoy**. See [Performance](https://github.com/justcoding121/titanium-web-proxy/wiki/Performance).
## Installation
**Inspector and CLI** (Windows, Linux, macOS): use [Download](https://titaniumproxy.com/download) — MSI / DMG / AppImage / `.deb` / `.rpm` / zip. Short walkthrough: [Install](https://titaniumproxy.com/docs/install).
After the CLI is on your PATH (or in the current folder):
```shell
titanium run -c twp.yaml
titanium test -c twp.yaml
titanium version --check
titanium update
```
`titanium run` is foreground (Ctrl+C to stop). Boot persistence: `titanium service install -c twp.yaml` — [CLI — service](https://titaniumproxy.com/docs/cli#service). Each CLI zip also includes a `twp` alias.
**Optional Plus:** `titanium update --plus`, then `plus.enabled: true` — [Plus](https://titaniumproxy.com/docs/plus).
**Container and Helm:** the CLI ships as a hardened image (`ghcr.io/justcoding121/titanium-web-proxy`, linux/amd64 and linux/arm64, with Lua/Wasmtime natives) and charts under `deploy/helm/` (also Release `.tgz` and `oci://ghcr.io/justcoding121/charts`) — [Kubernetes](https://titaniumproxy.com/docs/kubernetes). Gateway API / Ingress: [Gateway API](https://titaniumproxy.com/docs/gateway-api). 7.x→8.0: [migration](docs/migration-7-to-8.md).
```shell
docker run --rm -p 8080:8080 --read-only --tmpfs /tmp -v "$PWD/conf:/etc/titanium:ro" ghcr.io/justcoding121/titanium-web-proxy:latest
helm install titanium deploy/helm/titanium -n proxy --create-namespace -f my-values.yaml
```
### Library (.NET)
```shell
dotnet add package Titanium.Web.Proxy
# Prerelease / beta:
dotnet add package Titanium.Web.Proxy --prerelease
```
## Quick start (library)
Explicit HTTP(S) proxy on `127.0.0.1:8000` that logs each requested URL:
```csharp
using System;
using System.Net;
using System.Threading.Tasks;
using Microsoft.Extensions.Logging;
using Titanium.Web.Proxy;
using Titanium.Web.Proxy.EventArguments;
using Titanium.Web.Proxy.Models;
using var proxyServer = new ProxyServer();
proxyServer.Logging.MinimumLevel = LogLevel.Information;
proxyServer.BeforeRequest += OnRequest;
var endPoint = new ExplicitProxyEndPoint(IPAddress.Loopback, 8000, decryptSsl: true);
proxyServer.AddEndPoint(endPoint);
// Create and trust the root certificate used to decrypt HTTPS traffic.
proxyServer.CertificateManager.EnsureRootCertificate(
userTrustRootCertificate: true,
machineTrustRootCertificate: false);
proxyServer.Start();
proxyServer.Logger.LogInformation("Proxy listening on 127.0.0.1:8000. Press Enter to stop.");
await Console.In.ReadLineAsync();
proxyServer.Stop();
Task OnRequest(object sender, SessionEventArgs e)
{
proxyServer.Logger.LogInformation("{Url}", e.HttpClient.Request.Url);
return Task.CompletedTask;
}
```
Point your client at `127.0.0.1:8000` as its HTTP and HTTPS proxy. Trusting a generated root certificate changes the current user's certificate store — only do this on a machine you control.
## Examples and documentation
- **[Website](https://titaniumproxy.com)** — product docs, [download](https://titaniumproxy.com/download), [getting started](https://titaniumproxy.com/docs/getting-started), [features](https://titaniumproxy.com/docs/features), [release notes](https://titaniumproxy.com/releases)
- **[Wiki](https://github.com/justcoding121/titanium-web-proxy/wiki)** — deeper guides (performance, streaming bodies, HTTP/3, protocol support) and a short [Features](https://github.com/justcoding121/titanium-web-proxy/wiki/Features) pointer
- [Basic console proxy](examples/Titanium.Web.Proxy.Examples.Basic)
- [WPF desktop example](examples/Titanium.Web.Proxy.Examples.Wpf)
- [Windows service example](examples/Titanium.Web.Proxy.Examples.WindowsService)
- [API reference](https://titaniumproxy.com/api/Titanium.Web.Proxy.ProxyServer.html)
## Support and contributing
- Bugs and feature requests: [GitHub Issues](https://github.com/justcoding121/Titanium-Web-Proxy/issues)
- Programming questions: [Stack Overflow](https://stackoverflow.com/questions/tagged/titanium-web-proxy) (`titanium-web-proxy` tag)
- Pull requests welcome — see [CONTRIBUTING.md](CONTRIBUTING.md) (includes local QA tooling for maintainers)
## Code quality
[](https://sonarcloud.io/summary/overall?id=justcoding121_titanium-web-proxy&branch=develop)
[](https://sonarcloud.io/summary/overall?id=justcoding121_titanium-web-proxy&branch=develop)
[](https://sonarcloud.io/summary/overall?id=justcoding121_titanium-web-proxy&branch=develop)
[](https://sonarcloud.io/summary/overall?id=justcoding121_titanium-web-proxy&branch=develop)
[](https://sonarcloud.io/summary/overall?id=justcoding121_titanium-web-proxy&branch=develop)
[](https://sonarcloud.io/summary/overall?id=justcoding121_titanium-web-proxy&branch=develop)
[](https://sonarcloud.io/summary/overall?id=justcoding121_titanium-web-proxy&branch=develop)
[](https://sonarcloud.io/summary/overall?id=justcoding121_titanium-web-proxy&branch=develop)
[](https://sonarcloud.io/summary/overall?id=justcoding121_titanium-web-proxy&branch=develop)
[](https://sonarcloud.io/summary/overall?id=justcoding121_titanium-web-proxy&branch=develop)
[](https://sonarcloud.io/summary/overall?id=justcoding121_titanium-web-proxy&branch=develop)
## Maintainers
Actively maintained by [justcoding121](https://github.com/justcoding121). Past collaborator: [honfika](https://github.com/honfika).
## License
Titanium.Web.Proxy, Titanium.Cli, Titanium.Manager, and Titanium.Gateway are [MIT](LICENSE). Titanium Inspector, Titanium.Plus, Titanium.Xds, and Titanium.Cli.GeoIp are [PolyForm Noncommercial 1.0.0](licenses/PolyForm-Noncommercial-1.0.0.txt). Vendored xDS protos keep their Apache-2.0 text in `src/Titanium.Xds/LICENSE.Apache-2.0.txt` and `src/Titanium.Xds/NOTICE`. Third-party notices for the MIT library are in `src/Titanium.Web.Proxy/NOTICE`.
| Folder | License |
|--------|---------|
| `src/Titanium.Web.Proxy`, `src/Titanium.Web.Proxy.Abstractions`, `src/Titanium.Web.Proxy.Configuration`, `src/Titanium.Web.Proxy.Scripting`, `src/Titanium.Cli`, `src/Titanium.Manager`, `src/Titanium.Gateway`, examples, website, docs, wiki, tools, deploy, and tests other than the four PolyForm test projects | MIT |
| `src/Titanium.Plus`, `src/Titanium.Inspector`, `src/Titanium.Xds`, `src/Titanium.Cli.GeoIp`, `tests/Titanium.Plus.Tests`, `tests/Titanium.Inspector.Tests`, `tests/Titanium.Xds.Tests`, `tests/Titanium.Cli.GeoIp.Tests` | PolyForm Noncommercial 1.0.0 |