让 AI 代理和爬虫像真人一样浏览网页，不被封禁。
Obscura 是一个专为 AI 代理和网页抓取设计的无头浏览器，基于 Rust 编写，提供反检测能力和 CDP 协议支持。它解决了传统无头浏览器（如 Playwright、Puppeteer）容易被网站识别和屏蔽的问题，通过模拟真实浏览器指纹和规避检测机制，帮助用户稳定地抓取数据或运行自动化任务。核心能力包括：高性能的浏览器内核、灵活的自动化控制、以及针对反爬虫策略的对抗能力。项目在 GitHub 上已获得 2 万+ 星标，属于知名项目，适合需要大规模、低检测风险的网页数据采集场景。
1拉取镜像
从 Docker Hub 拉取官方镜像。镜像基于 distroless 构建，体积约 57 MB（压缩后）。
docker pull h4ckf0r0day/obscura2启动容器
后台启动容器并把 CDP 端口只发布到本机回环地址 127.0.0.1:9222，避免暴露到公网。
docker run -d --name obscura -p 127.0.0.1:9222:9222 h4ckf0r0day/obscura3确认容器运行
查看容器是否处于运行状态；若状态异常，可用 docker logs obscura 查看输出排查。
docker ps4连接 CDP 端口
用支持 CDP 协议的客户端（Playwright/Puppeteer 等）连接本机 9222 端口，即可驱动无头浏览器。
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
-p 127.0.0.1:9222:9222 | 是 | 把容器 9222 端口只映射到主机回环地址，供本地 CDP 连接 | -p 127.0.0.1:9222:9222 |
--storage-dir | 否 | 挂载的存储目录，必须对 uid 65532 可写，否则容器无法写入 | --storage-dir /your/path |
执行 docker ps 能看到名为 obscura 的容器处于 Up 状态，且本机可通过 127.0.0.1:9222 建立 CDP 连接。
Q：为什么容器里没有 shell，无法 docker exec 进去？
A：镜像基于 distroless/cc:nonroot 多阶段构建，不含 shell 和包管理器，并以 uid 65532 非 root 运行，属于正常设计。
Q：挂载的存储目录报权限错误怎么办？
A：把宿主目录的所有者或权限调整为 uid 65532 可写，再做挂载。
Q：能不能用 -p 9222:9222 启动？
A：可以，但这会把端口暴露到所有网络接口。README 建议发布到宿主回环地址以确保安全。
Playwright、Puppeteer、Camoufox
obscura 是自动化工作流领域的开源项目，由 h4ckf0r0day 开发，是 2026 年新上线的项目。
在全站 13,090 个收录项目中，它的 GitHub 星标数（27,729）位列前 2%，在自动化工作流分类的 509 个项目里位列前 5%。
近 41 天，它的 GitHub 星标从 21,298 增加到 27,729，净增 6,431。
项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。
它主要面向的使用场景是：大规模网页数据采集，避免IP和指纹被封。同类可对比的替代方案包括 Playwright、Puppeteer、Camoufox。
n8n
开源
拖拽搭建自动化流程，轻松接入 AI 与 400+ 应用，搞定重复工作。
Fair-code workflow automation platform with native AI capabilities. Combine visual b···
feishu-docx
开源
让 AI 代理轻松读写飞书文档，双向转换 Markdown
Feishu/Lark Docs、Sheet、Bitable <-> Markdown | AI Agent-friendly knowledge base exp···
robotcode
开源
让 Robot Framework 拥有现代 IDE 体验，调试、补全、运行一气呵成。
Open Source Toolkit for Robot Framework, providing Language Server Protocol support,···
puppeteer
开源
用 JavaScript 轻松操控无头浏览器，搞定自动化测试与网页抓取。
JavaScript API for Chrome and Firefox