invisible_playwright的Docker部署完整指南在云服务器跑反检测隐身浏览器【免费下载链接】invisible_playwrightPlaywright that anti-bots cannot see, so no captchas: same API, anti-detect stealth headless Firefox, undetected fingerprint, bypass bot detection, Python web scraping and browser automation.项目地址: https://gitcode.com/gh_mirrors/in/invisible_playwrightinvisible_playwright 是一个反检测隐身浏览器它用与 Playwright 完全相同的 API驱动一个在 C 源码层修补过的 Firefox让云服务器上的 Python 爬虫绕过 reCAPTCHA、hCaptcha 和 Cloudflare 等反机器人检测不弹验证码。本指南教你在云服务器上用 Docker 完成 invisible_playwright 的完整部署一条 Dockerfile 烤进修补后的浏览器引擎一个--shm-size参数保证稳定运行再用同一个 seed 验证容器里的机器和你桌面上的机器指纹完全一致。先搞清楚为什么裸容器能跑通却仍被拦截很多 Docker Playwright 教程只解决一个问题——让浏览器启动。但启动成功 ≠ 不被识别。一个精简容器会同时暴露 6 个这是台服务器的事实而且它们与navigator.webdriver等自动化标记毫无关系没有 GPUWebGL 回退到软件渲染器Linux 上是llvmpipe这是最响的暴露项字体集极小精简镜像通常只有 DejaVu、Liberation 寥寥几款没有音频设备AudioContext全部回退成无声卡的默认值没有语音列表speechSynthesis.getVoices()返回空数组屏幕是没人用的默认值可用高度等于总高度没有任务栏、像素比恰好为 1核心数与内存组合不存在于任何真实机型比如 2 核配 8G。这 6 项答案彼此一致地指向数据中心而 stealth 插件只能改 JavaScript 属性改不了操作系统渲染管线输出的字体表和屏幕值。invisible_playwright 的思路正相反指纹值由引擎内部按 seed 生成字体随引擎自带所以容器和桌面描述的是同一台机器。更多原理见 playwright-docker-detection.md 和 how-to-run-playwright-docker-undetected.md。另外要分清两类故障容器默认只有 64 MB 的/dev/shm浏览器在高负载下会卡死或崩溃——这是稳定性问题不是检测问题。两者修法完全不同先确认你遇到的是哪一种。一键构建 Dockerfile4 步烤好反检测浏览器部署只需 4 步其中构建期下载引擎是本项目特有的一步FROM mcr.microsoft.com/playwright/python:v1.47.0-jammy WORKDIR /app RUN pip install --no-cache-dir invisible-playwright # 构建期一次性下载修补后的 Firefox约 238 MBsha256 校验 # 这样 docker run 冷启动不再依赖外网 RUN python -m invisible_playwright fetch COPY script.py . CMD [python, script.py]要点说明基础镜像只取共享库。invisible_playwright 不依赖 Playwright 官方镜像捆绑的浏览器它驱动自己的修补版 Firefox镜像的作用是提供 Linux 浏览器启动所需的 X11、GTK、NSS 等系统库。pip install与fetch分两步。Python 包很小浏览器二进制约 238 MB解压后约 544 MB单独一步便于缓存。详见 installation.md。在构建期fetch而不是容器启动时。下载会对invisible-core内置的 sha256 封印逐次校验烤进镜像后每次docker run都无需联网。字体不用装。引擎自带字体栈并完全忽略容器的 fontconfig所以往 Dockerfile 里加字体这一步可以直接省掉——加错平台的字体反而是更强的暴露项。云服务器运行容器别漏掉 --shm-size1gb构建完成后在云服务器上这样运行docker build -t invisible-scraper . docker run --shm-size1gb invisible-scraper--shm-size1gb是给浏览器扩共享内存不要用禁用共享内存类的替代参数——那类参数会改变浏览器行为而不是给它空间。容器内脚本和桌面上一字不差from invisible_playwright import InvisiblePlaywright with InvisiblePlaywright(seed42, headlessTrue) as browser: page browser.new_page() page.goto(https://example.com) page.screenshot(path/app/out.png)注意headlessTrue在这里的含义是有头渲染 隐藏窗口在 Linux 上它会自启动一块虚拟显示让 Firefox 保持在正常渲染管线上缺 Xvfb 时会提示你sudo apt install xvfb。也就是说云服务器上没有显示器完全不是问题见 run-invisible-playwright-headful-server-xvfb.md。3 个环境变量让云服务器构建更快更稳环境变量什么时候需要STEALTHFOX_GITHUB_TOKENCI 或公司网络限速/屏蔽匿名下载时给fetch提供鉴权INVISIBLE_PLAYWRIGHT_CACHE_DIR指向 CI 持久化目录重建镜像时跳过 238 MB 重新下载INVPW_BINARY_PATH直接把二进制烤进镜像完全跳过fetch在 Dockerfile 中显式声明即可ENV STEALTHFOX_GITHUB_TOKEN ENV INVISIBLE_PLAYWRIGHT_CACHE_DIR/opt/invisible-playwright-cache完整的环境变量说明含下载超时INVISIBLE_DOWNLOAD_DEADLINE等见 configuration.md。验证指纹容器与桌面必须是同一台机器seed 的意义就是同一个 seed 在任何地方生成同一台机器而容器恰恰是最容易泄漏宿主机默认值的环境。验证方法很简单在容器内和桌面上各跑一次上面的脚本都用seed42对比两处的navigator.userAgent、hardwareConcurrency、WebGL 渲染器字符串——应当逐字段一致打开out.png截图看一眼真实渲染结果别只信日志打印换几个指纹测试页从外部再确认一遍同一个 seed 应该渲染出同一块面板。要诚实地说明一个边界没有显卡的容器像素依然是软件渲染的——渲染器字符串正确但画像素的仍是软件光栅器。这属于硬件问题任何浏览器补丁都够不着只有宿主机 GPU 直通才是真解对绝大多数云爬虫场景指纹层面已经自洽这并不影响过检测。常见问题排查清单 ️浏览器高负载下卡死/崩溃→ 99% 是 64 MB 的/dev/shm加--shm-size1gbfetch 在 CI 上失败→ 网络限速或屏蔽匿名下载设置STEALTHFOX_GITHUB_TOKEN每次重建都重新下载 238 MB→ 把INVISIBLE_PLAYWRIGHT_CACHE_DIR指向持久卷本地能过、容器被拦→ 容器在描述一台没人拥有的机器对照上文 6 项逐一检查而不是去改navigator.webdriver。延伸阅读容器部署教程原文how-to-use-invisible-playwright-in-docker.md容器检测原理playwright-docker-detection.md快速上手两行切换 Playwrightquickstart.md最小可运行示例examples/basic.py【免费下载链接】invisible_playwrightPlaywright that anti-bots cannot see, so no captchas: same API, anti-detect stealth headless Firefox, undetected fingerprint, bypass bot detection, Python web scraping and browser automation.项目地址: https://gitcode.com/gh_mirrors/in/invisible_playwright创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
