NAS 与运维

FlareSolverr:浏览器挑战处理与服务连接

  • 1 次阅读
  • 0 条评论
文章摘要

FlareSolverr 为需要浏览器执行 JavaScript 的访问流程提供独立服务。调用方把目标网址交给它,服务启动浏览器完成页面加载,再把结果交还给支持该接口的应用。它不是通用网络代理,也不能保证所有验证页面都能自动通过。

项目介绍

FlareSolverr 为兼容应用提供浏览器挑战处理接口。应用把目标地址交给它,服务通过自动化浏览器加载页面,再返回结果。常见用法是配合索引器等应用处理需要执行 JavaScript 的页面;它不能保证通过所有验证码或防护规则。

version: "2.1"
services:
  flaresolverr:
    image: ghcr.io/flaresolverr/flaresolverr:latest
    container_name: flaresolverr
    environment:
      - LOG_LEVEL=info
      - LOG_HTML=false
      - CAPTCHA_SOLVER=none
      - TZ=Asia/Shanghai
    ports:
      - "8191:8191"
    volumes:
      - /volume1/docker/flaresolverr:/app/data
    restart: unless-stopped

Flaresolverr 是一个专门用于解决 Cloudflare 防护的代理服务器,它的主要作用是:

核心功能

绕过 Cloudflare 防护:帮助其他应用程序(如种子索引器、爬虫工具等)绕过 Cloudflare 的 DDoS 保护、5秒盾和验证码挑战。

工作原理

  1. 自动处理 JavaScript 挑战:Cloudflare 经常要求浏览器执行 JavaScript 来验证真实性

  2. 解决验证码:自动处理 CAPTCHA 验证(如果配置了相应的求解器)

  3. 通过自动化浏览器加载页面并执行 JavaScript;所用浏览器及驱动以安装版本为准。

主要用途

  • 种子搜索工具(如 Jackett、Prowlarr、NZBHydra2)访问受 Cloudflare 保护的跟踪网站

  • 网络爬虫访问受保护的网站

  • 自动化脚本需要访问有 Cloudflare 保护的 API

  • 数据采集时绕过反爬虫机制

典型应用场景

图表

代码

下载

种子搜索工具

遇到Cloudflare阻挡

请求发送到Flaresolverr

Flaresolverr解决挑战

获取真实内容

环境变量说明

  • LOG_LEVEL: 日志级别(info、debug等)

  • LOG_HTML: 是否记录HTML响应(调试用)

  • CAPTCHA_SOLVER: 验证码求解服务(如hcaptcha-solver)

  • TZ: 时区设置

重要性

对于需要访问受 Cloudflare 保护的网站的应用来说,Flaresolverr 是必不可少的中间件,它让这些应用能够正常工作和获取数据。

简单说:它是一个专门破解 Cloudflare 防护的"钥匙",让其他工具能够访问被保护网站。

补充:部署与使用

配置与操作示例

Compose 部署

在 /volume1/docker/flaresolverr/compose.yaml 保存:

群晖目录准备

在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/flaresolverr/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。

sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/flaresolverr
cd /volume1/docker/flaresolverr
HALO_PREPARE
cd /volume1/docker/flaresolverr
services:
  flaresolverr:
    image: ghcr.io/flaresolverr/flaresolverr:latest
    environment:
      LOG_LEVEL: info
      TZ: Asia/Shanghai
    ports:
      - "8191:8191"
    restart: unless-stopped

8191 是 API 端口,不是代理服务器端口。只允许需要调用的局域网应用访问。官方提示浏览器进程需要一定内存;遇到浏览器崩溃时检查资源和日志,而不是先放大超时。

一次 API 调用

从实际调用方所在环境请求自己有权访问的示例页面:

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

检查返回的 status、响应内容及请求耗时,再在目标应用填写相同服务入口。需要连续会话时,按 API 的 session 创建与销毁流程管理,避免遗留大量浏览器实例。

启动与状态检查

在保存 compose.yaml 和所需 .env 的项目目录执行:

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100

config 用于检查配置,不会启动服务。示例使用上游浮动发行通道;长期运行可改为项目实际发布的固定标签或已记录的镜像摘要,不猜写版本号。日志中出现的初始密码和访问凭据仅在自己的终端查看。

常见问题

  • 端口可达但任务失败:检查上游网络、浏览器启动与目标验证方式,不能只更换端口。
  • 使用该接口不会保证 CAPTCHA 或所有挑战均能通过,也不替代目标网站的账号授权。

更新与备份

保存 Compose、服务地址和调用应用配置;会话状态按当前项目文档处理。

更新前记录当前镜像或仓库提交,停止会写入的任务并备份持久化数据;阅读版本迁移说明后再拉取并重建。数据库已经迁移时,回退还需要匹配的数据副本。需要暂时停服务可用 docker compose stop,不要把删除卷或清空数据目录当作更新步骤。

官方资料