Dấu Vân Tay Tùy Chỉnh

Giới thiệu

Dấu vân tay trình duyệt sử dụng thông tin cấu hình trình duyệt và thiết bị của bạn để tạo ra một “dấu vân tay kỹ thuật số” gần như duy nhất, có thể được dùng để theo dõi hoạt động trực tuyến của bạn ngay cả khi không có cookie. Tin tốt là cấu hình dấu vân tay là tùy chọn trong trình duyệt cào dữ liệu. Chúng tôi cung cấp khả năng tùy chỉnh chuyên sâu cho dấu vân tay trình duyệt, chẳng hạn như các tham số cốt lõi như user agent của trình duyệt, múi giờ, ngôn ngữ và độ phân giải màn hình. Chức năng có thể được mở rộng thông qua các tham số khởi chạy tùy chỉnh. Điều này phù hợp cho các tình huống như quản lý đa tài khoản, thu thập dữ liệu và bảo vệ quyền riêng tư, sử dụng trình duyệt Chromium tự phát triển của Scrapeless để hoàn toàn tránh bị phát hiện. Theo mặc định, việc sử dụng dịch vụ Trình Duyệt Cào Dữ Liệu của chúng tôi sẽ tạo ra một dấu vân tay ngẫu nhiên cho mỗi phiên.

Khả Năng Cốt Lõi và Giới Hạn

Kiểm soát User-Agent

Khả năng: Hỗ trợ tùy chỉnh chuỗi User-Agent trong tiêu đề yêu cầu HTTP, cho phép định nghĩa phiên bản engine trình duyệt và loại hệ điều hành.
Giới hạn: Hiện không thể sửa đổi chi tiết engine hiển thị (ví dụ: các tính năng hiển thị WebGL).

Ánh Xạ Độ Phân Giải Màn Hình

Khả năng: Hỗ trợ tùy chỉnh giá trị trả về cho screen.width và screen.height để mô phỏng kích thước màn hình thiết bị cơ bản (phải tuân theo tỷ lệ khung hình vật lý).
Giới hạn: Hiện không thể giả mạo tỷ lệ điểm ảnh thiết bị (DPR) hoặc đặc điểm màn hình Retina.

Khóa Thuộc Tính Nền Tảng

Khả năng: Cho phép đặt giá trị trả về cố định cho navigator.platform (chỉ hỗ trợ Windows/macOS/Linux), điều này ảnh hưởng đến logic phát hiện tính năng của trình duyệt.
Giới hạn: Hiện không thể sửa đổi số phiên bản hệ điều hành hoặc thông tin kiến trúc phần cứng.

Các Giới Hạn Khác:

Tính năng này chỉ hỗ trợ điều chỉnh giới hạn các tham số tiêu chuẩn được trình duyệt hiển thị nguyên bản. Nó không liên quan đến dấu vân tay cấp phần cứng hoặc che giấu hành vi nâng cao.

Các Tình Huống Ứng Dụng

Cô Lập Đa Tài Khoản Cơ Bản: Tránh bị phát hiện liên kết tài khoản đơn giản bằng cách phân biệt User-Agent và độ phân giải màn hình.
Thu Thập Dữ Liệu Nhẹ: Mô phỏng môi trường trình duyệt phổ biến (Windows + Chrome) để vượt qua các chiến lược chống cào cơ bản của trang web mục tiêu (ví dụ: danh sách đen User-Agent).
Kiểm Tra Tương Thích: Xác minh logic hiển thị cơ bản của trang web trên các hệ điều hành khác nhau (Windows/macOS) và kích thước màn hình.

Hướng Dẫn Vận Hành

Mô Tả Tham Số Dấu Vân Tay

Tên Tham Số	Loại	Mô Tả
userAgent	string	Xác định chuỗi User-Agent trong tiêu đề yêu cầu HTTP của trình duyệt, chứa thông tin nhận dạng chính như engine trình duyệt, số phiên bản và hệ điều hành. Trang web sử dụng giá trị này để nhận diện môi trường máy khách, ảnh hưởng đến việc thích ứng nội dung và chức năng. Giá trị mặc định: Theo trình duyệt
platform	enum	Chỉ định giá trị trả về của thuộc tính JavaScript `navigator.platform`, cho biết loại hệ điều hành của môi trường thời gian chạy. Các giá trị tùy chọn là “Windows”, “macOS” hoặc “Linux”. Tham số này sẽ được dùng cho việc phát hiện tính năng và quyết định bật các chức năng liên quan đến hệ thống. Giá trị mặc định: Windows
screen	object	Định nghĩa các tham số đặc tính vật lý của thiết bị hiển thị được trình duyệt báo cáo, ánh xạ trực tiếp tới đối tượng JavaScript `window.screen`.
screen.width	number	Chiều rộng màn hình vật lý (pixel), ánh xạ tới thuộc tính `screen.width`, ảnh hưởng đến media queries và bố cục phản hồi. Giá trị mặc định: Theo dấu vân tay ngẫu nhiên, giá trị tối thiểu 640.
screen.height	number	Chiều cao màn hình vật lý (pixel), ánh xạ tới thuộc tính `screen.height`, cùng với chiều rộng xác định đặc điểm độ phân giải thiết bị. Giá trị mặc định: Theo dấu vân tay ngẫu nhiên, giá trị tối thiểu 480.
localization	object	Kiểm soát cấu hình môi trường bản địa hóa của trình duyệt, bao gồm ngôn ngữ, khu vực và tham số múi giờ, ảnh hưởng đến định dạng hiển thị và hành vi bản địa hóa nội dung.
localization.basedOnIp	boolean	Có tự động đặt múi giờ và ngôn ngữ dựa trên IP hay không.
localization.timezone	string	Mã định danh múi giờ tuân theo định dạng cơ sở dữ liệu múi giờ IANA (ví dụ: “Asia/Shanghai”), kiểm soát hành vi múi giờ mặc định của các đối tượng ngày JavaScript và đầu ra `Intl.DateTimeFormat`, là thành phần chính của dấu vân tay múi giờ. Giá trị mặc định: America/New_York
localization.languages	[string]	Danh sách ưu tiên ngôn ngữ được trình duyệt hỗ trợ, ánh xạ tới thuộc tính `navigator.languages` và tiêu đề yêu cầu HTTP `Accept-Language`, xác định logic lựa chọn ngôn ngữ nội dung của trang web. Giá trị mặc định: “en”, “en-US”
args	object	Chạy trình duyệt với các công tắc dòng lệnh (ví dụ: `--window-size`, `--proxy-bypass-list`, v.v., tìm hiểu thêm), Xin lưu ý rằng các args sau không được hỗ trợ: `--load-extension, --user-data-dir, --fonts-dir, --remote-debugging-port`

userAgent

Loại: string Mô tả: Xác định chuỗi User-Agent trong tiêu đề yêu cầu HTTP của trình duyệt, chứa thông tin nhận dạng chính như engine trình duyệt, số phiên bản và hệ điều hành. Trang web sử dụng giá trị này để nhận diện môi trường máy khách, ảnh hưởng đến việc thích ứng nội dung và chức năng. Bạn có thể tùy chỉnh bất kỳ userAgent nào.

Giá Trị Ví Dụ:

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.6834.83 Safari/537.36
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.6834.83 Safari/537.36

platform

Loại: enum Mô tả: Chỉ định giá trị trả về của thuộc tính JavaScript navigator.platform, cho biết loại hệ điều hành của môi trường thời gian chạy. Tham số này sẽ được dùng cho việc phát hiện tính năng và quyết định bật các chức năng liên quan đến hệ thống.

Giá Trị Chấp Nhận Được Ví Dụ:

Giá Trị	Mô Tả
”Windows”	Hệ điều hành Windows, giá trị mặc định
”macOS”	Hệ điều hành macOS
”Linux”	Hệ điều hành Linux

screen

Loại: object Mô tả: Định nghĩa các tham số đặc tính vật lý của thiết bị hiển thị được trình duyệt báo cáo, ánh xạ trực tiếp tới đối tượng JavaScript window.screen.

screen.width: Chiều rộng màn hình vật lý (pixel), ảnh hưởng đến media queries và bố cục phản hồi, giá trị tối thiểu 640. screen.height: Chiều cao màn hình vật lý (pixel), cùng với chiều rộng xác định đặc điểm độ phân giải thiết bị, giá trị tối thiểu 480.

Giá Trị Ví Dụ:

width	height
1920	1080
1366	768
1280	720
768	1280

localization

Loại: object Mô tả: Kiểm soát cấu hình môi trường bản địa hóa của trình duyệt, bao gồm ngôn ngữ, khu vực và tham số múi giờ, ảnh hưởng đến định dạng hiển thị và hành vi bản địa hóa nội dung.

localization.basedOnIp: Có tự động đặt múi giờ và ngôn ngữ dựa trên IP hay không.

localization.timezone: Mã định danh múi giờ tuân theo định dạng cơ sở dữ liệu múi giờ IANA, kiểm soát hành vi múi giờ mặc định của các đối tượng ngày JavaScript và đầu ra Intl.DateTimeFormat, là thành phần chính của dấu vân tay múi giờ.

Giá Trị Ví Dụ:

America/New_York
Asia/Shanghai
Europe/London

localization.languages: Danh sách ưu tiên ngôn ngữ được trình duyệt hỗ trợ, ánh xạ tới thuộc tính navigator.languages và tiêu đề yêu cầu HTTP Accept-Language, xác định logic lựa chọn ngôn ngữ nội dung của trang web.

Giá Trị Ví Dụ:

["fr-FR", "en-US", "zh-CN"]
["en-US", "es-ES", "de-DE"]

Tham Khảo: danh sách múi giờ cơ sở dữ liệu tz

args

Loại: object Mô tả: Chạy trình duyệt với các công tắc dòng lệnh, nhấp để tìm hiểu thêm, Xin lưu ý rằng các args sau không được hỗ trợ: --load-extension, --user-data-dir, --fonts-dir, --remote-debugging-port

Giá Trị Ví Dụ:

bỏ qua proxy: '--proxy-bypass-list': 'example.com'
đặt kích thước cửa sổ: '--window-size': '1280,1024', nên đặt giống với dấu vân tay screen

Mã Ví Dụ

const { ScrapelessClient } = require('@scrapeless-ai/sdk');
const puppeteer =require('puppeteer-core');
const client = new ScrapelessClient({ apiKey: 'API Key' });
 
// dấu vân tay trình duyệt tùy chỉnh
const fingerprint = {
    userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.1.2.3 Safari/537.36',
    platform: 'Windows',
    screen: {
        width: 1280, height: 1024
    },
    localization: {
        languages: ['zh-HK', 'en-US', 'en'], timezone: 'Asia/Hong_Kong',
    },
    args: {
        '--proxy-bypass-list': 'example.com',
        '--window-size': '1280,1024' // đặt kích thước cửa sổ giống với dấu vân tay màn hình
    }
}
 
// Tạo phiên trình duyệt và lấy điểm cuối WebSocket
const { browserWSEndpoint } = client.browser.create({
    sessionName: 'sdk_test',
    sessionTTL: 180,
    proxyCountry: 'US',
    sessionRecording: true,
    fingerprint,
});
 
(async () => {
    const browser = await puppeteer.connect({browserWSEndpoint});
    const page = await browser.newPage();
    await page.goto('https://www.scrapeless.com');
    const info = await page.evaluate(() => {
        return {
            screen: {
                width:screen.width,
                height:screen.height,
            },
            userAgent:navigator.userAgent,
            timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
            languages:navigator.languages
        };
    });
    console.log(info);
 
    await browser.close();
})();

const puppeteer =require('puppeteer-core');
 
// dấu vân tay trình duyệt tùy chỉnh
const fingerprint = {
    userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.1.2.3 Safari/537.36',
    platform: 'Windows',
    screen: {
        width: 1280, height: 1024
    },
    localization: {
        languages: ['zh-HK', 'en-US', 'en'], timezone: 'Asia/Hong_Kong',
    }
}
 
const query = new URLSearchParams({
  token: 'APIKey',// bắt buộc
  sessionTTL: 180,
  proxyCountry: 'ANY',
  fingerprint: encodeURIComponent(JSON.stringify(fingerprint)),
});
 
const connectionURL = `wss://browser.scrapeless.com/api/v2/browser?${query.toString()}`;
 
(async () => {
    const browser = await puppeteer.connect({browserWSEndpoint: connectionURL});
    const page = await browser.newPage();
    await page.goto('https://www.scrapeless.com');
    const info = await page.evaluate(() => {
        return {
            screen: {
                width:screen.width,
                height:screen.height,
            },
            userAgent:navigator.userAgent,
            timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
            languages:navigator.languages
        };
    });
    console.log(info);
    await browser.close();
})();

const { chromium } = require('playwright-core');
 
// dấu vân tay trình duyệt tùy chỉnh
const fingerprint = {
    userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.1.2.3 Safari/537.36',
    platform: 'Windows',
    screen: {
        width: 1280, height: 1024
    },
    localization: {
        languages: ['zh-HK', 'en-US', 'en'], timezone: 'Asia/Hong_Kong',
    }
}
 
const query = new URLSearchParams({
  token: 'APIKey',// bắt buộc
  sessionTTL: 180,
  proxyCountry: 'ANY',
  fingerprint: encodeURIComponent(JSON.stringify(fingerprint)),
});
 
const connectionURL = `wss://browser.scrapeless.com/api/v2/browser?${query.toString()}`;
 
(async () => {
    const browser = await chromium.connectOverCDP(connectionURL);
    const page = await browser.newPage();
    await page.goto('https://www.scrapeless.com');
    const info = await page.evaluate(() => {
        return {
            screen: {
                width:screen.width,
                height:screen.height,
            },
            userAgent:navigator.userAgent,
            timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
            languages:navigator.languages
        };
    });
console.log(info);
    await browser.close();
})();

Tuyên Bố Đạo Đức

Chúng tôi ủng hộ việc tùy chỉnh dấu vân tay có trách nhiệm:

Chỉ dành cho các tình huống được ủy quyền hợp pháp (chẳng hạn như thu thập dữ liệu tuân thủ của doanh nghiệp, kiểm tra kiểm soát rủi ro nội bộ).
Nghiêm cấm sử dụng dấu vân tay giả mạo để thực hiện lừa đảo trực tuyến hoặc xâm phạm quyền riêng tư của người dùng.

Real-time Signaling (MFA)CDP API