fingerprint.js的使用

news2024/11/30 14:08:58

FingerprintJS 是一个基于 JavaScript 的浏览器指纹识别库，可以通过收集浏览器和设备的多个属性来生成一个独一无二的指纹（即一个用户的唯一标识符）。这个库的常见用途包括防止欺诈、识别重复用户、分析流量等。

安装 FingerprintJS

1. 通过 CDN 引入

最简单的方式是直接通过 CDN 引入：

<script src="https://cdn.jsdelivr.net/npm/fingerprintjs@3.3.0/dist/fingerprint.min.js"></script>

2. 通过 NPM 安装

如果你使用的是 Node.js 或前端构建工具（如 Webpack），可以通过 NPM 安装：

npm install @fingerprintjs/fingerprintjs

bash

npm install @fingerprintjs/fingerprintjs

基本使用方法

1. 初始化 FingerprintJS 实例

// 引入 FingerprintJS
import FingerprintJS from '@fingerprintjs/fingerprintjs';

// 初始化 FingerprintJS
FingerprintJS.load().then(fingerprint => {
  // 获取浏览器指纹
  fingerprint.get().then(result => {
    // result.visitorId 包含生成的唯一指纹
    console.log(result.visitorId);
  });
});

在上面的代码中：

FingerprintJS.load() 异步加载 FingerprintJS 库并返回一个指纹实例。
fingerprint.get() 方法返回一个指纹对象，其中 visitorId 是我们用来标识用户的唯一 ID。

2. 在浏览器中生成指纹

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>FingerprintJS Example</title>
  <script src="https://cdn.jsdelivr.net/npm/fingerprintjs@3.3.0/dist/fingerprint.min.js"></script>
</head>
<body>
  <h1>FingerprintJS Example</h1>
  <script>
    FingerprintJS.load().then(fingerprint => {
      fingerprint.get().then(result => {
        document.body.innerHTML += `<p>Visitor ID: ${result.visitorId}</p>`;
      });
    });
  </script>
</body>
</html>

这个例子会在页面加载后显示一个“Visitor ID”，它是基于浏览器和设备的一些信息生成的唯一标识符。

FingerprintJS 的工作原理

FingerprintJS 通过采集用户浏览器和设备的多种特征来生成指纹，这些特征包括但不限于：

浏览器的插件信息
屏幕分辨率
操作系统类型
字体列表
用户语言
浏览器窗口大小
系统和浏览器的硬件信息（如 GPU、CPU、WebGL等）

通过这些特征，FingerprintJS 可以尽可能准确地生成一个唯一标识符。

高级用法：结合后端处理

在一些应用场景中，前端生成的指纹可能会被传递到后端以进行进一步分析或存储。你可以将 visitorId 发送到你的后端服务器，做进一步的操作。

// 获取指纹后，将其发送到后端
FingerprintJS.load().then(fingerprint => {
  fingerprint.get().then(result => {
    const visitorId = result.visitorId;
    
    // 假设我们有一个后端 API 接口来接收指纹
    fetch('/api/track_visitor', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ visitorId })
    })
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));
  });
});