invisible_selenium

改一行 import,Selenium 脚本秒变反检测 Firefox

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 自动化工作流 🍴 复刻 201 👀 关注 14
GitHub ↗
GitHub 星标 ★ 271
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费使用

项目预览

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

项目数据

分类自动化工作流
开发团队oss-invisible
定价模式🏷️完全免费
价格说明开源免费使用
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型anti-bot,anti-detect,anti-detect-browser,antidetect,antidetect-browser,bot-detection,browser-automation,firefox,geckodriver,headless-browser,python,selenium,selenium-python,selenium-webdriver,stealth,stealth-browser,web-automation,web-scraping,webdriver,webscraping
GitHub 星标★ 271
上线时间2024-08-16 00:00:00
代码更新2026-11-12
仓库体积12.5 MB
本站数据更新2026-11-17
维护状态活跃
收录时间2026-10-03
浏览次数3

项目介绍

invisible_selenium 是一个基于 Python 的浏览器自动化工具,它把 Selenium 的 API 直接运行在打过补丁的 Firefox 上,并内置一套确定性的反检测(stealth)配置。它要解决的问题是:普通 Selenium 驱动的浏览器很容易被网站识别为自动化程序,导致爬虫被拦截、登录被风控、页面数据拿不到。项目通过修改 Firefox 指纹特征(如 navigator.webdriver、插件列表、屏幕参数等)来降低被检测概率,同时保持 Selenium 原有调用方式,用户只需把 import 从 selenium 换成 invisible_selenium,原有脚本几乎不用改就能继续跑。核心能力包括:兼容 Selenium 常用 API、提供稳定的 stealth 环境、支持 Firefox 自动化、适合网页抓取和自动化工作流。对已有 Selenium 脚本想快速增加隐蔽性的开发者来说,迁移成本很低。

Star 增长趋势

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

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

使用教程

难度:入门 约 10 分钟 部署方式:库/依赖 4 步

环境要求

  • Python 3.11 或更新版本
  • Windows x86_64 / ARM64(ARM64 走 x86_64 引擎模拟)或 Linux x86_64 / arm64
  • 不要与 selenium 同时安装,本包已实现其 API
  • 机器需能联网,用于一次性下载打过补丁的 Firefox

安装与启动步骤

  1. 1安装 Python 包

    用 pip 安装 invisible-selenium,它会实现 Selenium 的 API;若环境里已装 selenium,请先卸载以免冲突。

    pip install invisible-selenium
  2. 2下载补丁版 Firefox

    一次性下载被修改过源码的 Firefox 引擎,下载后会做 sha256 校验;只需执行一次,后续直接复用。

    python -m invisible_selenium fetch
  3. 3替换导入语句

    原有 Selenium 代码无需改动逻辑,只把 import 从 selenium 换成 invisible_selenium,网页对象与等待类路径同理。

  4. 4运行示例脚本

    用 webdriver.Firefox() 打开页面并点击元素,无头或有界面模式指纹一致;记得 driver.quit() 收尾。

    from invisible_selenium import webdriver
    from invisible_selenium.webdriver.common.by import By
    from invisible_selenium.webdriver.support.ui import WebDriverWait
    from invisible_selenium.webdriver.support import expected_conditions as EC
    
    driver = webdriver.Firefox()
    driver.get("https://example.com")
    WebDriverWait(driver, 10).until(EC.element_to_be_clickable((By.TAG_NAME, "a"))).click()
    print("seed =", driver.seed)
    driver.quit()

关键配置

配置项必填说明示例
driver.seed否每个会话的指纹种子,记录下来可用于复现同一次运行driver.seed

如何确认成功

脚本成功打开 example.com 并点击链接,终端打印出 seed 值,driver.quit() 正常退出且无报错。

常见问题

Q:还需要安装 geckodriver 或 Marionette 吗?

A:不需要。README 明确说明该方案不带 geckodriver,也不使用 Marionette,浏览器由包内补丁版 Firefox 引擎直接驱动。

Q:可以同时保留原有的 selenium 包吗?

A:不可以。README 提醒不要在它旁边安装 Selenium,因为这个包本身已经实现了 Selenium 的 API,共存会冲突。

Q:支持 macOS 吗?

A:README 只列出 Windows x86_64 / ARM64 和 Linux x86_64 / arm64,未提及 macOS,因此在 mac 上使用没有官方说明支持。

Q:无头模式和有界面模式的指纹一样吗?

A:一样。指纹在引擎内部设置,navigator、screen、GPU/WebGL、canvas、字体、音频、WebRTC、时区、网络等取值在无头和有界面模式下相同。

注意事项

  • 安装前先确认 Python 版本不低于 3.11,否则包无法正常运行。
  • fetch 步骤只需执行一次,重复执行会重新下载补丁版 Firefox。
  • 每个会话都会生成不同的指纹(GPU、音频、字体、屏幕等约 200 个字段),需要复现时请记录 driver.seed。
  • README 只保证 Windows 与 Linux 平台,其他系统无官方支持说明。

核心亮点

  • 迁移成本极低,只需替换 import 即可复用现有 Selenium 脚本
  • 基于打过补丁的 Firefox,stealth 配置确定性好,不依赖随机化碰运气
  • 保持 Selenium 原生 API,学习成本几乎为零,适合已有爬虫项目快速改造

不足之处

  • 仅支持 Firefox,无法用于 Chrome/Chromium 生态,选择面窄
  • 项目星标较少,社区规模和长期维护活跃度有待观察

适用场景

  • 已有 Selenium 爬虫被目标网站识别拦截,想低成本增加隐蔽性
  • 需要登录或采集对自动化敏感网站的数据,降低被风控概率
  • 自动化测试或工作流中要求浏览器指纹稳定、可复现的 stealth 环境

替代项目

undetected-chromedriver、playwright-stealth

上一篇:invisible_puppeteer

下一篇:jev-social

同类项目推荐

n8n-helm-chart 开源

一条命令在 Kubernetes 上部署 n8n,轻松搞定自动化工作流

A Kubernetes Helm chart for n8n - a workflow automation tool. Easily automate tasks ···

★ 709 2026-08-22
WeChatBridge 开源

微信聊天一键转发到 AI 与 Obsidian

微信聊天记录一键转发到 AI Agent 与 Obsidian 的原生 macOS 工具

★ 2362 2026-09-25
Better-HSR-Currency-Wars 开源

OCR自动刷货币战争开局与组合,解放双手

做了个专门刷货币战争的工具,可以自定义刷开局,用的是OCR识别,也可以刷游戏内一些组合,···

★ 162 2026-09-29
tf-via-pr 开源

PR 里跑 Terraform plan/apply,变更可审可追溯

Plan and apply Terraform/OpenTofu via PR automation, using best practices for secure···

★ 350 2026-10-21
flyto-core 开源

用 YAML 编排 AI 智能体,自动执行并留痕

AI said it finished. Flyto2 shows the proof.

★ 483 2026-08-09
insights-lm-local-package 开源

本地私密版 NotebookLM,文档聊天、音频摘要全离线

Open-source, fully private and local alternative to NotebookLM. Chat with your docum···

★ 227 2026-08-09
Autotube 开源

自动生成并发布YouTube短视频,从选题到成片全流程无人值守

Automated YouTube Shorts creation using n8n, AI script generation, and video process···

★ 81 2026-08-09
EasySpider 开源

拖拽点点鼠标,轻松抓取网页数据

A visual no-code/code-free web crawler/spider易采集:一个可视化浏览器自动化测试/数据···

★ 44798 2026-08-10
Gemini-Nexus 开源

侧边栏里的浏览器 AI,能看网页还能替你操作

Gemini Nexus 是一款面向浏览器场景的 AI 助手扩展,集成 Gemini Web、Gemini API 与 Open···

★ 1128 2026-09-16