FlareSolverr /FlareSolverr

Proxy server to bypass Cloudflare protection

★ 16,236⑂ 1,304👁 81⑃ 217● 1,250▤ 73
PythonMITCreated 2020-06-09
下载:v3.5.2v3.5.2 ↓3.5.22026-09-12
+10
日增长
16,236
stars
1,304
forks
81
watchers
217
prs
1,250
issues
73
releases

README

FlareSolverr










FlareSolverr is a proxy server to bypass Cloudflare and DDoS-GUARD protection.

 How it works

FlareSolverr starts a proxy server, and it waits for user requests in an idle state using few resources.
When some request arrives, it uses Selenium with the
undetected-chromedriver
to create a web browser (Chrome). It opens the URL with user parameters and waits until the Cloudflare challenge
is solved (or timeout). The HTML code and the cookies are sent back to the user, and those cookies can be used to
bypass Cloudflare using other HTTP clients.

NOTE: Web browsers consume a lot of memory. If you are running FlareSolverr on a machine with few RAM, do not make
many requests at once. With each request a new browser is launched.

It is also possible to use a permanent session. However, if you use sessions, you should make sure to close them as
soon as you are done using them.

 Installation

 Docker

It is recommended to install using a Docker container because the project depends on an external browser that is
already included within the image.

Docker images are available in:

- GitHub Registry = https://github.com/FlareSolverr/FlareSolverr/pkgs/container/flaresolverr
- DockerHub = https://hub.docker.com/r/flaresolverr/flaresolverr

Supported architectures are:

| Architecture | Tag          |
| ------------ | ------------ |
| x86          | linux/386    |
| x86-64       | linux/amd64  |
| ARM32        | linux/arm/v7 |
| ARM64        | linux/arm64  |

We provide a docker-compose.yml configuration file. Clone this repository and execute
docker-compose up -d _(Compose V1)_ or docker compose up -d _(Compose V2)_ to start
the container.

If you prefer the docker cli execute the following command:

Bash

bash
docker run -d \
  --name=flaresolverr \
  -p 127.0.0.1:8191:8191 \
  -e LOG_LEVEL=info \
  --restart unless-stopped \
  ghcr.io/flaresolverr/flaresolverr:latest


Command Prompt or Powershell

cmd
docker run -d --name=flaresolverr -p 127.0.0.1:8191:8191 -e LOG_LEVEL=info --restart unless-stopped ghcr.io/flaresolverr/flaresolverr:latest


If your host OS is Debian, make sure libseccomp2 version is 2.5.x. You can check the version with sudo apt-cache policy libseccomp2
and update the package with sudo apt install libseccomp2=2.5.1-1~bpo10+1 or sudo apt install libseccomp2=2.5.1-1+deb11u1.
Remember to restart the Docker daemon and the container after the update.

DO NOT expose FlareSolverr to the internet, as it can be abused.

Storage & NVMe/SSD Performance Optimization

By default, on every challenge request, headless browser creates and destroys temporary profile and other relevant data 
inside /tmp. When running inside Docker without a RAM-backed mount, Docker's driver writes these transient files 
directly to the host storage layer (volume), which can generate significant NVMe/SSD read/write wear over time.

To route all temporary browser profi

Top issues

Discussions

Latest release

v3.5.2 v3.5.2 2026-09-12
cdb8748 Update build_package.py
cecf130 Bump Chromium
3ae649a Fix cookies being retrieved before waitInSeconds delay (1692). Thanks @Br1an67
e0fac50 Bump requirements
24e7893 Bump pyinstaller
bc4d136 Fixed multiple buttons bug for tabs_till_verify (1677). Thanks @denis-svg
716451b Make the challenge wait timeout configurable (1766). Thanks @aki-ks
79154ab Disable breaking Local Network Access Checks popup

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON