Skip to content

FlareSolverr .Net / Proxy server to bypass Cloudflare protection

License

Notifications You must be signed in to change notification settings

FlareSolverr/FlareSolverrSharp

Repository files navigation

FlareSolverrSharp

Latest version NuGet downloads GitHub issues GitHub pull requests Donate PayPal Donate Bitcoin Donate Ethereum

FlareSolverr .Net DelegatingHandler / interceptor. FlareSolverr is a proxy server to bypass Cloudflare protection.

Installation

Full-Featured library:

PM> Install-Package FlareSolverr

Dependencies

You need a running FlareSolverr service.

Issues

Cloudflare regularly modifies their protection challenge and improves their bot detection capabilities.

If you notice that the anti-bot page has changed, or if library suddenly stops working, please create a GitHub issue so that I can update the code accordingly.

Before submitting an issue, just be sure that you have the latest version of the library.

Usage

A DelegatingHandler that handles the challenge solution automatically.

A type for HTTP handlers that delegate the processing of HTTP response messages to another handler, called the inner handler.

It checks on every request if the clearance is required or not, if required, it solves the challenge in background then returns the response.

Websites not using Cloudflare will be treated normally. You don't need to configure or call anything further, and you can effectively treat all websites as if they're not protected with anything.

var handler = new ClearanceHandler("http://localhost:8191/")
{
    MaxTimeout = 60000,
    ProxyUrl = "http://127.0.0.1:8888",
    ProxyUsername = "cool_username",
    ProxyPassword = "password4"
};

var client = new HttpClient(handler);
var content = await client.GetStringAsync("https://uam.hitmehard.fun/HIT");
Console.WriteLine(content);

Full example here

Options

FlareSolverr Service API

You have to set the FlareSolverr service API in the ClearanceHandler constructor. If you set an empty or null endpoint, FlareSolverrSharp will be able to detect challenges, but it will not be able to solve them.

Example: http://localhost:8191/

MaxTimeout

Max timeout to solve the challenge.

MaxTimeout should be greater than 15000 (15 seconds) because starting the web browser and solving the challenge takes time.

Example: 60000

ProxyUrl

The ProxyUrl which will be sent to FlareSolverr.

Example: http://127.0.0.1:8888

ProxyUsername

The ProxyUsername which will be sent to FlareSolverr. (Only if ProxyUrl has been set)

Use this if the proxy you're using requires authentication.

ProxyPassword

The ProxyPassword which will be sent to FlareSolverr. (Only if ProxyUrl has been set)

Use this if the proxy you're using requires authentication.