feat(stealth): shrink detectable surface — lazy Runtime.enable, native timezone/WebRTC, opt-in canvas noise

Borrow anti-detection hardening from Scrapling/patchright, preferring native
CDP/Chrome overrides over JS lies:

- Runtime.enable is now opt-in via AGENT_BROWSER_CAPTURE_CONSOLE (default off).
  It was called on every session INCLUDING CdpAttach (the user's real Chrome),
  leaking the patchright/rebrowser "runtime" CDP signal and undermining the
  "real browser, no lies" guarantee. Runtime.evaluate/callFunctionOn and
  runIfWaitingForDebugger work without it; only console/error capture needs it.
  The console/errors commands now return a hint when capture is disabled.
- Timezone alignment via native Emulation.setTimezoneOverride, opt-in with
  AGENT_BROWSER_TIMEZONE=<IANA>|auto (FullLaunch only). Intl and Date both
  follow with no JS artifact.
- WebRTC IP-leak handling via the --force-webrtc-ip-handling-policy Chrome
  flag: auto disable_non_proxied_udp when a proxy is set (so the real IP can't
  leak past the proxy); AGENT_BROWSER_BLOCK_WEBRTC=1 hides the local IP when
  there is no proxy; =0 opts out.
- Opt-in canvas/audio fingerprint noise via AGENT_BROWSER_HIDE_CANVAS=1
  (FullLaunch only). Session-stable seed so reads stay consistent within a
  session while differing from the headless-stable hash.

Adds 5 unit tests; full suite 751 passed, 0 failed.
This commit is contained in:
leeguooooo
2026-06-04 13:28:34 +09:00
parent 900a5b5cde
commit 6b99d304b1
5 changed files with 392 additions and 11 deletions
+124 -1
View File
@@ -1,4 +1,4 @@
const __abStealth = { locale: "en-US", languages: ["en-US", "en"], allowWebGLContextFallback: false };
const __abStealth = { locale: "en-US", languages: ["en-US", "en"], allowWebGLContextFallback: false, hideCanvas: false, canvasSeed: 0 };
(function(){
// Prefer the CDP-level automation override (Emulation.setAutomationOverride),
// which makes navigator.webdriver report `false` NATIVELY — undetectable by
@@ -1275,3 +1275,126 @@ const __abStealth = { locale: "en-US", languages: ["en-US", "en"], allowWebGLCon
}
}
})();
// Canvas + audio fingerprint noise (OPT-IN, full-launch only).
// Headless Chrome produces a stable canvas/audio hash that trackers use as a
// device id. When __abStealth.hideCanvas is on we perturb readback APIs with a
// SESSION-STABLE, sub-perceptual amount of noise: repeated reads on this page
// return the same noised result (a real device is consistent too), but the
// hash differs from the headless default. Off by default — noise is itself a
// "lie", so it's reserved for users who explicitly enable it.
(function(){
if (!__abStealth || __abStealth.hideCanvas !== true) return;
// Deterministic PRNG keyed by the per-session seed plus a position, so the
// same pixel/sample is perturbed identically every read within the session.
const baseSeed = (__abStealth.canvasSeed >>> 0) || 0x9e3779b9;
const noiseAt = (n) => {
let t = (baseSeed ^ Math.imul(n | 0, 0x6d2b79f5)) >>> 0;
t = Math.imul(t ^ (t >>> 15), t | 1) >>> 0;
t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
};
// Make a wrapped function masquerade as the native one (toString + name).
const mask = (wrapped, native) => {
try {
Object.defineProperty(wrapped, 'name', {
value: native.name,
configurable: true,
});
Object.defineProperty(wrapped, 'toString', {
value: () => native.toString(),
configurable: true,
writable: true,
});
} catch {}
return wrapped;
};
// ---- Canvas 2D readback ---------------------------------------------------
const perturbImageData = (imageData) => {
const data = imageData && imageData.data;
if (!data || !data.length) return imageData;
for (let i = 0; i < data.length; i += 4) {
// Touch ~5% of pixels by +/-1 on each RGB channel; leave alpha alone.
if (noiseAt(i) < 0.05) {
const delta = noiseAt(i + 1) < 0.5 ? -1 : 1;
data[i] = Math.max(0, Math.min(255, data[i] + delta));
data[i + 1] = Math.max(0, Math.min(255, data[i + 1] + delta));
data[i + 2] = Math.max(0, Math.min(255, data[i + 2] + delta));
}
}
return imageData;
};
try {
const ctxProto = (typeof CanvasRenderingContext2D !== 'undefined')
? CanvasRenderingContext2D.prototype : null;
if (ctxProto && typeof ctxProto.getImageData === 'function') {
const nativeGetImageData = ctxProto.getImageData;
ctxProto.getImageData = mask(function(...args) {
return perturbImageData(nativeGetImageData.apply(this, args));
}, nativeGetImageData);
}
} catch {}
// For toDataURL/toBlob, draw the (already-rendered) canvas onto a scratch
// canvas, perturb its pixels, then encode that — so the export hash shifts
// without disturbing what the page sees on screen.
const exportNoised = (canvas) => {
try {
const w = canvas.width, h = canvas.height;
if (!w || !h) return null;
const scratch = document.createElement('canvas');
scratch.width = w; scratch.height = h;
const sctx = scratch.getContext('2d');
if (!sctx) return null;
sctx.drawImage(canvas, 0, 0);
const img = sctx.getImageData(0, 0, w, h);
perturbImageData(img);
sctx.putImageData(img, 0, 0);
return scratch;
} catch { return null; }
};
try {
const canvasProto = (typeof HTMLCanvasElement !== 'undefined')
? HTMLCanvasElement.prototype : null;
if (canvasProto && typeof canvasProto.toDataURL === 'function') {
const nativeToDataURL = canvasProto.toDataURL;
canvasProto.toDataURL = mask(function(...args) {
const scratch = exportNoised(this);
return nativeToDataURL.apply(scratch || this, args);
}, nativeToDataURL);
}
if (canvasProto && typeof canvasProto.toBlob === 'function') {
const nativeToBlob = canvasProto.toBlob;
canvasProto.toBlob = mask(function(cb, ...rest) {
const scratch = exportNoised(this);
return nativeToBlob.call(scratch || this, cb, ...rest);
}, nativeToBlob);
}
} catch {}
// ---- AudioBuffer readback -------------------------------------------------
// Perturb time-domain samples by a tiny, seed-stable amount so the audio
// fingerprint (sum/hash of channel data) shifts without audible effect.
try {
const audioProto = (typeof AudioBuffer !== 'undefined') ? AudioBuffer.prototype : null;
if (audioProto && typeof audioProto.getChannelData === 'function') {
const nativeGetChannelData = audioProto.getChannelData;
const seen = new WeakSet();
audioProto.getChannelData = mask(function(...args) {
const channel = nativeGetChannelData.apply(this, args);
// Only perturb once per buffer to keep reads consistent.
if (channel && !seen.has(channel)) {
seen.add(channel);
for (let i = 0; i < channel.length; i += 100) {
channel[i] = channel[i] + (noiseAt(i) - 0.5) * 1e-7;
}
}
return channel;
}, nativeGetChannelData);
}
} catch {}
})();