项目介绍
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-stoppedFlaresolverr 是一个专门用于解决 Cloudflare 防护的代理服务器,它的主要作用是:
核心功能
绕过 Cloudflare 防护:帮助其他应用程序(如种子索引器、爬虫工具等)绕过 Cloudflare 的 DDoS 保护、5秒盾和验证码挑战。
工作原理
自动处理 JavaScript 挑战:Cloudflare 经常要求浏览器执行 JavaScript 来验证真实性
解决验证码:自动处理 CAPTCHA 验证(如果配置了相应的求解器)
- 通过自动化浏览器加载页面并执行 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,不要把删除卷或清空数据目录当作更新步骤。