FlareSolverr

この紹介文は現在英語版のみです。

A powerful proxy server to bypass Cloudflare and DDoS-GUARD protection

Overview

FlareSolverr is a specialized proxy server that helps you access websites protected by Cloudflare and DDoS-GUARD by automatically solving their security challenges. It uses browser automation to solve CAPTCHAs and JavaScript challenges, then returns the HTML content and cookies that can be used in subsequent requests from any HTTP client.

How It Works

FlareSolverr operates as a REST API server that:

1. Receives user requests with target URLs and parameters
2. Launches a headless Chrome browser using Selenium with undetected-chromedriver
3. Navigates to the target URL and automatically solves Cloudflare challenges
4. Returns the page HTML, cookies, and other response data to the client
5. Allows subsequent requests to bypass protection using the provided cookies

This approach effectively simulates a real browser visit, solving the protection mechanisms without manual intervention.

Key Features

• 🌐 Challenge Bypass: Automatically solves Cloudflare and DDoS-GUARD protection
• 🔄 REST API: Simple API interface for easy integration with any application
• 🐳 Docker Support: Ready-to-use Docker image for quick deployment
• 🧩 Session Management: Optional persistent sessions for maintaining state
• ⏱️ Timeout Controls: Configurable timeouts for challenge solving
• 📋 Full Response: Returns HTML content, headers, cookies, and status codes
• 🔧 Customizable: Configurable user agents, proxies, and request parameters
• 📊 Prometheus Metrics: Optional monitoring with Prometheus integration

Quick Start

Docker Installation (Recommended)

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

Docker Compose

version: '3'
services:
  flaresolverr:
    container_name: flaresolverr
    image: ghcr.io/flaresolverr/flaresolverr:latest
    restart: unless-stopped
    ports:
      - "8191:8191"
    environment:
      - LOG_LEVEL=info

Basic API Usage

Sending a request to a protected website:

curl -H "Content-Type: application/json" \
  -d '{"cmd": "request.get", "url":"https://example.com/", "maxTimeout": 60000}' \
  http://localhost:8191/v1

The response includes:

• The complete HTML of the page
• Cookies that can be used for subsequent requests
• HTTP headers and status code
• User agent string for consistent identification

Configuration Options

FlareSolverr can be customized with various environment variables:

• LOG_LEVEL: Control logging verbosity (info, debug)
• HEADLESS: Run browser in headless mode (true/false)
• BROWSER_TIMEOUT: Adjust timeout for browser operations
• TZ: Set timezone for logs and browser
• PROMETHEUS_ENABLED: Enable metrics collection

Use Cases

• Web Scraping: Access protected content for data collection
• API Integration: Allow your applications to access Cloudflare-protected services
• Research: Automated access to websites for research purposes
• Testing: Validate website functionality behind protection layers

System Requirements

• Minimal: 1 CPU core, 1GB RAM
• Recommended: 2+ CPU cores, 2GB+ RAM
• Network: Outbound internet access

License

This project is licensed under the MIT License.

Note: FlareSolverr should be used responsibly and in accordance with website terms of service and applicable laws.