
invisible_selenium
改一行 import,Selenium 脚本秒变反检测 Firefox
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-03 · 当前星标 ★ 271
使用教程
环境要求
- Python 3.11 或更新版本
- Windows x86_64 / ARM64(ARM64 走 x86_64 引擎模拟)或 Linux x86_64 / arm64
- 不要与 selenium 同时安装,本包已实现其 API
- 机器需能联网,用于一次性下载打过补丁的 Firefox
安装与启动步骤
-
1安装 Python 包
用 pip 安装 invisible-selenium,它会实现 Selenium 的 API;若环境里已装 selenium,请先卸载以免冲突。
pip install invisible-selenium -
2下载补丁版 Firefox
一次性下载被修改过源码的 Firefox 引擎,下载后会做 sha256 校验;只需执行一次,后续直接复用。
python -m invisible_selenium fetch -
3替换导入语句
原有 Selenium 代码无需改动逻辑,只把 import 从 selenium 换成 invisible_selenium,网页对象与等待类路径同理。
-
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
下一篇:jev-social
同类项目推荐
n8n-helm-chart
开源
一条命令在 Kubernetes 上部署 n8n,轻松搞定自动化工作流
A Kubernetes Helm chart for n8n - a workflow automation tool. Easily automate tasks ···
WeChatBridge
开源
微信聊天一键转发到 AI 与 Obsidian
微信聊天记录一键转发到 AI Agent 与 Obsidian 的原生 macOS 工具
Better-HSR-Currency-Wars
开源
OCR自动刷货币战争开局与组合,解放双手
做了个专门刷货币战争的工具,可以自定义刷开局,用的是OCR识别,也可以刷游戏内一些组合,···
tf-via-pr
开源
PR 里跑 Terraform plan/apply,变更可审可追溯
Plan and apply Terraform/OpenTofu via PR automation, using best practices for secure···
flyto-core
开源
用 YAML 编排 AI 智能体,自动执行并留痕
AI said it finished. Flyto2 shows the proof.
insights-lm-local-package
开源
本地私密版 NotebookLM,文档聊天、音频摘要全离线
Open-source, fully private and local alternative to NotebookLM. Chat with your docum···
Autotube
开源
自动生成并发布YouTube短视频,从选题到成片全流程无人值守
Automated YouTube Shorts creation using n8n, AI script generation, and video process···
EasySpider
开源
拖拽点点鼠标,轻松抓取网页数据
A visual no-code/code-free web crawler/spider易采集:一个可视化浏览器自动化测试/数据···
Gemini-Nexus
开源
侧边栏里的浏览器 AI,能看网页还能替你操作
Gemini Nexus 是一款面向浏览器场景的 AI 助手扩展,集成 Gemini Web、Gemini API 与 Open···