A light weight http(s) proxy server written in C#
- Supports HTTPS and all features of HTTP 1.1
- Supports relaying of WebSockets
- Supports script injection
- Async using HTTPWebRequest class for better performance
Refer the HTTP Proxy Server library in your project, look up Test project to learn usage.
Install by nuget:
Install-Package Titanium.Web.Proxy -Pre
After installing nuget package mark following files to be copied to app directory
- makecert.exe
- Titanium_Proxy_Test_Root.cer
Or install manually:
Add reference to
- Titanium.Web.Proxy.dll
These files also should be in your application directory
- Ionic.Zip.dll
- makecert.exe
- Titanium_Proxy_Test_Root.cer
Setup HTTP proxy:
// listen to client request & server response events
ProxyServer.BeforeRequest += OnRequest;
ProxyServer.BeforeResponse += OnResponse;
ProxyServer.EnableSSL = true;
ProxyServer.SetAsSystemProxy = true;
ProxyServer.Start();
//wait here (You can use something else as a wait function, I am using this as a demo)
Console.Read();
//Unsubscribe & Quit
ProxyServer.BeforeRequest -= OnRequest;
ProxyServer.BeforeResponse -= OnResponse;
ProxyServer.Stop();
Sample request and response event handlers
public void OnRequest(object sender, SessionEventArgs e)
{
//To cancel a request with a custom HTML content
//Filter URL
if (e.RequestURL.Contains("somewebsite.com"))
{
e.Ok("<!DOCTYPE html><html><body><h1>Blocked</h1><p>website blocked.</p></body></html>");
}
}
public void OnResponse(object sender, SessionEventArgs e)
{
if (e.ServerResponse.StatusCode == HttpStatusCode.OK)
{
if (e.ServerResponse.ContentType.Trim().ToLower().Contains("text/html"))
{
//Get response body
string responseHtmlBody = e.GetResponseHtmlBody();
//Modify e.ServerResponse
responseHtmlBody = "<html><head></head><body>Response is modified!</body></html>";
//Set modifed response Html Body
e.SetResponseHtmlBody(responseHtmlBody);
}
}
}- Replace makecert.exe with other certificate generation APIs (like bouncy)
- Support modification of web socket requests
- Support HTTP 2.0 Once spec is ready