Obscura无头浏览器生产环境部署Docker容器与systemd服务的高可用配置清单【免费下载链接】obscuraThe headless browser for AI agents and web scraping项目地址: https://gitcode.com/gh_mirrors/ob/obscuraObscura 是一款用 Rust 编写的开源无头浏览器Headless Browser专为 AI Agent 和**网页抓取Web Scraping**设计它内嵌 V8 引擎、原生实现 Chrome DevTools ProtocolCDP可直接替代无头 Chrome 接入 Puppeteer 和 Playwright。本文是一份面向生产环境的部署配置清单涵盖Docker 容器化启动与systemd 服务高可用配置两大主流方案帮助你把这台内存占用仅 30 MB 的轻量浏览器引擎稳定地跑在服务器上。为什么 Obscura 适合跑在生产环境先看一下它和无头 Chrome 的核心差异这直接决定了资源规划方式指标Obscura无头 Chrome内存占用30 MB200 MB二进制体积70 MB300 MB反检测能力内置无页面加载85 ms~500 ms启动时间即时~2 秒Puppeteer / Playwright均兼容均兼容关键结论Obscura 是单一 Rust 二进制无需 Chrome、Node.js 或任何运行时依赖serve命令即可对外提供 CDP WebSocket 服务默认端口 9222。这意味着部署它本质上就是跑一个进程天然适配容器与服务管理器两种形态。Docker 容器快速部署一条命令拉起服务官方镜像基于多阶段构建运行层采用distroless/cc——无 shell、无包管理器攻击面极小压缩后仅约 57 MB。构建细节可参阅项目根目录的 Dockerfile。生产推荐启动方式相比最简命令多了三个关键点重启策略、端口绑定回环地址、数据卷持久化docker run -d \ --name obscura \ --restart unless-stopped \ -p 127.0.0.1:9222:9222 \ -v /srv/obscura/data:/data \ h4ckf0r0day/obscura \ serve --host 0.0.0.0 --storage-dir /data --stealth逐项说明--restart unless-stopped容器崩溃或宿主重启后自动拉起这是容器版高可用的底线。-p 127.0.0.1:9222:9222CDP 端口只映射到本机回环。Obscura 的 CDP 服务没有内置认证能连到端口就能驱动浏览器因此切勿直接暴露公网。-v /srv/obscura/data:/data挂载卷持久化 Cookie 与存储数据容器重建不丢状态。--stealth开启反指纹检测 追踪器拦截拦截 3500 追踪域名生产环境抓取建议开启。镜像默认入口即obscura serve --port 9222 --host 0.0.0.0在镜像名后追加参数即可覆盖任何子命令例如需要跨容器访问 MCP 时可切换为mcp --http。systemd 服务部署裸机高可用配置如果你偏好裸机或虚机部署systemd 方案可以让进程随系统自启、崩溃秒级自愈。创建/etc/systemd/system/obscura.service[Unit] DescriptionObscura headless browser Afternetwork.target [Service] ExecStart/usr/local/bin/obscura serve --port 9222 --stealth --storage-dir /var/lib/obscura Restartalways RestartSec5 Userobscura Groupobscura LimitNOFILE65536 MemoryMax4G MemoryHigh3G [Install] WantedBymulti-user.target然后启用并跟踪日志systemctl enable --now obscura journalctl -fu obscura这份清单里最值得理解的四行配置作用RestartalwaysRestartSec5任何原因退出都自动重启间隔 5 秒崩溃自愈Userobscura低权限专用账户运行避免以 root 执行浏览器进程LimitNOFILE65536提升文件描述符上限高并发抓取/多页面场景必备MemoryMax4G/MemoryHigh3G内存硬上限与软水位防止单进程拖垮整台主机 注意--storage-dir /var/lib/obscura指定了存储目录建议提前创建并授权给obscura用户用于持久化 Cookie。高可用配置要点清单对照打勾部署完成后按下表逐项核对#检查项配置方式说明1进程自动重启Restartalways/--restart unless-stopped两种方案的共同底线2端口不暴露公网绑定127.0.0.1:9222CDP 无认证公网裸奔等于交出浏览器控制权3远程访问走 TLS 认证Nginx/Caddy 反向代理见下一节4并发能力匹配 CPUserve --workers N每核一个 worker各维护独立页面池会话粘性绑定5V8 堆按需调整--v8-flags --max-old-space-size2048默认 4 GB 上限内存紧张的主机调低重型 SPA 调高6全链路超时收紧OBSCURA_*系列环境变量防止单页挂起拖垮 worker7日志可观测--verbose或RUST_LOGobscuradebug日志输出到 stderr天然接入 journal/docker logs完整生产文档见 docs/Run-in-production-at-scale.md。并发 worker一核一个obscura serve --workers 4 --port 9222--workers在监听器后面挂 N 个 CDP worker 进程各自处理独立的页面池。建议worker 数 CPU 核心数抓取吞吐随 worker 线性扩展。反向代理暴露 CDP 端口TLS 与认证怎么做需要跨机器如 Puppeteer 应用服务器访问时推荐经 Nginx 加 TLS 和认证location /obscura/ { proxy_pass http://127.0.0.1:9222/; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; proxy_read_timeout 86400; }⚠️ 两个 CDP 特有的坑缺了必失败Upgrade/Connection头CDP 基于 WebSocket不转发升级握手就连不上。proxy_read_timeout 86400长任务页面会长时间无数据流动默认 60 秒超时会把连接掐断。另外Obscura 默认拒绝访问私有/内网 IPSSRF 防护含 DNS 解析时校验。若需指向本地开发服务显式加--allow-private-network或设置OBSCURA_ALLOW_PRIVATE_NETWORK1。超时调优让单页故障拖垮不了整个服务引擎内置了多层熔断V8 看门狗会终止失控脚本、CDP 单条命令超预算即终止、导航与 fetch/XHR 均有超时上限。生产环境可按站点复杂度显式收紧全部环境变量说明见 docs/Environment-variables.md环境变量默认值作用OBSCURA_NAV_TIMEOUT_MS30000单次导航硬上限OBSCURA_SCRIPT_DEADLINE_MS30000页面脚本执行总预算OBSCURA_MODULE_BUDGET_MS3000单个增强模块如 Vite HMR预算OBSCURA_CDP_COMMAND_TIMEOUT_MS60000单条 CDP 命令上限需保持在导航上限之上OBSCURA_FETCH_TIMEOUT_MS30000页面内 fetch/XHR/模块加载超时重型 SPA 示例OBSCURA_NAV_TIMEOUT_MS60000 \ OBSCURA_SCRIPT_DEADLINE_MS45000 \ OBSCURA_CDP_COMMAND_TIMEOUT_MS70000 \ obscura serve --port 9222部署后验证三步确认服务健康进程存活systemctl status obscura或docker ps确认处于 running/restarted 正常状态。CDP 端点连通从本机curl -s http://127.0.0.1:9222应返回 WebSocket 调试端点信息。真实页面验证跑一次端到端抓取——obscura fetch https://example.com --eval document.title能返回页面标题说明 V8、网络、DOM 全链路就绪再看一眼journalctl -fu obscura或docker logs -f obscura确认无异常日志部署即告完成。小结Obscura 的部署哲学非常简单一个二进制一个端口一层自愈。Docker 方案胜在隔离干净、镜像极小systemd 方案胜在裸机零额外依赖两者都只需要把自动重启 端口保密 超时收紧三件事做扎实就能获得生产级的高可用。配合--stealth反检测与按核分配的 worker这套 30 MB 内存的无头浏览器足以支撑大规模、长跑的 AI Agent 抓取任务。【免费下载链接】obscuraThe headless browser for AI agents and web scraping项目地址: https://gitcode.com/gh_mirrors/ob/obscura创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Obscura无头浏览器生产环境部署：Docker容器与systemd服务的高可用配置清单
Obscura无头浏览器生产环境部署Docker容器与systemd服务的高可用配置清单【免费下载链接】obscuraThe headless browser for AI agents and web scraping项目地址: https://gitcode.com/gh_mirrors/ob/obscuraObscura 是一款用 Rust 编写的开源无头浏览器Headless Browser专为 AI Agent 和**网页抓取Web Scraping**设计它内嵌 V8 引擎、原生实现 Chrome DevTools ProtocolCDP可直接替代无头 Chrome 接入 Puppeteer 和 Playwright。本文是一份面向生产环境的部署配置清单涵盖Docker 容器化启动与systemd 服务高可用配置两大主流方案帮助你把这台内存占用仅 30 MB 的轻量浏览器引擎稳定地跑在服务器上。为什么 Obscura 适合跑在生产环境先看一下它和无头 Chrome 的核心差异这直接决定了资源规划方式指标Obscura无头 Chrome内存占用30 MB200 MB二进制体积70 MB300 MB反检测能力内置无页面加载85 ms~500 ms启动时间即时~2 秒Puppeteer / Playwright均兼容均兼容关键结论Obscura 是单一 Rust 二进制无需 Chrome、Node.js 或任何运行时依赖serve命令即可对外提供 CDP WebSocket 服务默认端口 9222。这意味着部署它本质上就是跑一个进程天然适配容器与服务管理器两种形态。Docker 容器快速部署一条命令拉起服务官方镜像基于多阶段构建运行层采用distroless/cc——无 shell、无包管理器攻击面极小压缩后仅约 57 MB。构建细节可参阅项目根目录的 Dockerfile。生产推荐启动方式相比最简命令多了三个关键点重启策略、端口绑定回环地址、数据卷持久化docker run -d \ --name obscura \ --restart unless-stopped \ -p 127.0.0.1:9222:9222 \ -v /srv/obscura/data:/data \ h4ckf0r0day/obscura \ serve --host 0.0.0.0 --storage-dir /data --stealth逐项说明--restart unless-stopped容器崩溃或宿主重启后自动拉起这是容器版高可用的底线。-p 127.0.0.1:9222:9222CDP 端口只映射到本机回环。Obscura 的 CDP 服务没有内置认证能连到端口就能驱动浏览器因此切勿直接暴露公网。-v /srv/obscura/data:/data挂载卷持久化 Cookie 与存储数据容器重建不丢状态。--stealth开启反指纹检测 追踪器拦截拦截 3500 追踪域名生产环境抓取建议开启。镜像默认入口即obscura serve --port 9222 --host 0.0.0.0在镜像名后追加参数即可覆盖任何子命令例如需要跨容器访问 MCP 时可切换为mcp --http。systemd 服务部署裸机高可用配置如果你偏好裸机或虚机部署systemd 方案可以让进程随系统自启、崩溃秒级自愈。创建/etc/systemd/system/obscura.service[Unit] DescriptionObscura headless browser Afternetwork.target [Service] ExecStart/usr/local/bin/obscura serve --port 9222 --stealth --storage-dir /var/lib/obscura Restartalways RestartSec5 Userobscura Groupobscura LimitNOFILE65536 MemoryMax4G MemoryHigh3G [Install] WantedBymulti-user.target然后启用并跟踪日志systemctl enable --now obscura journalctl -fu obscura这份清单里最值得理解的四行配置作用RestartalwaysRestartSec5任何原因退出都自动重启间隔 5 秒崩溃自愈Userobscura低权限专用账户运行避免以 root 执行浏览器进程LimitNOFILE65536提升文件描述符上限高并发抓取/多页面场景必备MemoryMax4G/MemoryHigh3G内存硬上限与软水位防止单进程拖垮整台主机 注意--storage-dir /var/lib/obscura指定了存储目录建议提前创建并授权给obscura用户用于持久化 Cookie。高可用配置要点清单对照打勾部署完成后按下表逐项核对#检查项配置方式说明1进程自动重启Restartalways/--restart unless-stopped两种方案的共同底线2端口不暴露公网绑定127.0.0.1:9222CDP 无认证公网裸奔等于交出浏览器控制权3远程访问走 TLS 认证Nginx/Caddy 反向代理见下一节4并发能力匹配 CPUserve --workers N每核一个 worker各维护独立页面池会话粘性绑定5V8 堆按需调整--v8-flags --max-old-space-size2048默认 4 GB 上限内存紧张的主机调低重型 SPA 调高6全链路超时收紧OBSCURA_*系列环境变量防止单页挂起拖垮 worker7日志可观测--verbose或RUST_LOGobscuradebug日志输出到 stderr天然接入 journal/docker logs完整生产文档见 docs/Run-in-production-at-scale.md。并发 worker一核一个obscura serve --workers 4 --port 9222--workers在监听器后面挂 N 个 CDP worker 进程各自处理独立的页面池。建议worker 数 CPU 核心数抓取吞吐随 worker 线性扩展。反向代理暴露 CDP 端口TLS 与认证怎么做需要跨机器如 Puppeteer 应用服务器访问时推荐经 Nginx 加 TLS 和认证location /obscura/ { proxy_pass http://127.0.0.1:9222/; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; proxy_read_timeout 86400; }⚠️ 两个 CDP 特有的坑缺了必失败Upgrade/Connection头CDP 基于 WebSocket不转发升级握手就连不上。proxy_read_timeout 86400长任务页面会长时间无数据流动默认 60 秒超时会把连接掐断。另外Obscura 默认拒绝访问私有/内网 IPSSRF 防护含 DNS 解析时校验。若需指向本地开发服务显式加--allow-private-network或设置OBSCURA_ALLOW_PRIVATE_NETWORK1。超时调优让单页故障拖垮不了整个服务引擎内置了多层熔断V8 看门狗会终止失控脚本、CDP 单条命令超预算即终止、导航与 fetch/XHR 均有超时上限。生产环境可按站点复杂度显式收紧全部环境变量说明见 docs/Environment-variables.md环境变量默认值作用OBSCURA_NAV_TIMEOUT_MS30000单次导航硬上限OBSCURA_SCRIPT_DEADLINE_MS30000页面脚本执行总预算OBSCURA_MODULE_BUDGET_MS3000单个增强模块如 Vite HMR预算OBSCURA_CDP_COMMAND_TIMEOUT_MS60000单条 CDP 命令上限需保持在导航上限之上OBSCURA_FETCH_TIMEOUT_MS30000页面内 fetch/XHR/模块加载超时重型 SPA 示例OBSCURA_NAV_TIMEOUT_MS60000 \ OBSCURA_SCRIPT_DEADLINE_MS45000 \ OBSCURA_CDP_COMMAND_TIMEOUT_MS70000 \ obscura serve --port 9222部署后验证三步确认服务健康进程存活systemctl status obscura或docker ps确认处于 running/restarted 正常状态。CDP 端点连通从本机curl -s http://127.0.0.1:9222应返回 WebSocket 调试端点信息。真实页面验证跑一次端到端抓取——obscura fetch https://example.com --eval document.title能返回页面标题说明 V8、网络、DOM 全链路就绪再看一眼journalctl -fu obscura或docker logs -f obscura确认无异常日志部署即告完成。小结Obscura 的部署哲学非常简单一个二进制一个端口一层自愈。Docker 方案胜在隔离干净、镜像极小systemd 方案胜在裸机零额外依赖两者都只需要把自动重启 端口保密 超时收紧三件事做扎实就能获得生产级的高可用。配合--stealth反检测与按核分配的 worker这套 30 MB 内存的无头浏览器足以支撑大规模、长跑的 AI Agent 抓取任务。【免费下载链接】obscuraThe headless browser for AI agents and web scraping项目地址: https://gitcode.com/gh_mirrors/ob/obscura创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考