FlareProxy

FlareProxy is a transparent http proxy adapter that seamlessly forwards client requests to FlareSolverr and bypass Cloudflare and DDoS-GUARD protection.

Build

FlareProxy is shipped as a OCI container image, and can be built using the Dockerfile provided in the repository root.

docker build -t flareproxy .

Run

To run it replace the FLARESOLVERR_URL env var with the url of your FlareSolverr instance. FlareProxy runs on the port 8080.

docker run -e FLARESOLVERR_URL=http://localhost:8191/v1 -p 8080:8080 flareproxy

Usage

Set FlareProxy as a proxy in your browser or in your agent. Please notice: use http protocol even if you want to fetch https resources because I'm too lazy to deal with SSL connections. FlareProxy will switch automatically to the https protocol to establish the upstream connection.

curl --proxy 127.0.0.1:8080 http://www.google.com

You can use it as a proxy in changedetection, just navigate to settings -> CAPTCHA&Proxies and add it as an extra proxy in the list. Then you can setup your watch using any fetch method.

Docker Compose

Add the snippet to your docker compose stack, i.e.:

  flaresolverr:
    image: ghcr.io/flaresolverr/flaresolverr:latest
    container_name: flaresolverr
    environment:
      - LOG_LEVEL=${LOG_LEVEL:-info}
      - LOG_HTML=${LOG_HTML:-false}
      - CAPTCHA_SOLVER=${CAPTCHA_SOLVER:-none}
      - TZ=Europe/Rome
#    ports:
#    - "8191:8191"
    restart: always
  flareproxy:
    image: flareproxy
    container_name: flareproxy
    environment:
    - FLARESOLVERR_URL=http://flaresolverr:8191/v1
    - TZ=Europe/Rome
#    ports:
#    - "8080:8080"
    restart: always

Development

1. To run it locally use venv to prepare the development environment:

python3 -m venv flareproxy
source flareproxy/bin/activate
pip install -r requirements.txt

2. Run the proxy using the FLARESOLVERR_URL env var

FLARESOLVERR_URL=http://localhost:8191/v1 python3 flareproxy.py

3. Test it with curl

curl --proxy 127.0.0.1:8080 http://www.google.com

Related projects

Shoutout to:

• FlareSolverr
• changedetection
• urlwatch