Obscura

专为 AI Agent 和网页抓取设计的开源 Headless 浏览器。 轻量、隐蔽，且基于 Rust 构建。

---

Obscura 是一个用 Rust 编写的 Headless 浏览器引擎，专为网页抓取和 AI Agent 自动化而生。它通过 V8 执行真实的 JavaScript，支持 Chrome DevTools Protocol (CDP)，并且可以作为 Puppeteer 和 Playwright 中 Headless Chrome 的直接替代品。

为什么选择 Obscura 而不是 Headless Chrome？

专为自动化规模化场景设计，而非桌面浏览。

指标	Obscura	Headless Chrome
内存占用	30 MB	200+ MB
二进制大小	70 MB	300+ MB
反检测	内置	无
页面加载	85 ms	~500 ms
启动速度	即时	~2 秒
Puppeteer	支持	支持
Playwright	支持	支持

🎉 10,000 星标与后续计划

我正在开发 Obscura Cloud，这是托管版本，提供基础设施管理、住宅代理以及专属支持。专为那些希望使用该引擎但不想自行运维的用户准备。

开源引擎将保持 Apache-2.0 协议，功能完整。绝不会进行功能锁定。

加入等待列表 →

安装

下载

从 Releases 获取最新的二进制文件：

# Linux x86_64
curl -LO https://github.com/h4ckf0r0day/obscura/releases/latest/download/obscura-x86_64-linux.tar.gz
tar xzf obscura-x86_64-linux.tar.gz
./obscura fetch https://example.com --eval "document.title"

# Linux ARM64 (aarch64)
curl -LO https://github.com/h4ckf0r0day/obscura/releases/latest/download/obscura-aarch64-linux.tar.gz
tar xzf obscura-aarch64-linux.tar.gz

# Arch Linux (AUR)
yay -S obscura-browser

# macOS Apple Silicon
curl -LO https://github.com/h4ckf0r0day/obscura/releases/latest/download/obscura-aarch64-macos.tar.gz
tar xzf obscura-aarch64-macos.tar.gz

# macOS Intel
curl -LO https://github.com/h4ckf0r0day/obscura/releases/latest/download/obscura-x86_64-macos.tar.gz
tar xzf obscura-x86_64-macos.tar.gz

# Windows
从发布页面下载 `.zip` 文件并手动解压。

无需 Chrome，无需 Node.js，无需依赖项。发布存档中同时包含 obscura 和 obscura-worker；请将它们保持在同一目录下以支持并行 scrape 命令。

Linux 发行版构建目标为 Ubuntu 22.04，因此下载的二进制文件可在 glibc 2.35+ 的主流 LTS 服务器上直接使用。

Docker

docker run -d --name obscura -p 127.0.0.1:9222:9222 h4ckf0r0day/obscura

镜像位于 Docker Hub。采用 distroless/cc 的多阶段构建，无 shell，无包管理器，压缩后仅约 57 MB。

从源码构建

git clone https://github.com/h4ckf0r0day/obscura.git
cd obscura
cargo build --release

# 启用隐身模式（反检测 + 追踪器屏蔽）
cargo build --release --features stealth

需要 Rust 1.75+ (rustup.rs)。首次构建大约需要 5 分钟（V8 从源码编译，后续会缓存）。

快速入门

获取网页内容

# 获取页面标题
obscura fetch https://example.com --eval "document.title"

# 提取所有链接
obscura fetch https://example.com --dump links

# 渲染 JavaScript 并转储 HTML
obscura fetch https://news.ycombinator.com --dump html

# 将转储或 eval 输出写入文件
obscura fetch https://example.com --dump text --output page.txt

# 原样流式传输原始响应体（二进制安全；绕过 JS/DOM 层）。
# 适用于图像、JSON、JS、CSS 或任何非 HTML 资源。
obscura fetch https://picsum.photos/200/300 --dump original > photo.jpg

# 列出页面将获取的所有子资源 URL (NDJSON; 每个资源一条记录)
obscura fetch https://example.com --dump assets

# 通过 HTTP 或 SOCKS 代理获取
obscura --proxy socks5://127.0.0.1:1080 fetch https://example.com --dump text

# 等待动态内容加载
obscura fetch https://example.com --wait-until networkidle0

# 为缓慢或损坏的页面设置导航超时
obscura fetch https://example.com --timeout 10

启动 CDP 服务器

obscura serve --port 9222

# 启用隐身模式（反检测 + 追踪器屏蔽）
obscura serve --port 9222 --stealth

并行抓取

obscura scrape url1 url2 url3 ... \
  --concurrency 25 \
  --eval "document.querySelector('h1').textContent" \
  --format json

# 禁止在 stderr 输出抓取进度，以便脚本获取纯净输出
obscura scrape https://example.com --quiet --format json

# 抓取 worker 继承全局代理设置
obscura --proxy http://127.0.0.1:8080 scrape https://example.com https://news.ycombinator.com

Puppeteer / Playwright

Puppeteer

npm install puppeteer-core

import puppeteer from 'puppeteer-core';

const browser = await puppeteer.connect({
  browserWSEndpoint: 'ws://127.0.0.1:9222/devtools/browser',
});