HeadlessX

让浏览器自动化隐形，反检测抓取不再愁

HeadlessX 是一个基于 Camoufox（Firefox 内核）的自托管浏览器自动化平台，主打“零检测率”和隐私保护。它解决了传统无头浏览器（如 Puppeteer、Playwright）容易被网站反爬机制识别的问题，通过定制 Firefox 并集成反指纹技术，使自动化操作难以被察觉。核心能力包括：提供自动化 API 和平台服务，支持浏览器测试、网页数据抓取、多账号管理等场景；强调速度、隐私和可扩展性，用户可自托管部署，完全掌控数据和运行环境。项目用 TypeScript 编写，适合需要高匿名性和稳定性的自动化任务。

开源 unknown 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2317

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类自动化工作流

开发团队saifyxpro

所属国家

官网地址https://headlessx.saify.me

GitHubhttps://github.com/saifyxpro/HeadlessX

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议NOASSERTION

主要语言TypeScript

技术栈/模型automation,automation-api,automation-platform,browser-automation,browser-testing,browserless,chrome-headless,chromedriver,container-automation,data-extraction,headless,headless-chrome,headless-service,playwright,playwright-automation,puppeteer,scraping-service,web-automation,web-scraping

GitHub 星标★ 2317

30天Star增速

HF 下载量

上线时间2025-09-12 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-10

浏览次数5

使用教程

难度：进阶约 25 分钟部署方式：Docker 7 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Node.js 22+ 与 pnpm 10.32.1+（开发者模式，应用跑在宿主机上）
Git
Docker 与 Docker Compose v2（开发者模式与生产模式均必需）
Python/uv（用于 yt-engine）
Go（用于 HTML 转 Markdown sidecar，v2.1.2）

安装与启动步骤

1检查运行依赖

确认本机已装 Node.js 22+、Git、Docker + Compose v2，以及 yt-engine 需要的 Python/uv 和 sidecar 需要的 Go。PostgreSQL 和 Redis 无需单独安装。
2启用 corepack

若本机未使用 README 指定的 pnpm 版本，先启用 corepack 以便由 corepack 管理 pnpm。
```
corepack enable
```
3锁定 pnpm 版本

把 pnpm 对齐到 README 指定的 10.32.1，避免版本不一致导致依赖安装失败。
```
corepack use pnpm@10.32.1
```
4用 Docker 启动平台

README 明确开发和生产的运行都依赖 Docker + Compose v2，但未给出具体启动命令，请按官方 Setup Guide 的说明完成拉取与启动。
5首次构建 Google Cookie

打开 /playground/operators/google/ai-search，点击 Build Cookies，让共享浏览器打开 Google。
6人工过一次验证

在打开的共享浏览器里正常浏览，遇到 Google 或 reCAPTCHA 验证时手动完成一次；之后再次搜索会复用该共享 profile。
7保存浏览器配置

点击 Stop Browser 保存 profile，后续 Google 搜索会自动复用已保存的共享配置。

如何确认成功

Docker 容器正常运行、能打开 Dashboard，并成功访问 /playground/operators/google/ai-search 完成一次 Build Cookies 与 Stop Browser。

常见问题

Q：本机 pnpm 版本不符合要求怎么办？

A：执行 corepack enable 后再执行 corepack use pnpm@10.32.1，把 pnpm 对齐到 README 指定的版本。

Q：需要单独安装 PostgreSQL 和 Redis 吗？

A：不需要。README 说明这两种模式下的 PostgreSQL 和 Redis 都由 Docker 提供，不是单独安装项。

Q：Google AI 搜索一直弹验证怎么处理？

A：首次 Build Cookies 时正常浏览并手动完成 Google 或 reCAPTCHA 验证一次，之后保存的共享 profile 会被复用。

Q：浏览器 profile 保存在哪里？

A：Docker 和 VPS 安装保存在 browser_profile 卷中；本地仓库运行则保存在 apps/api/data/browser-profile/default 下。

注意事项

Docker + Compose v2 是开发者和生产模式的必需依赖，不能省略。
当前可运行版本是 v2.1.2，README 中的 v2.5 内容属于开发计划，不要按 v2.5 的方案部署。
PostgreSQL 与 Redis 由 Docker 提供，无需另行安装。
README 未给出完整的仓库拉取与启动命令，完整安装步骤请参考官方 Setup Guide。

核心亮点

基于 Camoufox 定制 Firefox，反检测能力突出，宣称 0% 检测率
自托管部署，数据隐私可控，不依赖第三方云服务
提供自动化 API 和平台，集成度高，适合构建复杂工作流

不足之处

项目较新，文档和社区生态待观察
基于 Firefox 内核，与 Chrome 生态的兼容性可能有限

适用场景

网页数据采集，规避反爬机制
自动化测试，模拟真实用户行为
多账号管理，社交媒体自动化运营

替代项目

Puppeteer Extra、Playwright、Camoufox

项目介绍

HeadlessX 是自动化工作流领域的开源项目，由 saifyxpro 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（2,317）位列前 30%，在自动化工作流分类中处于中上游。

近 45 天，它的 GitHub 星标从 2,175 增加到 2,317，净增 142。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：网页数据采集，规避反爬机制。同类可对比的替代方案包括 Puppeteer Extra、Playwright、Camoufox。

上一篇：playwright-go

下一篇：RPA