FlareSolverr：分步指南［2026］

从本质上讲，FlareSolverr 是绕过 Cloudflare 保护的代理服务器。 它是 Cloudflare 反僵尸措施与高效数据检索需求之间的桥梁。 通过利用 Python、Selenium 和 ChromeDriver 的强大功能，FlareSolverr 使您能够克服 Cloudflare 的挑战并无缝访问受保护的网站内容。

本指南全面介绍 FlareSolverr。我们将仔细研究其在 Linux、Docker 和 Windows 上的安装。我们还将介绍其配置，从如何设置变量到为 Plex、Prometheus 以及 Jackett 和 Prowlarr 等其他应用程序进行配置。 

免责声明： 免责声明：本材料仅供参考。它并不构成对任何活动（包括非法活动）、产品或服务的认可。在使用我们的服务或依赖此处的任何信息时，您全权负责遵守适用的法律，包括知识产权法。对于因以任何方式使用我们的服务或此处包含的信息而造成的损害，我们不承担任何责任，除非法律明确要求。

目录 

1. Flaresolverr 简介
   • 是什么？
   • 它是如何工作的？
   • 优缺点
2. 安装 Flaresolverr。
   • Linux（通过终端）
   • Docker
   • Windows
3. 配置 Flaresolverr
   • 更改环境变量
   • Cloudflare 配置
   • Plex 配置
   • 普罗米修斯配置
   • 为其他应用程序配置 FlareSolverr。 
4. 使用 Flaresolverr
   • 在 Linux 上使用 "curl "命令。
   • 与 Python Requests 库一起使用。 
5. 结论 

1.Flaresolverr 简介。

a.Flaresolverr 是什么，与 Cloudflare 有什么关系？

Cloudflare 提供的反僵尸保护工具主要用于维护网站安全（避免 DDoS 攻击）、性能和保护用户数据。

为了对付机器人和识别人类，CloudFlare（向浏览器）提出了涉及 JavaScript 代码和数学挑战的障碍。传统访问受 Cloudflare 保护的网站需要经历各种障碍，如指纹识别挑战、验证码和其他证明人机交互的测试。这些障碍基本上是为了阻止恶意僵尸行为而设置的。 

FlareSolverr 是一款开源代理服务器，用于应对（或绕过）Cloudflare 反僵尸措施带来的挑战。

注意： 并非所有机器人都是为恶意行为而构建的！机器人只是执行任务的自动化程序。当然，有些机器人是为垃圾邮件、黑客攻击和欺诈等邪恶目的而设计的，但也有一些机器人是为合法使用情况而设计的。例如搜索引擎爬虫、聊天机器人、社交媒体机器人、网络清除器、监控和警报机器人、虚拟助手等。 

b.FlareSolverr 如何工作？

FlareSolverr 作为代理服务器运行，旨在规避 Cloudflare 的反僵尸协议。 它模拟实际浏览器的行为，因此可以应对挑战、进行安全检查和呈现网页内容。 

请参考下图。

• 用户（即 Python HTTP 客户端）发起请求
• FlareSolverr 等待用户请求（空闲状态），然后使用 Python Selenium 和 未检测到的铬eDriver 创建网络浏览器（Chrome）实例。 
• 然后，它将请求转发到网站（受 CloudFlare 保护）。它等待挑战被解决。 
• 目标网站照常响应请求。Cloudflare 也会响应请求，因为其挑战已顺利解决。
• HTML 代码会被刮除，cookie 会被发回给用户。
• 由此产生的 HTML 代码和 Cookie 可供客户端与其他 HTTP 客户端（如 Python Requests）一起使用。

c.FlareSolverr 的常见用例

Flaresolverr 不断改进并增加集成。这些新的集成使 FlareSolverr 的功能超越了刮擦--可与搜索引擎优化工具、人工智能模型训练和自动搜索索引工作流程一起使用。

• 绕过 Cloudflare 保护以进行网络搜刮 (新闻、电子商务、价格监测）。进一步了解 网络搜刮.
• 访问 torrent 和 Usenet 索引器 经由 Jackett, Prowlarr, and Sonarr/Radarr
• 启用稳定的远程访问 Plex 媒体服务器 Cloudflare 背后
• 监控受保护的应用程序接口 使用 Prometheus + FlareSolverr 代理
• 为搜索引擎优化工具自动收集数据 搜索受 Google 或 Cloudflare-SERP 保护的网站
• 反馈 LLM 和人工智能模型 使用从受保护域搜刮的内容（用于培训或微调）
• 与无头浏览器框架集成 如 Playwright、Puppeteer 或 Browserless，用于隐蔽刮擦
• 绕过验证码墙 (成功率有限）或外部解码器，如 2Captcha 或 CapSolver

d.优缺点。

FlareSolverr 是绕过 Cloudflare 反僵尸机制的重要工具。想要访问受保护内容的用户将受益于 FlareSolverr。不过，使用时也要注意一些缺点和注意事项。

优势

• 自动旁路： FlareSolverr 的自动方法使您无需手动解决难题。
• 高效刮削： 您可以从 Cloudflare CDN 托管的网站上高效地抓取数据。
• 增强无障碍环境： 它能通过成功冒充真实网络浏览器，顺利访问受 Cloudflare 保护的内容。
• 无缝集成： FlareSolverr 使用 Python Selenium，和 未检测到的 ChromeDriver.这种集成可确保该解决方案轻松融入您现有的搜索工作流程。
• 多功能性： 您可以将从 FlareSolverr 解决方案中获取的 HTML 代码和 cookie 与其他 HTTP 客户端（如 Python Requests）一起使用。 

了解如何 使用 Python 和 Requests 库进行网络搜刮 并将 FlareSolverr 集成到您的项目中。 

缺点

• 法律和伦理问题： 最重要的用途是其法律和道德问题。绕过反僵尸保护机制可能会违反某些网站或服务的使用条款。 
• 网站稳定性： 使用 FlareSolverr 或类似工具绕过保护可能会给目标网站的服务器带来额外负担。
• 资源消耗： 绕过 Cloudflare 的挑战需要启动额外的浏览器实例和解决 JavaScript 难题。这两项任务都会消耗更多的计算资源。
• 依赖第三方服务： FlareSolverr 依赖于 Selenium、ChromeDriver 和其他第三方工具。因此，如果这些工具没有更新或失效，FlareSolverr 也会受到影响。 
• 验证码挑战： 虽然该工具可以处理许多反机器人机制，但在某些情况下可能会出现验证码。验证码的设计意图是让自动系统难以解决。

2.安装 Flaresolverr。

在本节中，我们将为您提供在不同操作系统上安装 FlareSolverr 的分步说明。我们将在 Linux 下安装 FlareSolverr（通过终端和 无头浏览器)、Docker，最后是 Windows。 

免责声明： 本指南中的信息仅供一般用途，不保证准确、完整或最新。对于因使用本信息而造成的任何损失或损害，我们概不负责。与外部网站的链接并不表示我们认可这些网站，我们也不对其内容负责。使用 FlareSolverr 可能涉及法律问题，请确保遵守相关法律和使用条款。本指南不能替代专业建议。使用本指南即表示您同意这些条款。

a.在 Linux 上安装 FlareSolverr（通过终端）

在 Linux 上的安装过程非常简单，本指南将指导您完成在系统上启动和运行 FlareSolverr 的步骤。我们将在 Ubuntu 22.04 上安装 FlareSolverr。

先决条件

在开始安装过程之前，请确保您拥有 Python 和 Python 包管理器 (pip)。您需要使用 pip 来安装和管理依赖项。根据 FlareSolverr 的 GitHub 代码库建议使用 Python 3.11

安装步骤：

按照以下步骤在 Linux 系统上安装 Flaresolverr（预编译二进制文件）：

• 在 Linux 机器上启动终端窗口。 
• 创建目录 保存 FlareSolverr 下载的位置。 

例如

• 下载二进制文件： 您可以使用 wget 命令直接从 Flaresolverr 的官方 URL 下载二进制文件。 最新发布 并复制链接）

• 提取存档： 使用 tar 命令解压缩下载的存档内容：

• 进入解压缩目录。

• 现在可以使用 ./flaresolverr 命令运行 FlareSolverr：

祝贺你 如果看到与上述类似的信息，则表示 FlareSolverr 已经启动并运行。输出结果表明网络浏览器安装测试成功，FlareSolverr 服务现已在 http://0.0.0.0:8191 上提供服务。

访问 FlareSolverr！

FlareSolverr 现在应在 Linux 机器后台运行。 地址 0.0.0.0 表示 Flaresolverr 绑定到主机上所有可用的网络接口。这意味着您可以从同一网络中的任何设备上使用机器的 IP 地址或主机名访问它。

故障排除 

快速故障排除表！

需要支持？ 大多数 FlareSolverr 问题（如浏览器错误或验证码）都会在 GitHub 问题页面在这里您可以找到修复程序，甚至添加自己的错误报告。

我们通过虚拟机（无图形用户界面）运行 FlareSolverr，因此出现了以下错误。

1. "如果您看到以下错误"加载共享库时出错：libatk-1.0.so.0：无法打开共享对象文件：No such file or directory" -- ERROR Chrome / Chromium version not detected!" 你需要为 Chrome 或 Chromium 浏览器安装必要的依赖项。 

发出以下命令

2. 如果您看到错误"OSError：Can not find Xvfb.请安装后重试。"这意味着 Flaresolverr 无法找到 Xvfb，而 Xvfb 是启动 FlareSolverr 功能的网络浏览器所必需的。Xvfb 是一种虚拟帧缓冲 X 服务器，允许应用程序在没有物理显示器的情况下运行图形界面。Xvfb 用于模拟无头浏览器的显示环境。即使在没有物理显示器的情况下，无头浏览器也需要它才能正常运行。

使用以下命令安装 Xvfb： 

此外，如果您使用的是 无头浏览器，稍后需要在 FlareSolverr 的环境变量中定义它。下一节将详细介绍。

b.在 Docker 上安装 Flaresolverr

以下是在 Docker 中安装 FlareSolverr 的分步指南。我们假设您的电脑上已经安装了 Docker。要获得最新功能，请务必从官方的 FlareSolverr GitHub 代码库定期推送新的更新和社区修复。您还可以通过 Docker 将 FlareSolverr 添加到您的工具集中，从而简化设置并改进更新管理。

快速入门！

我们将使用在 Ubuntu 22.04 Jammy 上运行的 24.0.5 版本来展示本分步指南。有关如何安装 Docker 的更多信息，请参阅以下官方文档 向导. 

• 查找相关图片 DockerHub. 该镜像支持不同的架构，包括 x86： linux/386, x86-64: linux/amd64ARM32： linux/arm/v7和 ARM64： linux/arm64.
• 启动 FlareSolverr 容器。 使用 Docker Compose 或 CLI。FlareSolverr 提供了一个 docker-compose.yml 配置文件，这比 CLI 要简单得多（如果你已经安装了 Docker Compose）。此外，无需调用映像，因为这已经在 Compose 文件中引用过了。
  • 克隆包含 docker-compose.yml 配置文件：

• 导航至版本库目录：

• 使用 Docker Compose 启动容器（确保有管理员权限运行此命令或使用 sudo）：

验证安装.

执行以下命令，检查 FlareSolverr 容器是否正在运行：

• 您应该看到 耀斑分解器 列表中的容器。

访问 FlareSolverr

FlareSolverr 现在应该正在 Docker 容器中运行。您可以在网页浏览器中访问 "http://localhost:8191"。

就是这样！您已经使用 Docker 容器成功安装了 FlareSolverr。现在，您可以使用它绕过受 Cloudflare 保护的网站的挑战。

c.在 Windows 上安装 FlareSolverr

建议使用预编译二进制文件在 Windows 上安装 FlareSolverr，该二进制文件仅适用于 Windows x64 架构。 虽然也可以从源代码安装，但由于架构的限制，不建议在 Windows 上安装。此外，Docker 容器 "镜像 "主要设计用于在基于 Linux 的主机（而非 Windows）上运行。

在 Windows 上安装 FlareSolverr 的步骤如下：

• 下载二进制文件： 前往 FlareSolverr 发布 页面。在 "Assets（资产）"部分找到最新版本，并找到适用于 Windows 的相应下载。它应该是一个压缩文件。下载适用于 Windows x64 的 FlareSolverr 压缩文件。
• 解压缩并执行 FlareSolverr 二进制文件： 运行下载的 FlareSolverr.exe 可执行文件。运行后，终端将打开，让你知道 FlareSolverr 用户代理已成功运行。
• 允许从 Windows 防火墙访问此应用程序。 

就是这样！您已经使用预编译二进制文件在 Windows 上成功安装并执行了 FlareSolverr。

3.配置 Flaresolverr。

现在您已经成功完成了安装，是时候进行配置了。

为 Cloudflare 和 Plex 等网络应用程序和服务配置 FlareSolverr 需要配置必要的环境变量。因此，如果成功安装了该软件，现在就可以修改其环境变量了。 

FlareSolverr 提供了环境变量，可以用来配置其行为。有关这些变量的信息，请参阅 FlareSolverr 的 GitHub 代码库.

a.更改环境变量。

在 Linux 中设置变量 

在 Linux 中，使用 "export "命令设置 FlareSolverr 的环境变量，然后在终端启动 FlareSolverr 进程。 方法如下

• 导出要更改的环境变量。
• 例如，要将 LOG_LEVEL 更改为调试，并更改时区，可以运行 

在 Docker 中更改变量

要修改 FlareSolverr 变量，需要用文本编辑器打开并修改 docker-compose.yml 文件。

• 找到与 FlareSolverr 服务相对应的服务部分--在我们的例子中，它被命名为 flaresolverr。在服务定义中，你会看到环境部分。在这里，你可以更新环境变量。 
• 例如，可以将 LOG_LEVEL 环境变量更改为调试、时区、默认端口、在无头模式下运行网络浏览器等。

以下是为上述各种情况配置 FlareSolverr 的步骤：

在 Windows 中配置变量 

在 Windows 中更改变量： 首先，转到 FlareSolverr 的安装目录，然后运行 "set"（设置）命令，后面跟上要修改的变量。 

现在，您已经知道如何设置 FlareSolverr 的变量，让我们来看看如何为特定的网络应用程序更改这些变量。 

b.为 Cloudflare 配置 FlareSolverr： 

您可以通过调整环境变量来配置 FlareSolverr 如何绕过 Cloudflare 挑战。 关键变量是 CAPTCHA_SOLVER 和 LOG_LEVEL。

• 以下更改将把验证码解算器设置为 "hcaptcha"，并把日志记录级别提高到调试。

• 启动 FlareSolverr：

• FlareSolverr 现在应配置为有效处理 Cloudflare 挑战。

🔔注意： As of today, native captcha solvers still do not work out-of-the-box. However, third-party solvers like CapSolver 和 2Captcha 可手动或通过中间件集成。

c.为 Plex 配置 FlareSolverr：

在以下情况下可能需要为 Plex 配置 FlareSolverr Plex媒体服务器 的保护。 您可能已经知道，Cloudflare 的安全措施可能会给访问 Plex 内容带来挑战。 

通过将 FlareSolverr 与 Plex 集成，您可以提高 Plex 媒体服务器的可靠性。这种设置可确保授权用户轻松访问媒体内容，而不会遇到障碍。

如何做到这一点？

• 设置环境变量 对于 Plex，您通常需要设置 PROXY 环境变量。该代理变量将通过代理服务器路由 Plex 的流量。此外，确保调整其他相关环境变量，如 LOG_LEVEL（如需要）。

• 将 "http://proxy-server-address:proxy-port "替换为代理服务器的实际地址和端口。
• 启动 FlareSolverr：

• 这将配置 FlareSolverr 作为 Plex 流量的代理。

d.为 Prometheus 配置 FlareSolverr。 

如果您正在使用 普罗米修斯 (开源监控工具）来跟踪受 Cloudflare 保护的网络服务或 API。如果您使用 Prometheus，由于 Cloudflare 的保护机制，您在访问端点时很可能会遇到困难。 将 FlareSolverr 与 Prometheus 集成时，可以配置 Prometheus 通过 FlareSolverr 代理发出请求。 

要将 Prometheus 与 FlareSolverr 集成，请按照以下步骤操作：

• 启用 Prometheus 输出程序：
  • 在 FlareSolverr 中将环境变量 PROMETHEUS_ENABLED 设为 true。
  • 如果使用 Docker，请在 Docker 配置中公开 Prometheus 输出端口 (PROMETHEUS_PORT)。
• 配置 Prometheus 输出端口：
  • 设置环境变量 PROMETHEUS_PORT，指定出口程序的监听端口。
• 使用配置的环境变量运行 FlareSolverr。如果使用 Docker，请确保已暴露 Prometheus 输出端口。
• 打开 Prometheus 配置文件 (prometheus.yml)，添加 scrape_config 部分，指定从 FlareSolverr 抓取指标。有关如何配置 Prometheus 的更多信息、 查看官方指南. 

e.为其他应用程序配置 FlareSolverr： 

包括 Prowlarr 和 Jackett 在内的两个出色的索引管理器/代理似乎受到了 CloudFlare 挑战的影响。由于一些 torrent 和 Usenet 索引员 使用 Cloudflare 保护以避免成为 DDoS 攻击的目标，但这些工具无法以编程方式访问某些网站。 

Jackett 和 Prowlarr 现在都提供对 FlareSolverr 的内置支持，将其作为索引器旁路选项。 请务必查看其配置页面，以便在搜索工作流中启用 FlareSolverr。

在 FlareSolverr 中，设置为相应的 CAPTCHA_SOLVER 环境变量（如果可用）。您可能还需要在目标应用程序中添加 FlareSolverr 的 IP 或主机名。以下是几个示例： 

• 杰克特 使 Jackett 能够成功地与洪流跟踪器通信，并 Usenet 索引器时，请确保以下几点：
  • 确保 Jackett 启动并运行。配置 FlareSolverr URL（例如 flaresolverr:8191）并应用更改。如果要长期使用此配置，请禁用更新。 
  • 查看 杰克特完整指南 了解如何安装、配置和使用 Jackett。 

• Prowlarr. 为了让 Prowlarr 能够成功地与 torrent 和 Usenet 网站对话，它需要克服验证码难题。
  • 进入 Prowlarr 的设置。导航至 "添加索引器代理 "并选择 FlareSolverr。
  • 输入主机。应类似于 http://flaresolverr:8191。检查我们的 Prowlarr 指南 了解如何使用和配置该工具。 

In addition, PVR automation tools like Sonarr, Radarr, or 巴扎尔 访问其中一些网站的媒体和字幕信息，也会受到间接影响。它们使用 Jackett 和 Prowlarr 来访问网站信息，但很快就会受到 Cloudflare 算法的质疑和阻止。 

4.使用 FlareSolverr。

您可以使用 Linux 中的 "curl "命令或 Python Requests 来使用 FlareSolverr。 

a.在 Linux 上使用 FlareSolverr 和 "curl "命令。

使用Linux上的 "curl "命令，你可以与FlareSolverr的API交互，执行各种操作。curl 命令有助于从命令行发出 HTTP 请求。它适用于快速和简单的请求，因此如果你要测试 FlareSolverr 的 API 端点，它是你的最佳选择。但要知道，在处理更复杂的交互（如数据处理和自动化）时，"curl "会变得更加复杂。

i.创建新会话

启动新的浏览器实例并创建会话：

ii.列出活动会话

要获取所有活动会话的列表，请执行以下命令：

iii.销毁会话

要销毁现有会话，请执行以下命令。

iv.提出 GET 请求

使用特定会话进行 GET 请求。

使用 curl 命令处理 GET 请求的示例：

b.使用 FlareSolverr 和 Python Requests 库。 

Python 提供了许多广泛的库和工具，用于处理网络 API（这对 FlareSolverr 来说再好不过了）。 使用 Python，您可以创建与 FlareSolverr 交互的更复杂的脚本。 这种方法非常适合自动化和创建自定义脚本。当然，要使用 Python，你需要开发一个脚本，这可能比使用 "curl "命令更耗时，也更具挑战性。

要使用 Python，您需要具备以下条件： 

• 确保系统已安装 Python。
• 安装请求库：使用该库进行 HTTP 请求。 
• 执行脚本前，确保 FlareSolverr 已启动并运行。
• 确保 FlareSolverr 配置正确，并正在监听预期端口（如 8191）。 
• 您的系统应具备网络连接能力，以便访问 http://localhost:8191 地址。

下面是一个使用请求库的 Python 脚本示例。 

注意： 我们使用自己的 URL（rapidseedbox.com）进行测试。但您只需将 与自己的目标网站进行比较。

• 您可以复制上述脚本并将其保存为 .py。然后在 Python 环境中运行。

• 结果应返回带有 cookie（会话）的 HTML 代码。
• 在 IDLE Shell 上运行的脚本模块中（如下图所示），您会在第一行看到这个特定网站没有发出 Cloudflare 挑战。
• 您可以在 Cloudflare 后台的网站上试用该脚本，因为这些网站会带来挑战。 

5.结论。

FlareSolverr 是增强网络搜刮和数据检索能力的重要工具。如果您使用 Prometheus 监控受 Cloudflare 保护的网络服务或 API，它也是一个重要工具。此外，FlareSolverr 还可与 Jackett 和 Prowlarr 等工具配合使用，帮助与 torrent 和 Usenet 网站（在 Cloudflare 的 CDN 后面）建立通信。

在本 FlareSolverr 指南中，我们介绍了如何在 Linux、Docker 或 Windows 上安装 FlareSolverr。我们学习了如何为 Prometheus、Plex 和其他应用程序等不同服务配置 FlareSolverr。此外，我们还简要学习了如何使用 curl 命令和 Python Requests 库。 

希望本指南对您有所帮助。如果您对 FlareSolverr 有任何问题和建议，请随时在下面的评论区留言。