FlareSolverr /FlareSolverr
Proxy server to bypass Cloudflare protection
★ 16,236⑂ 1,304👁 81⑃ 217● 1,250▤ 73
+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
#1026Error solving the challenge. SteamDB38 comments · 2023-12-27#1029[yggtorrent] Error: Error solving the challenge. Message: unknown error: session deleted because of page crash35 comments · 2024-01-02#932Flaresolverr crashing on Docker for MAC35 comments · 2023-10-26#1119Exception: Error getting browser User-Agent. <urlopen error [WinError 10054] 26 comments · 2024-03-11#70Provide auto-start scripts for Windows23 comments · 2021-01-17#1599FlareSolverr on Linux works when running from source but not compiled20 comments · 2025-10-26#994Exception: Error getting browser User-Agent. [Errno 1] Operation not permitted18 comments · 2023-12-04#128Implement hCaptcha Bypass16 comments · 2021-05-17
Discussions
#1812Return the browser-fetched response directly instead of relying on cookie replay0 comments · 2026-11-02#1811Traefik + FreshRSS + Flaresolverr2 comments · 2026-11-01#1800Optional sweeper for abandoned sessions, so a client that gives up on sessions.create doesn't leave a Chromium behind forever1 comments · 2026-10-18#1798.0 comments · 2026-10-10#1788Trivy is hooot with flaresolverrr:latest docker container2 comments · 2026-09-29#1781Replacing Chrome with something lighter0 comments · 2026-09-21#1742Docker image update timelines1 comments · 2026-07-08#1740Feedback wanted: Heym Crawler node with FlareSolverr0 comments · 2026-07-05
Latest release
v3.5.2 v3.5.2 2026-09-12cdb8748 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