obscura 是什么?

Obscura 是 h4ckf0r0day 维护的 Rust 无头浏览器引擎。它内置 V8、渲染、CDP 与 MCP 接口,可直接抓取页面,也能让 Puppeteer 或 Playwright 通过 CDP 连接。

⭐ 18,879 Stars 🍴 1,338 Forks Rust Apache-2.0 作者: h4ckf0r0day
来源:github.com/h4ckf0r0day/obscura 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

项目在 2026-09-20 发布 v0.2.3,集中补上 CDP/MCP 鉴权、并发会话隔离、SSRF 防护和浏览器兼容性。

来源:github.com/h4ckf0r0day/obscura/releases/tag/v0.2.3

核心功能

独立浏览器引擎

用 Rust 组织运行时,以 V8 执行 JavaScript,并提供 CSS 布局、截图、PDF 与网络请求能力,不依赖本机 Chrome。

来源:github.com/h4ckf0r0day/obscura
CDP 与自动化客户端

实现一部分 Chrome DevTools Protocol,可由 Puppeteer Core、Playwright Core 或内置 CLI 连接。

来源:github.com/h4ckf0r0day/obscura
安全控制

v0.2.3 为非回环 CDP/MCP 监听强制要求至少 32 字节 bearer token,并限制请求大小与连接数。

来源:github.com/h4ckf0r0day/obscura/releases/tag/v0.2.3

技术架构

CLI 提供 fetch、scrape、serve 与 mcp 等入口;页面由 V8 isolate、DOM/渲染层和网络传输处理。serve 暴露 CDP 端点供 Puppeteer/Playwright 连接,scrape 可调用同目录的 obscura-worker 并行处理。它只实现列出的 CDP 和 Web Platform 子集,不能假定与完整 Chromium 完全一致。

来源:github.com/h4ckf0r0day/obscura;https://github.com/h4ckf0r0day/obscura…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) deno_core / V8 150.4deno_core / V8… rustls 可选 wreq/BoringSSL stealth transport可选 wreq/Bori… 独立浏览器引擎 CDP 与自动化客户端 安全控制 obscura 项目本体 核心功能 关键依赖

技术栈

语言Rust框架V8/deno_core、自研 DOM 与渲染层、CDP、MCP
deno_core / V8 150.4rustls可选 wreq/BoringSSL stealth transport
官方二进制支持 Linux x86_64/ARM64、macOS Apple Silicon/Intel 和 Windows;Linux 预编译包要求 glibc 2.35+;源码构建要求 Rust 1.75+
来源:github.com/h4ckf0r0day/obscura;https://github.com/h4ckf0r0day/obscura…

快速上手

从 v0.2.3 Release 下载与系统、CPU 和 render/stealth 组合匹配的压缩包,保留 obscura 与 obscura-worker 在同一目录,先执行 ./obscura --version,再仅对 example.com 等获授权目标运行 ./obscura fetch https://example.com --eval 'document.title'。Docker 端口应绑定 127.0.0.1,并设置随机 OBSCURA_CDP_TOKEN。
来源:github.com/h4ckf0r0day/obscura/wiki/Installation;https://github.com/h…

使用场景

适合在自有站点或明确授权环境做页面渲染测试、截图、PDF、结构化提取及 Agent 浏览器实验。stealth 和代理功能不能用来规避目标网站的访问控制、robots、服务条款或法律限制。

来源:github.com/h4ckf0r0day/obscura;https://github.com/h4ckf0r0day/obscura…

优势与局限

优势

  • 不需要安装 Chrome 或 Node.js 的预编译二进制
  • 同一引擎提供 CLI、CDP、Puppeteer/Playwright 和 MCP 接入
  • v0.2.3 加强控制端口鉴权、SSRF 与并发隔离

局限

  • 只实现一部分 CDP 与 Web Platform,复杂网站兼容性要逐站验证
  • Linux 预编译包需要 glibc 2.35+
  • 源码 stealth 构建还需 CMake、Clang 与 LLVM 开发库
  • anti-detect 与代理使用受目标站条款及法律约束
  • 官方性能数字来自项目自己的 benchmark,本轮未复测
来源:github.com/h4ckf0r0day/obscura;https://github.com/h4ckf0r0day/obscura…

最新版本

v0.2.3 是截至 2026-09-23 的最新 GitHub Release,源代码归档时间为 2026-09-20。该版更新 V8、强化 CDP/MCP 鉴权与资源限制,并改进并发会话、渲染和网页兼容性。

来源:github.com/h4ckf0r0day/obscura/releases/tag/v0.2.3;https://github.com…

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对 h4ckf0r0day/obscura 官方 README、Wiki Installation、Security 与 v0.2.3 Release  |  limitations: 未下载二进制、未运行 fetch、未启动 CDP/MCP、未连接 Puppeteer/Playwright,也未复测性能或 stealth 声明  |  observed_output: 官方 Release 标记 v0.2.3 为 Latest;Linux 包面向 Ubuntu 22.04/glibc 2.35+,源码构建要求 Rust 1.75+;非回环 CDP/MCP 监听要求至少 32 字节 token

来源:github.com/h4ckf0r0day/obscura;https://github.com/h4ckf0r0day/obscura…

同类项目对比

Chrome Headless 从 Chrome 112 起与有界面的 Chrome 共用同一套浏览器代码,兼容面更完整;Obscura 是独立 Rust/V8 引擎,通过部分 CDP 实现兼容,安装体积和资源目标更小。需要最高网页兼容性时选 Chrome Headless;能逐站验证且看重独立二进制与较小资源占用时再评估 Obscura。

来源:developer.chrome.com/docs/automation-and-testing/headless;https://git…

总结评价

Obscura 适合在获授权目标上试验轻量浏览器自动化。先用固定的一组页面验证登录、表单、截图与网络行为,再决定是否替换 Chrome;控制端口绑定本机并配置 token,stealth 或代理不能改变合规责任。

来源:github.com/h4ckf0r0day/obscura;https://github.com/h4ckf0r0day/obscura…

常见问题

Obscura v0.2.3 运行时必须安装 Chrome 或 Node.js 吗?

官方预编译二进制不需要 Chrome 或 Node.js。用 JavaScript 编写 Puppeteer/Playwright 客户端时,客户端仍需自己的 Node.js 环境。

Obscura 的 Linux 二进制为什么提示 GLIBC_2.35 not found?

官方 Linux 包面向 Ubuntu 22.04 并要求 glibc 2.35+。旧系统可考虑官方 Docker 镜像,或按文档从源码构建。

Obscura 的 CDP 端口可以直接暴露到公网吗?

不应直接暴露。官方 Docker 示例绑定回环地址;v0.2.3 对非回环监听强制要求至少 32 字节 token。

Obscura 能完全替代 Chrome Headless 吗?

不能预先保证。Obscura 实现的是 CDP 与 Web Platform 子集,复杂页面、扩展功能和边缘行为必须逐站验证。

透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-09-23 13:55. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件