@tocha688/browser 0.0.1

package/src/providers/adspower.ts

@@ -0,0 +1,235 @@
+import fs from "fs";
+import path from "path";
+import { faker } from "@faker-js/faker";
+import { adsEncodeBase64, adsDecodeBase64 } from "./ads_tool";
+import { PcScreen, WindowsWebGL, Cpus, Memorys, rSysFonts } from "../const/browser";
+import type { BrowserResult, BrowserStartOptions } from "../types";
+import { checkAutoProxy, rArrItem, rInt, uuidV4, rAutoDigitInt } from "@tocha688/utils";
+import { launchBrowserBase } from "./base";
+
+export async function AdsBrowserStartMain(opts: BrowserStartOptions): Promise<BrowserResult> {
+    return launchBrowserBase(opts, {
+        prepare: async (userDataDir, devtoolsPort) => {
+            const webGLFP_path = path.join(userDataDir, "webgl.json")
+            const dynamicConfig_path = path.join(userDataDir, "dynamic.config")
+            const staticConfig_path = path.join(userDataDir, "static.config")
+            const params_path = path.join(userDataDir, "params.config")
+
+            let params: string;
+            let screenSize: string;
+
+            if (fs.existsSync(params_path)) {
+                params = fs.readFileSync(params_path, "utf-8");
+                const decoded = JSON.parse(adsDecodeBase64(params));
+                screenSize = decoded.ScreenSize;
+            } else {
+                let ipinfo: any = {};
+                let proxyInfo: URL | undefined;
+
+                if (opts.proxy) {
+                    ipinfo = await checkAutoProxy(opts.proxy);
+                    proxyInfo = new URL(ipinfo.proxy)
+                }
+
+                // webgl指纹
+                const config = {
+                    // 指纹随机数种子
+                    fp: rInt(100000, 999999),
+                    geop: ipinfo?.latitude ? ipinfo?.latitude + "," + ipinfo?.longitude : "",
+                    // 加上随机字符串 MSBYH29R
+                    device_name: "PC" + faker.string.alphanumeric(8).toUpperCase(),
+                    timezone: ipinfo?.timezone || "America/Los_Angeles",
+                    proxy: {
+                        protocol: proxyInfo?.protocol.replace(":", "") || "http",
+                        host: proxyInfo?.hostname || "127.0.0.1",
+                        port: proxyInfo?.port || "8080",
+                        username: proxyInfo?.username || "",
+                        password: proxyInfo?.password || "",
+                    },
+                    mac: faker.internet.mac(),
+                    scanPorts: "3389,1080",
+                    screenSize: rArrItem(PcScreen),
+                    langs: ipinfo?.languages ?? "en-US,en",
+                }
+                const webGL = rArrItem(WindowsWebGL);
+                const webGLFP = {
+                    "UNMASKED_VENDOR_WEBGL": webGL.name,
+                    "UNMASKED_RENDERER_WEBGL": rArrItem(webGL.values),
+                    "GPUAdapterInfo": {
+                        "vendor": webGL.vendor,
+                        "architecture": "pascal"
+                    },
+                    "SUPPORTED_EXTENSIONS": [
+                    ]
+                }
+                // 黑名单 在名单上的不会修改指纹
+                const dynamic = {
+                    "BlockList": {
+                        "Version": "1743148877",
+                        // 白名单域名
+                        "Domains": []
+                    },
+                    "StrongBlockList": {
+                        "Version": "3",
+                        "Domains": []
+                    },
+                    "TimeZone": config.timezone,
+                    "Geoposition": config.geop
+                }
+                // 静态配置
+                const staticConfig = {
+                    // "CookiesExportPath": "C:\\.ADSPOWER_GLOBAL\\cache\\k186hhvu_hwvl6k\\sf_cookie.txt",
+                    "CookiesExportPath": "",
+                    "SecurePreferenceSync": true,
+                    // "PasswordExportPath": "C:\\.ADSPOWER_GLOBAL\\cache\\k186hhvu_hwvl6k\\e2776b7f6d0ee269e7a3d43987c7b103",
+                    "PasswordExportPath": "",
+                    // "PasswordImportPath": "C:\\.ADSPOWER_GLOBAL\\cache\\k186hhvu_hwvl6k\\6c13174a34c549425974d259f9589e45",
+                    "PasswordImportPath": "",
+                    "RestoreLastSession": true,
+                    // 黑名单页面的html base64编码
+                    "BlockPage": "NDA0",
+                    "FoceSafeBrowsing": true,
+                    "ExtensionSetting": [
+                        // {
+                        //     "path": "C:\\Users\\Administrator\\AppData\\Roaming\\Electron\\cwd_global\\lib\\tab_assistant",
+                        //     "pinned": 0,
+                        //     "hide": true,
+                        //     "version": "0.0.1",
+                        //     "accessWeb": true
+                        // }
+                    ],
+                    // 不修改指纹的域名列表 net-a-porter.com,nike.com,fedex.com,thenorthface,bybit.com,adidas.com,mrporter.com,lululemon.com,sephora.com,biglietti.italotreno.it,target.com,tangerine.ca,ipdog.io,dhl.com,spotify.com,vinted.com,pingpongx.com,uber.com,wildberries.ru
+                    "DisCanvasUrl": "",
+                    "MaxTouchPoints": 0,
+                    "MediaDevices": [
+                        {
+                            "kind": "audioinput",
+                            "label": "Microphone Array (Realtek(R) Audio)"
+                        },
+                        {
+                            "kind": "videoinput",
+                            "label": "Integrated Camera (98da:3959)"
+                        },
+                        {
+                            "kind": "audiooutput",
+                            "label": "Speakers (Realtek(R) Audio)"
+                        }
+                    ],
+                    "AudioFp": rAutoDigitInt(980, config.fp),
+                    "WebGLMark": rAutoDigitInt("5001", config.fp).toString(),
+                    "StartTime": Math.floor(Date.now() / 1000),
+                    "GeolocationSetting": "ask",
+                    "FlashPluginSetting": "block",
+                    "Platform": "Win32",
+                    "ScreenSize": config.screenSize,
+                    "DisableBackgroundMode": true,
+                    "DisableWebRTC": true,
+                    "HardwareConcurrency": rArrItem(Cpus),
+                    "DeviceMemory": rArrItem(Memorys),
+                    "LoadExtensionErrorBox": false,
+                    "ClientRectFp": rAutoDigitInt("5001", config.fp).toString(),
+                    "ForceProcessExit": true,
+                    "ProxyUser": config.proxy.username,
+                    "ProxyPassword": config.proxy.password,
+                    "Langs": config.langs,
+                    "AcceptLang": config.langs ? config.langs + ",q=0.9" : "en-US,en;q=0.9",
+                    // 禁用字体
+                    "DisabledFonts": (await rSysFonts()).join(","),
+                }
+
+                fs.writeFileSync(webGLFP_path, JSON.stringify(webGLFP))
+                fs.writeFileSync(dynamicConfig_path, adsEncodeBase64(JSON.stringify(dynamic)))
+                fs.writeFileSync(staticConfig_path, adsEncodeBase64(JSON.stringify(staticConfig)))
+
+                params = adsEncodeBase64(JSON.stringify({
+                    "UserId": "1",
+                    "CanvasMark": rAutoDigitInt("7949", config.fp).toString(),
+                    "DisableContainer": true,
+                    "WebGLFP": webGLFP_path,
+                    "AudioFp": staticConfig.AudioFp,
+                    "WebGLMark": staticConfig.WebGLMark,
+                    "StartTime": staticConfig.StartTime,
+                    "AllowScanPorts": config.scanPorts,
+                    "GeolocationSetting": staticConfig.GeolocationSetting,
+                    "FlashPluginSetting": staticConfig.FlashPluginSetting,
+                    "Platform": staticConfig.Platform,
+                    "ScreenSize": staticConfig.ScreenSize,
+                    "DisableBackgroundMode": staticConfig.DisableBackgroundMode,
+                    "DisableWebRTC": staticConfig.DisableWebRTC,
+                    "HardwareConcurrency": staticConfig.HardwareConcurrency,
+                    "DeviceMemory": staticConfig.DeviceMemory,
+                    "LoadExtensionErrorBox": staticConfig.LoadExtensionErrorBox,
+                    "ClientRectFp": staticConfig.ClientRectFp,
+                    "CanvasMarkEx": rAutoDigitInt("7949", config.fp).toString(),
+                    "WebGLMarkEx": rAutoDigitInt("5001", config.fp).toString(),
+                    "command_line": {
+                        "do-not-de-elevate": ""
+                    },
+                    "ProxyChain": [
+                        {
+                            "scheme": config.proxy.protocol,
+                            "host": config.proxy.host,
+                            "port": config.proxy.port,
+                            "account": config.proxy.username,
+                            "password": config.proxy.password
+                        }
+                    ],
+                    "ForceProcessExit": staticConfig.ForceProcessExit,
+                    "ProxyUser": staticConfig.ProxyUser,
+                    "ProxyPassword": staticConfig.ProxyPassword,
+                    "Langs": staticConfig.Langs,
+                    "AcceptLang": staticConfig.AcceptLang,
+                    "TimeZone": config.timezone,
+                    "Geoposition": config.geop,
+                    "DynamicConfig": dynamicConfig_path,
+                    "StaticConfig": staticConfig_path
+                }));
+                
+                fs.writeFileSync(params_path, params)
+                screenSize = staticConfig.ScreenSize;
+            }
+
+            const args = [
+                "--disable-background-networking",
+                "--disable-client-side-phishing-detection",
+                "--disable-default-apps",
+                "--disable-hang-monitor",
+                "--disable-popup-blocking",
+                "--disable-prompt-on-repost",
+                "--disable-sync",
+                "--metrics-recording-only",
+                "--no-first-run",
+                "--safebrowsing-disable-auto-update",
+                "--password-store=basic",
+                "--no-service-autorun",
+                "--disable-features=Translate,AcceptCHFrame,MediaRouter,OptimizationHints,ProcessPerSiteUpToMainFrameThreshold,IsolateSandboxedIframes",
+                "--force-color-profile=srgb",
+                "--use-mock-keychain",
+                "--export-tagged-pdf",
+                "--no-default-browser-check",
+                "--window-position=0,0",
+                "--disable-background-mode",
+                "--ash-host-window-bounds=" + screenSize,
+                "--window-size=" + screenSize,
+                "--disable-renderer-accessibility",
+                "--disable-legacy-window",
+                "--fake-variations-channel=stable",
+                "--variations-server-url=https://clientservices.googleapis.com/chrome-variations/seed",
+                "--component-updater=initial-delay=6e5",
+                "--lang=en-US",
+                "--enable-features=NetworkService,NetworkServiceInProcess,LoadCryptoTokenExtension,PermuteTLSExtensions",
+                "--enable-blink-features=IdleDetection,Fledge",
+                "--extended-parameters=" + params,
+                "--flag-switches-begin",
+                "--flag-switches-end",
+                "--load-extension=",
+                "--no-sandbox"
+            ];
+
+            return {
+                args,
+                startingUrl: "https://ipapi.co/json/"
+            }
+        }
+    });
+}

package/src/providers/base.ts

@@ -0,0 +1,68 @@
+import { makeUniqueBrowserConfig } from "../core/launcher";
+import portfinder from 'portfinder';
+import fs from "fs";
+import * as cl from "chrome-launcher";
+import { tryCatch, tryLoop } from "@tocha688/utils";
+import type { BrowserResult, BrowserStartOptions } from "../types";
+
+export interface BrowserLaunchConfig {
+    prepare: (userDataDir: string, devtoolsPort: number) => Promise<{
+        args: string[];
+        startingUrl?: string;
+        cleanup?: () => Promise<void>;
+    }>;
+}
+
+export async function launchBrowserBase(
+    opts: BrowserStartOptions,
+    config: BrowserLaunchConfig
+): Promise<BrowserResult> {
+    const { userDataDir } = makeUniqueBrowserConfig();
+    // Ensure userDataDir exists
+    fs.mkdirSync(userDataDir, { recursive: true });
+
+    let hookResult: Awaited<ReturnType<BrowserLaunchConfig['prepare']>> | undefined;
+    try {
+        const devtoolsPort = await portfinder.getPortPromise({ port: 41000, stopPort: 49999 });
+
+        hookResult = await config.prepare(userDataDir, devtoolsPort);
+
+        const args = [
+            `--user-data-dir=${userDataDir}`,
+            `--remote-debugging-port=${devtoolsPort}`,
+            `--remote-debugging-address=0.0.0.0`,
+            ...hookResult.args
+        ];
+
+        // Handle headless option if not already handled by provider
+        if (opts.headless !== false && !args.some(a => a.startsWith("--headless"))) {
+            args.push("--headless");
+        }
+
+        const brw = await cl.launch({
+            userDataDir,
+            port: devtoolsPort,
+            chromePath: opts.chromePath,
+            chromeFlags: args,
+            startingUrl: hookResult.startingUrl || "about:blank"
+        });
+
+        return {
+            userDataDir,
+            port: brw.port,
+            browser: brw,
+            close: async () => {
+                await tryCatch(async () => await brw.kill());
+                if (hookResult?.cleanup) {
+                    await tryCatch(hookResult.cleanup);
+                }
+                await tryLoop(async () => fs.rmSync(userDataDir, { recursive: true, force: true }));
+            }
+        };
+    } catch (e) {
+        // cleanup immediately if launch fails
+        await tryLoop(async () => fs.rmSync(userDataDir, { recursive: true, force: true }));
+        if (hookResult?.cleanup) await tryCatch(hookResult.cleanup);
+        throw e;
+    }
+}

package/src/providers/local.ts

@@ -0,0 +1,31 @@
+import type { BrowserStartOptions, BrowserResult } from "../types";
+import * as cl from "chrome-launcher";
+
+export async function startLocalBrowser(opts: BrowserStartOptions): Promise<BrowserResult> {
+    const { chromePath, headless = false, proxy, userDataDir } = opts;
+    
+    const chromeFlags = [
+        "--disable-blink-features=AutomationControlled",
+        "--no-sandbox",
+        "--disable-setuid-sandbox",
+    ];
+
+    if (headless) {
+        chromeFlags.push("--headless");
+    }
+
+    // Proxy handling would go here if needed, but usually handled by Playwright context or upstream
+
+    const browser = await cl.launch({
+        chromePath,
+        chromeFlags,
+        userDataDir,
+    });
+
+    return {
+        userDataDir: userDataDir || "",
+        port: browser.port,
+        browser: browser,
+        close: async () => await browser.kill(),
+    };
+}

package/src/providers/ok.ts

@@ -0,0 +1,96 @@
+import { faker } from "@faker-js/faker";
+import type { BrowserResult, BrowserStartOptions } from "../types";
+import { startProxyServer, type ProxyServerResult } from "@tocha688/utils";
+import { launchBrowserBase } from "./base";
+import fs from "node:fs";
+import path from "node:path";
+
+export async function OKBrowserStartMain(opts: BrowserStartOptions): Promise<BrowserResult> {
+    return launchBrowserBase(opts, {
+        prepare: async (userDataDir, devtoolsPort) => {
+            let proxy: ProxyServerResult | undefined;
+            if (opts.proxy) {
+                proxy = await startProxyServer(opts.proxy);
+                console.log(`Started proxy server on port ${proxy.port}`);
+            }
+
+            const fingerprintPath = path.join(userDataDir, "fingerprint.config");
+            let fingerprint: string;
+
+            if (fs.existsSync(fingerprintPath)) {
+                fingerprint = fs.readFileSync(fingerprintPath, "utf-8");
+            } else {
+                fingerprint = faker.number.int({ min: 10000000, max: 99999999 }).toString();
+                fs.writeFileSync(fingerprintPath, fingerprint);
+            }
+
+            const args = [
+                "--allow-pre-commit-input",
+                "--disable-background-networking",
+                "--disable-background-timer-throttling",
+                "--disable-backgrounding-occluded-windows",
+                "--disable-breakpad",
+                "--disable-client-side-phishing-detection",
+                "--disable-component-extensions-with-background-pages",
+                "--disable-crash-reporter",
+                "--disable-default-apps",
+                "--disable-dev-shm-usage",
+                "--disable-hang-monitor",
+                "--disable-infobars",
+                "--disable-ipc-flooding-protection",
+                "--disable-popup-blocking",
+                "--disable-prompt-on-repost",
+                "--disable-renderer-backgrounding",
+                "--disable-search-engine-choice-screen",
+                "--disable-sync",
+                "--export-tagged-pdf",
+                "--force-color-profile=srgb",
+                "--generate-pdf-document-outline",
+                "--metrics-recording-only",
+                "--no-first-run",
+                "--password-store=basic",
+                "--use-mock-keychain",
+                "--disable-features=Translate,AcceptCHFrame,MediaRouter,OptimizationHints,ProcessPerSiteUpToMainFrameThreshold,IsolateSandboxedIframes",
+                "--enable-features=PdfOopif",
+                // "--user-data-dir=" + userDataDir, // Handled by base
+                // "about:blank",
+                // "http://127.0.0.1:4252/index.html?id=1977283458602381314",
+                // "--fingerprints=37553310",
+                "--fingerprints=" + fingerprint,
+                "--window-size=1280,720",
+                "--window-position=0,0",
+                "--no-sandbox",
+                // "--disable-blink-features=AutomationControlled",
+                "--ignore-certificate-errors",
+                "--notice-number=1",
+                // "--notice-number=4",
+                // "--load-extension=",
+                // "--remote-debugging-port=" + devtoolsPort, // Handled by base
+                // "--remote-debugging-address=0.0.0.0", // Handled by base
+                // "--enable-password-manager",
+                "--ignores=tls",
+                "--enable-logging",
+                // "--proxy-server=http://127.0.0.1:" + proxy.port,
+                "--timezone=" + (proxy?.ipinfo?.timezone ?? "America/Los_Angeles"),
+                "--lang=en-US",
+                // "--headless", // Handled by base
+            ];
+
+            if (proxy && proxy.port) {
+                args.push(`--proxy-server=http://127.0.0.1:${proxy.port}`);
+            }
+
+            return {
+                args,
+                startingUrl: "https://ipapi.co/json/",
+                cleanup: async () => {
+                    if (proxy) await proxy.server.close(true);
+                }
+            };
+        }
+    });
+}
+
+export async function OKBrowserCreate(opts: BrowserStartOptions) {
+    return OKBrowserStartMain(opts);
+}

package/src/types/index.ts

@@ -0,0 +1,21 @@
+import type { ProxyFormatInfo } from "@tocha688/utils/ip";
+import * as cl from "chrome-launcher"
+import * as ProxyChain from "proxy-chain";
+
+// 使用方式
+export type BrowserStartOptions = {
+    proxy?: string,
+    headless?: boolean,
+    chromePath: string,
+    userDataDir?: string;
+}
+export type BrowserResult = {
+    userDataDir: string,
+    port: number,
+    browser: cl.LaunchedChrome,
+    close: Function,
+}
+
+export type StartBrowserFn = (opts: BrowserStartOptions) => Promise<BrowserResult>;
+
+export type ProxyServerResult = { port: number, server: ProxyChain.Server, ipinfo: any }

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}

package/tsup.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['cjs', 'esm'],
+  clean: true,
+  minify: true,
+  shims: true,
+  dts: true,
+  splitting: false,
+  sourcemap: false,
+  platform: 'node',
+  target: 'esnext',
+});