FlareSolverr: Guia Completo Passo a Passo [2026]

FlareSolverr é essencialmente um servidor proxy projetado para contornar as defesas anti-bot do Cloudflare. Ele atua como um intermediário entre sites protegidos pelo Cloudflare e suas solicitações de recuperação de dados. Usando Python, Selenium e ChromeDriver, o FlareSolverr permite que os usuários contornem os desafios do Cloudflare e acessem conteúdo web seguro de maneira eficiente.

Este tutorial fornece uma visão detalhada do FlareSolverr, incluindo instruções de instalação para Linux, Docker e Windows. Também explica a configuração para diferentes cenários, cobrindo variáveis de ambiente, Cloudflare, Plex, Prometheus e integração com outras ferramentas como Jackett e Prowlarr.

Aviso Legal

Este guia é destinado exclusivamente para fins educacionais. Não endossa qualquer atividade, produto ou serviço ilegal. Os usuários são responsáveis por cumprir todas as leis aplicáveis, incluindo regras de propriedade intelectual. Não somos responsáveis por quaisquer danos resultantes do uso deste guia.

1. Introdução ao FlareSolverr

a. O que é FlareSolverr?

O Cloudflare fornece soluções de segurança, como proteção contra bots, mitigação de DDoS e salvaguardas de privacidade do usuário. Para distinguir humanos de bots, o Cloudflare usa desafios em JavaScript, CAPTCHAs e técnicas de impressão digital. Embora esses obstáculos impeçam atividades maliciosas de bots, eles podem também bloquear tarefas automatizadas legítimas.

FlareSolverr é um servidor proxy de código aberto que ajuda a superar as proteções anti-bot do Cloudflare simulando um ambiente de navegador real.

Nota: Nem todos os bots são prejudiciais. Bots podem executar tarefas legítimas, como web scraping, rastreamento de motores de busca, monitoramento ou auxiliando aplicativos de IA.

b. Como funciona o FlareSolverr?

FlareSolverr atua como um proxy que imita o comportamento de um navegador humano para contornar os desafios do Cloudflare. O fluxo de trabalho típico é:

1. Um cliente (por exemplo, biblioteca HTTP em Python) envia uma solicitação.
2. O FlareSolverr, inicialmente inativo, inicia um navegador Chrome por meio do Python Selenium e do Undetected ChromeDriver.
3. A solicitação é encaminhada para o site protegido pelo Cloudflare.
4. Desafios do Cloudflare são resolvidos automaticamente.
5. O site responde e o FlareSolverr retorna o HTML e os cookies ao cliente.

Isso permite que os dados resultantes sejam usados com outros clientes HTTP, como Python Requests.

c. Casos de Uso Comuns

FlareSolverr suporta várias aplicações, incluindo:

• Contornar a proteção do Cloudflare para web scraping (notícias, comércio eletrônico, monitoramento de preços).
• Acesso a indexadores de torrent e Usenet via Jackett, Prowlarr e Sonarr/Radarr.
• Fornecer acesso remoto estável a servidores Plex atrás do Cloudflare.
• Monitorar APIs protegidas pelo Cloudflare com Prometheus.
• Alimentar modelos de IA/LLM com conteúdo coletado.
• Integrar com navegadores sem cabeça como Playwright ou Puppeteer para scraping discreto.
• Contornar algumas barreiras de CAPTCHA (sucesso limitado; solucionadores de terceiros podem ser necessários).

d. Vantagens e Desvantagens

Vantagens:

• Contorno automatizado dos desafios do Cloudflare.
• Extração eficiente de dados de websites protegidos.
• Simulação de navegador sem interrupções para acesso confiável.
• Integração fácil com fluxos de trabalho em Python, Selenium e ChromeDriver.
• HTML e cookies podem ser usados com outros clientes HTTP.

Desvantagens:

• Questões legais e éticas—contornar mecanismos anti-bot pode violar os termos de serviço.
• Carga adicional no servidor dos websites-alvo.
• Alto consumo de recursos devido a instâncias de navegador e resolução de JavaScript.
• Dependência de ferramentas externas como Selenium e ChromeDriver.
• O tratamento de CAPTCHA pode ser limitado; solucionadores de terceiros como 2Captcha ou CapSolver podem ser necessários.

2. Instalando o FlareSolverr

a. Instalação no Linux

Pré-requisitos: Python 3.11+, pip.

Passos:

1. Abra o terminal e crie uma pasta:

mkdir FlareSolverr
cd FlareSolverr

2. Baixe o binário mais recente do GitHub oficial.
3. Extraia o arquivo:

tar -xzf flaresolverr_linux_x64.tar.gz
cd flaresolverr

4. Execute o FlareSolverr:

./flaresolverr

O acesso está disponível em http://0.0.0.0:8191.

Solução de Problemas:

• Falta libatk-1.0.so.0 → sudo apt install libatk1.0-0
• Falta Xvfb → sudo apt install xvfb

Dica: O Chrome moderno suporta modo sem cabeça, tornando o Xvfb opcional.

b. Instalação no Docker

1. Clone o repositório:

git clone https://github.com/FlareSolverr/FlareSolverr.git
cd FlareSolverr
sudo docker-compose up -d

2. Verifique o contêiner:

sudo docker ps

3. Acesse o FlareSolverr em http://localhost:8191.

Suporta várias arquiteturas: x86, x86-64, ARM32, ARM64.

c. Instalação no Windows

1. Baixe o binário Windows x64 do GitHub.
2. Extraia e execute FlareSolverr.exe.
3. Permita o acesso pelo firewall.

3. Configurando o FlareSolverr

a. Alterando Variáveis de Ambiente

Linux:

export LOG_LEVEL=debug
export TZ=America/New_York

Docker: Modifique docker-compose.yml na seção environment.
Windows:

set LOG_LEVEL=debug

set TZ=Europe/London

---

### b. Configuração do Cloudflare

Defina variáveis de ambiente chave:

```bash
export CAPTCHA_SOLVER=hcaptcha
export LOG_LEVEL=debug
./flaresolverr

c. Configuração do Plex

export PROXY='{"url": "http://endereco-do-servidor-proxy:porta-do-proxy"}'
export LOG_LEVEL=info
./flaresolverr

d. Configuração do Prometheus

• Ativar Prometheus: PROMETHEUS_ENABLED=true
• Definir porta de escuta: PROMETHEUS_PORT=xxxx
• Configure o Prometheus para coletar dados dos endpoints do FlareSolverr.

e. Outros Aplicativos (Jackett, Prowlarr)

• Ative o FlareSolverr nas configurações do aplicativo.
• Defina a URL do host: http://flaresolverr:8191.
• Ajuste as variáveis do solucionador de CAPTCHA se necessário.

4. Usando o FlareSolverr

a. Usando curl no Linux

• Criar sessão:

curl -L -X POST 'http://localhost:8191/v1' -H 'Content-Type: application/json' --data-raw '{"cmd": "sessions.create"}'

• Listar sessões:

curl -L -X POST 'http://localhost:8191/v1' -H 'Content-Type: application/json' --data-raw '{"cmd": "sessions.list"}'

• Destruir sessão:

curl -L -X POST 'http://localhost:8191/v1' -H 'Content-Type: application/json' --data-raw '{"cmd": "sessions.destroy", "session": "id_da_sessao_aqui"}'

• Requisição GET:

curl -L -X POST 'http://localhost:8191/v1' -H 'Content-Type: application/json' --data-raw '{"cmd": "request.get", "url": "http://www.exemplo.com", "maxTimeout": 60000}'

b. Usando Python Requests

import requests

post_body = {
    "cmd": "request.get",
    "url": "https://www.rapidseedbox.com/",
    "maxTimeout": 60000
}

response = requests.post(
    'http://localhost:8191/v1',
    headers={'Content-Type': 'application/json'},
    json=post_body
)

print(response.json())

Isso retorna o conteúdo HTML e cookies do site alvo.

5. Conclusão

O FlareSolverr é uma ferramenta poderosa para contornar proteções do Cloudflare, permitindo uma raspagem web confiável, monitoramento e acesso a mídia. Ele se integra perfeitamente com ferramentas como Prometheus, Plex, Jackett e Prowlarr.

Se instalado no Linux, Docker ou Windows, o FlareSolverr pode ser configurado para atender a uma variedade de casos de uso. Combinado com curl ou Python Requests, oferece uma solução eficaz para acessar conteúdo web protegido.