Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mimnix/flareproxy
FlareProxy is a transparent http proxy adapter that seamlessly forwards client requests to FlareSolverr
https://github.com/mimnix/flareproxy
chromium cloudflare cloudflare-challenge monitoring proxy puppeteer self-hosted url-monitor web-scraping website-monitor
Last synced: about 2 hours ago
JSON representation
FlareProxy is a transparent http proxy adapter that seamlessly forwards client requests to FlareSolverr
- Host: GitHub
- URL: https://github.com/mimnix/flareproxy
- Owner: mimnix
- License: gpl-3.0
- Created: 2024-12-21T12:37:48.000Z (21 days ago)
- Default Branch: main
- Last Pushed: 2025-01-10T20:26:49.000Z (about 23 hours ago)
- Last Synced: 2025-01-10T20:34:51.633Z (about 23 hours ago)
- Topics: chromium, cloudflare, cloudflare-challenge, monitoring, proxy, puppeteer, self-hosted, url-monitor, web-scraping, website-monitor
- Language: Python
- Homepage:
- Size: 17.6 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](Dockerfile) provided in the repository root.
```bash
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.
```bash
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.
```bash
curl --proxy 127.0.0.1:8080 http://www.google.com
```
You can use it as a proxy in [changedetection](https://github.com/dgtlmoon/changedetection.io), 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.:
```yaml
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:
```bash
python3 -m venv flareproxy
source flareproxy/bin/activate
pip install -r requirements.txt
```
2. Run the proxy using the FLARESOLVERR_URL env var
```bash
FLARESOLVERR_URL=http://localhost:8191/v1 python3 flareproxy.py
```
3. Test it with curl
```bash
curl --proxy 127.0.0.1:8080 http://www.google.com
```
## Related projects
Shoutout to:
- [FlareSolverr](https://github.com/FlareSolverr/FlareSolverr)
- [changedetection](https://github.com/dgtlmoon/changedetection.io)
- [urlwatch](https://github.com/thp/urlwatch)