@fingerprintjs/botd

中文文档
2.0.0发布于 2025/11/04MITTypeScriptESM + CJS零依赖近 30 天下载 159.4万

botd是用于JavaScript bot检测的浏览器库

中文使用文档
文档目录13 节
  1. 瓶装
  2. * 维持状况
  3. 快开始
  4. 光盘N
  5. 国家预防机制
  6. 升级到指纹 Pro Bot 探测器 以自信地探测出精密的bots.
  7. 从 v0
  8. 从 v1
  9. 支持的浏览器
  10. 在哪里获得支持
  11. 捐款
  12. GitHub上的其他产品!
  13. 许可证

FingerprintJS logo

Current NPM version Discord server BotD documentation

瓶装

BotD是一个开放源代码库,我们创建这个库是为了让每个开发者都能很容易地检测到他们的网络应用中的基本bots.

它根据允许的麻省理工学院许可证提供,开发商和商业用途将永远免费.

* 维持状况

我们保持开源BotD软件包的健康,并及时作出关键修正并尽快解决回归问题。 尽管如此,近期的行进图仅仅是稳定,所以新特征不太可能很快落地. 请做出相应的规划, 如果你依赖于即将到来的增强.

对于要求更高的应用程序,我们创建了一个基于API的专业机器人检测软件,称为 指纹 Pro Bot 检测。 。 。 .

查看我们的演示

快开始

光盘N

<script>
    // Initialize an agent at application startup, once per page/app.
    const botdPromise = import('https://openfpcdn.io/botd/v2').then((Botd) => Botd.load())
    // Get detection results when you need them.
    botdPromise
        .then((botd) => botd.detect())
        .then((result) => console.log(result))
        .catch((error) => console.error(error))
</script>

运行此代码

国家预防机制

npm i @fingerprintjs/botd
# or
yarn add @fingerprintjs/botd
import { load } from '@fingerprintjs/botd'

// Initialize an agent at application startup, once per page/app.
const botdPromise = load()
// Get detection results when you need them.
botdPromise
    .then((botd) => botd.detect())
    .then((result) => console.log(result))
    .catch((error) => console.error(error))

运行此代码

📕 完整文档

升级到指纹 Pro Bot 探测器 以自信地探测出精密的bots.

指纹 Pro Bot 检测 是一个专业的bot检测服务,它处理所有信息服务器侧并使用服务器到服务器的API安全传输到您的服务器.

指紋Pro Bot Detection同时提供浏览器和服务器侧API,使bot探测过程快速而安全. 在使用Pro Bot检测时,使用浏览器JavaScript SDK获取请求ID值,然后使用我们的服务器API验证这一值.

Pro产品结合了大量bots泄露的辅助数据(cursor movement,网络覆盖,浏览器更改等),从而能够可靠地使真实用户从自动化软件中去除,从而检测出流行的自动化工具,其衍生工具和插件.

Pro探测器的一大优点是,它能够区分好bots和坏bots,可以阻止恶意交通,而无需阻挡搜索引擎爬行者,监控工人等.

Pro BotD screenshot

全面产品比较:

开源 赞成

核心特征

100%开源对没有1个
搜索引擎检测
在所有现代浏览器中工作 - 参见我们的全部列表 支持浏览器
– 说吧 –✓
自动化网络服务检测– 说吧 –✓
自动化浏览器扩展检测– 说吧 –✓

可探测自动化工具和框架

无头浏览器( E)颜色, (中文(简体) ), 火花(中文(简体) )✓✓
硒HQ/硒
将各种工具和库封装起来,使网页浏览器自动化
✓✓
微软/游戏
节点.js 库将 Chromium, Firefox 和 WebKit 自动化, 并使用单一 API
✓✓
ariya/幽灵
可用 JavaScript 无头 WebKit 脚本
✓✓
部门/噩梦
高级浏览器自动化库
✓✓
电子/电子
框架允许您使用 JavaScript 、 HTML 和 CSS 编写跨平台桌面应用程序
✓✓
劳伦特克/斯利默日
可脚本浏览器
✓✓

可探测隐形插件

贝斯特德/普普特尔-外方/包件/普普特尔-外方-外方
用于防止被检测的傀儡-外部插件 .
- 说吧✓
微链接/ 无浏览器
用于控制顶部所建无头浏览器的高效驱动程序 木偶师 为业绩有重大意义的情景
- 说吧✓
超funkamsterdam/未检测到的铬化器
优化不会触发反机器人服务的Selenium Chromedriver补丁
- 说吧✓
MeiK2333/pyppeteer stealth (英语)
隐形插件 便便车
- 说吧✓

其他特征

服务器侧精度提高
基于额外的服务器侧数据,如 TLS 加密支持, ipv4/v6 数据等
– 说吧 –✓
查询 API
建立灵活的工作流程
– 说吧 –✓

业务

数据安全你的基础设施在休息时加密
存储你的基础设施1年以下无限制
区域你的基础设施在美国、欧盟和孟买主办
遵守情况你的基础设施GDPR, 符合CCPA2个
苏丹解放军无苏丹解放军99.9% 时间
支助GitHub 社区在1个工作日内通过电子邮件、聊天和召回等方式支持小组

1. Pro利用开源BotD库以及专有技术提高精度和结果稳定性.

2. 指纹Pro作为数据处理器符合GDPR和CCPA要求。 您仍然需要遵守数据控制器, 并使用机器人检测来防止合法权益的欺诈, 或者征求用户同意 .

结果实例:

{
    "bot": {
        "result": "bad"
        "type": "selenium"
    }
}

🍿 现场演示

📕 指纹 Pro 文档

从 v0

从 v1

支持的浏览器

库支持所有受欢迎的浏览器. 查看更多细节并学习如何在旧浏览器中运行库 浏览器支持指南。 。 。 .

在哪里获得支持

多亏了我们 b系列供资我们很乐意为我们开源的BotD图书馆提供技术支持。 我们建议使用GitHub 问题 提交错误或 讨论情况 问问题. 公开使用问题和讨论将有助于开源社区和其他有类似问题的用户. 不过,如果你需要私人支援,请发电子邮件给我们 oss- support@指印.com。 。 。 .

捐款

见 捐款准则 学习如何为项目作出贡献或在当地管理项目. 在提出拉力请求前请仔细阅读.

GitHub上的其他产品!

许可证

麻省理工学院

2025指纹JS公司

版本与发布记录

@fingerprintjs/botd 共发布 24 个版本,首次发布于 2022/10/20;过去 12 个月发布了 0 个版本。

版本发布日期距今
2.0.0latest2025/11/041 年前
2.0.0-alpha.0alpha2025/08/211.2 年前
1.9.12024/03/302 年前
1.9.02024/01/012 年前
1.7.22023/11/252 年前
1.7.12023/11/123 年前

其他发布通道:beta → 1.0.0-beta.0,alpha → 2.0.0-alpha.0。

关于 @fingerprintjs/botd 的常见问题

@fingerprintjs/botd 是什么?

botd是用于JavaScript bot检测的浏览器库

如何安装 @fingerprintjs/botd?

在项目目录运行 npm install @fingerprintjs/botd,或使用 pnpm add / yarn add / bun add。

@fingerprintjs/botd 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@fingerprintjs/botd 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@fingerprintjs/botd 可以商用吗?

@fingerprintjs/botd 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@fingerprintjs/botd 的下载量有多少?

根据 npm 官方下载统计,@fingerprintjs/botd 在 2026/10/15 – 2026/11/13 这 30 天内被下载 1,593,988 次,日均约 53,133 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@fingerprintjs/botd 还在维护吗?

最新版本 2.0.0 发布于 2025/11/04(1 年前);至今共发布 24 个版本,其中过去 12 个月发布了 0 个;首次发布于 2022/10/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。