MCPcopy Index your code
hub / github.com/EchoHS/GeekezBrowser

github.com/EchoHS/GeekezBrowser @v1.6.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.6.1 ↗ · + Follow
383 symbols 810 edges 27 files 36 documented · 9%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

GeekEZ Browser

GeekEZ Logo

License: CC BY-NC-SA 4.0 Platform

A fingerprint stealth browser built for e-commerce operations and multi-account management

🇨🇳 中文说明 (Chinese) | 📥 Download Releases


📖 Introduction

GeekEZ Browser is a fingerprint browser with integrated Xray proxy support.

It is designed to solve multi-account association issues in cross-border e-commerce (TikTok, Amazon, Facebook, Shopee, etc.). Through deep spoofing, it can pass high-intensity checks from Cloudflare, Pixelscan, and BrowserScan.

📸 Screenshots

Main Interface 1 Main Interface 2

✨ Core Features

🛡️ Deep Fingerprint Isolation

  • Hardware Randomization: Randomly generates CPU core count (4/8/12/16) and device memory (4/8/16 GB), significantly increasing fingerprint uniqueness so every environment is unique.
  • Timezone & Geolocation Spoofing:
    • Auto mode: Automatically matches timezone and coordinates to the proxy IP location.
    • Supports manual selection from 50+ global cities for precise positioning.
  • Language Spoofing:
    • Supports 60+ languages covering major regions worldwide.
    • Fully modifies browser language, HTTP headers, and Internationalization API behavior.
  • WebRTC Physical Blocking: Enforces disable_non_proxied_udp policy to physically block local IP leak paths.
  • UA & WebGL Modification: Supports browser version and WebGL modification. (Note: bypassing detection is not guaranteed yet.)

🔗 Full-Power Network Engine (Xray-core)

  • Full Protocol Support: VMess, VLESS, Trojan, Shadowsocks (including SS-2022), Socks5, HTTP.
  • Advanced Transports: Supports complex transport configurations including REALITY, XHTTP, gRPC, mKCP, WebSocket, and H2.
  • Pre-Proxy (Proxy Chain): Supports [Local] -> [Pre-Proxy] -> [Profile Proxy] -> [Target Website] architecture to hide real IP.
  • Dual-Stack Support: Smart routing strategy with full IPv4/IPv6 dual-stack support.

🧩 Workflow & Management

  • Extension Support: Supports installing Chrome extensions (e.g., MetaMask, AdBlock) and customizing which environments they apply to.
  • Tag System: Add custom tags (e.g., "TikTok", "US", "Main") for grouped management.
  • Safe Labeling: Uses dynamic watermark to display environment names at the top of pages (e.g., Profile-1).
  • Stable Multi-Instance: Supports running multiple environments simultaneously with fully isolated ports and processes.
  • Remote Debugging Port (Advanced): Optional external Puppeteer/DevTools connection for automation (disabled by default for lower risk).

🚀 Quick Start

Method 1: Download Installer (Recommended)

Go to the Releases page and download the package for your platform: * Windows: GeekEZ Browser-{version}-win-x64.exe * macOS (ARM64): GeekEZ Browser-{version}-mac-arm64.dmg * macOS (Intel): GeekEZ Browser-{version}-mac-x64.dmg * Linux: GeekEZ Browser-{version}-linux-x64.AppImage

Method 2: Run from Source

Prerequisites: Node.js (v16+) and Git.

  1. Clone the repository bash git clone https://github.com/EchoHS/GeekezBrowser.git cd GeekezBrowser

  2. Install dependencies bash npm install

  3. Start the app bash npm run dev

🛠 Platform Compatibility Guide

Platform Safety Rating Notes
TikTok ✅ Safe Canvas noise effectively prevents device association. The key is using a dedicated IP.
Facebook ✅ Safe WebDriver and automation signatures are removed. Avoid high-frequency automation behavior.
Shopee ✅ Safe Stable fingerprint behavior, suitable for seller backend operations. Recommended one account per environment.
Amazon (Buyer) ✅ Safe Isolation level is sufficient for buyer/reviewer risk control scenarios.
Amazon (Seller) ✅ Safe TLS fingerprint is safe. Usable for seller main accounts when using a dedicated IP and fixed environment.

📦 Build & Package

If you want to build installers yourself:

# Windows
npm run build:win

# macOS
npm run build:mac

# Linux
npm run build:linux

🔍 Detection Status

  • Browserscan: All checks passed
  • Pixelscan: All checks passed
  • Cloudflare: Bot checks passed

❓ FAQ

macOS shows "App is damaged" or "Cannot be opened"

Solution: 1. Drag GeekEZ Browser into Applications. 2. Open Terminal and run the following command (password may be required): bash sudo xattr -rd com.apple.quarantine /Applications/GeekEZ\ Browser.app 3. Re-open the app.

Click for detailed documentation

⚠️ Disclaimer

This software is for technical research and educational purposes only. The developers are not responsible for account bans, legal risks, or economic losses caused by using this software. Please strictly comply with platform rules and local laws/regulations.

📝 License

This project is licensed under CC BY-NC-SA 4.0.

💬 Community

QQ Group: 1079216892

Star History

Star History Chart

Core symbols most depended-on inside this repo

makeOption
called by 60
src/renderer/src/utils/fingerprintOptions.js
firstDefined
called by 39
src/main/index.js
updateLaunchProgress
called by 16
src/main/index.js
sendProgress
called by 15
src/main/index.js
refreshTrayMenu
called by 13
src/main/index.js
asNumber
called by 12
src/main/fingerprint.js
hasOwn
called by 11
src/main/index.js
joinPath
called by 11
src/main/chromium-path.js

Shape

Function 383

Languages

TypeScript100%

Modules by API surface

src/main/index.js179 symbols
src/renderer/src/services/setting.service.js26 symbols
src/main/fingerprint.js26 symbols
src/renderer/src/store/useUIStore.js21 symbols
src/main/chromium-path.js16 symbols
src/renderer/src/store/useSettingsStore.js15 symbols
src/renderer/src/store/useProxyStore.js15 symbols
src/renderer/src/store/useProfileStore.js14 symbols
src/renderer/src/services/profile.service.js14 symbols
src/renderer/src/utils/helpers.js11 symbols
setup.js9 symbols
src/renderer/src/services/ipc.service.js8 symbols

For agents

$ claude mcp add GeekezBrowser \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page