obscura

让 AI 代理和爬虫像真人一样浏览网页,不被封禁。

开源 🏷️定价信息待确认 ✅ 目前可打开 自动化工作流 🍴 复刻 2315 🐛 待处理 220 👀 关注 80
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 30533
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

obscura 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队h4ckf0r0day
官网地址https://obscura.sh
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议Apache-2.0
主要语言Rust
技术栈/模型antidetect,antidetect-browser,browser,browser-automation,cdp,headless,playwright,puppeteer,rust
GitHub 星标★ 30533
上线时间2026-04-13 00:00:00
代码更新2026-11-08
仓库体积26.2 MB
本站数据更新2026-11-08
维护状态活跃
收录时间2026-08-10
浏览次数5

项目介绍

Obscura 是一个专为 AI 代理和网页抓取设计的无头浏览器,基于 Rust 编写,提供反检测能力和 CDP 协议支持。它解决了传统无头浏览器(如 Playwright、Puppeteer)容易被网站识别和屏蔽的问题,通过模拟真实浏览器指纹和规避检测机制,帮助用户稳定地抓取数据或运行自动化任务。核心能力包括:高性能的浏览器内核、灵活的自动化控制、以及针对反爬虫策略的对抗能力。项目在 GitHub 上已获得 2 万+ 星标,属于知名项目,适合需要大规模、低检测风险的网页数据采集场景。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 30533

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:Docker 4 步

环境要求

  • 已安装 Docker(能执行 docker 命令)
  • 本机 9222 端口未被占用
  • 能访问 Docker Hub 拉取 h4ckf0r0day/obscura 镜像
  • 如需持久化数据,需准备一个 uid 65532 可写的宿主目录

安装与启动步骤

  1. 1拉取镜像

    从 Docker Hub 拉取官方镜像。镜像基于 distroless 构建,体积约 57 MB(压缩后)。

    docker pull h4ckf0r0day/obscura
  2. 2启动容器

    后台启动容器并把 CDP 端口只发布到本机回环地址 127.0.0.1:9222,避免暴露到公网。

    docker run -d --name obscura -p 127.0.0.1:9222:9222 h4ckf0r0day/obscura
  3. 3确认容器运行

    查看容器是否处于运行状态;若状态异常,可用 docker logs obscura 查看输出排查。

    docker ps
  4. 4连接 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 建议发布到宿主回环地址以确保安全。

注意事项

  • README 明确建议使用 -p 127.0.0.1:9222:9222,避免把 CDP 端口暴露到所有接口
  • 镜像无 shell、无包管理器,以 uid 65532 运行,排障主要依赖 docker logs
  • 容器默认名称为 obscura,重复启动前需先删除或改名旧容器

核心亮点

  • 基于 Rust 实现,性能优于同类 Node/Python 方案,内存占用更低
  • 内置反检测指纹模拟,能有效绕过常见网站的反爬机制
  • 支持 CDP 协议,可无缝对接现有 Playwright/Puppeteer 自动化脚本

不足之处

  • 文档和社区生态相对年轻,中文资料较少
  • 高级反检测配置需要专业知识,上手门槛较高

适用场景

  • 大规模网页数据采集,避免 IP 和指纹被封
  • AI 代理需要模拟真实用户行为访问受限网站
  • 自动化测试中需要规避前端反自动化检测

替代项目

Playwright、Puppeteer、Camoufox

上一篇:browser

下一篇:maxun

同类项目推荐

mochi 开源

Bun 上的高保真隐身浏览器,稳定绕过指纹检测

The library for faithful browser automation. High-fidelity fingerprinting for Bun, e···

★ 220 2026-09-18
shell-rs 开源

图形化 SSH 工作台,连主机传文件开隧道一站搞定

High-performance native SSH client in Rust, GPU-rendered with GPUI: host manager, te···

★ 479 2026-10-18
ai-website-cloner-template 开源

输入网址,一条命令,AI 帮你克隆整个网站前端。

Clone any website with one command using AI coding agents

★ 38827 2026-08-09
multizen-browser 开源

给每个 AI 任务一个独立指纹浏览器,多账号互不串味

Browser for AI agents and human operators. Isolated local profiles with their own co···

★ 203 2026-09-15
gptfree-register 开源

跳过接码,自动注册 ChatGPT 账号并导入 sub2api

ChatGPT协议注册机,支持跳过接码并自动导入sub2api

★ 130 2026-08-09
roamgate 开源

手机随时连终端,盯 AI 代理干活、审代码 diff

A Herdr client for any screen. Control terminals, monitor coding agents, and review ···

★ 324 2026-10-18
ChatFred 开源

在 Alfred 里直接聊 AI、画图,不用切窗口

Alfred workflow using ChatGPT, DALL·E 2 and other models for chatting, image genera···

★ 371 2026-08-09
video-recap-skills 开源

丢进视频,自动生成中文解说剪辑,还能导出剪映

AI 视频解说全流程 skill 包:自动切镜头、看画面写解说词、配音合成成片,支持一键导出可···

★ 613 2026-08-09
OpenAdapt 开源

录一遍 GUI 操作,生成可靠本地自动化程序

For EHRs, payer portals, and any app your team clicks through. A person or an agent ···

★ 1867 2026-08-09