项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 30533
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已安装 Docker(能执行 docker 命令)
- 本机 9222 端口未被占用
- 能访问 Docker Hub 拉取 h4ckf0r0day/obscura 镜像
- 如需持久化数据,需准备一个 uid 65532 可写的宿主目录
安装与启动步骤
-
1拉取镜像
从 Docker Hub 拉取官方镜像。镜像基于 distroless 构建,体积约 57 MB(压缩后)。
docker pull h4ckf0r0day/obscura -
2启动容器
后台启动容器并把 CDP 端口只发布到本机回环地址 127.0.0.1:9222,避免暴露到公网。
docker run -d --name obscura -p 127.0.0.1:9222:9222 h4ckf0r0day/obscura -
3确认容器运行
查看容器是否处于运行状态;若状态异常,可用 docker logs obscura 查看输出排查。
docker ps -
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
同类项目推荐
mochi
开源
Bun 上的高保真隐身浏览器,稳定绕过指纹检测
The library for faithful browser automation. High-fidelity fingerprinting for Bun, e···
shell-rs
开源
图形化 SSH 工作台,连主机传文件开隧道一站搞定
High-performance native SSH client in Rust, GPU-rendered with GPUI: host manager, te···
ai-website-cloner-template
开源
输入网址,一条命令,AI 帮你克隆整个网站前端。
Clone any website with one command using AI coding agents
multizen-browser
开源
给每个 AI 任务一个独立指纹浏览器,多账号互不串味
Browser for AI agents and human operators. Isolated local profiles with their own co···
gptfree-register
开源
跳过接码,自动注册 ChatGPT 账号并导入 sub2api
ChatGPT协议注册机,支持跳过接码并自动导入sub2api
roamgate
开源
手机随时连终端,盯 AI 代理干活、审代码 diff
A Herdr client for any screen. Control terminals, monitor coding agents, and review ···
ChatFred
开源
在 Alfred 里直接聊 AI、画图,不用切窗口
Alfred workflow using ChatGPT, DALL·E 2 and other models for chatting, image genera···
video-recap-skills
开源
丢进视频,自动生成中文解说剪辑,还能导出剪映
AI 视频解说全流程 skill 包:自动切镜头、看画面写解说词、配音合成成片,支持一键导出可···
OpenAdapt
开源
录一遍 GUI 操作,生成可靠本地自动化程序
For EHRs, payer portals, and any app your team clicks through. A person or an agent ···
