Introduction

GeekEZ Browser is a specialized anti-detect browser built on Electron and Puppeteer, with Xray-core integrated at the core. It is designed to solve multi-account association problems for cross-border e-commerce (TikTok, Amazon, Facebook, Shopee, etc.) by implementing deep system-level fingerprint spoofing.

Advanced Features

Hardware Randomization

  • Random CPU Cores (4/8/12/16)
  • Random Memory (4/8/16 GB)
  • This ensures every profile looks like a unique physical device.

WebRTC & IP Leak Protection

Forces disable_non_proxied_udp policy to physically block local IP leaks via WebRTC, ensuring only your proxy IP is visible.

Xray Network Engine

Fully supports VLESS, VMess, Trojan, Shadowsocks (including SS-2022).

Chain Proxy Architecture

[Local] -> [Pre-Proxy] -> [Profile Proxy] -> [Target]

This architecture hides your real IP from the final proxy provider, adding an extra layer of anonymity.

Installation

Please verify your system requirements before installation.

macOS Notice

If you see "App is damaged", run this command in Terminal:

sudo xattr -rd com.apple.quarantine /Applications/GeekEZ\ Browser.app

使用说明

1) 快速开始

  1. 打开软件，点击 新建环境 按钮。
  2. 填入订阅链接（或单条代理链接）。
  3. 点击 生成并保存，即可创建环境。

2) 高级功能说明

  • 前置代理：可使用 xray 节点或订阅链接。若环境代理可直连目标网站，可不启用该功能。
  • 扩展插件：在 设置 → 扩展管理 中添加“已解压”的插件文件夹。
  • 远程调试：用于对环境开放调试端口，便于 Puppeteer / DevTools 连接。
  • UA 及 WebGL 修改：用于定制指纹参数做测试或兼容性调试，不保证绕过风控检测。
  • 自定义启动参数：为单个环境附加 Chrome 启动参数（如窗口、性能、实验特性等）。
  • API 服务：在高级设置中启用后，可通过本地 REST API 自动化管理环境。

代理链接写法

所有协议均支持 xray 核心标准格式（VMess / VLESS / Trojan / Shadowsocks 等）。

以下是 HTTP 与 SOCKS 的常用写法示例：

HTTP / HTTPS 代理

# 带账号密码
http://user:pass@1.2.3.4:8080

# 无账号密码
http://1.2.3.4:8080

# HTTPS 形式（按 HTTP 代理处理）
https://1.2.3.4:8080

SOCKS 代理

# 标准写法（带账号密码）
socks://user:pass@1.2.3.4:1080

# 无密码（仅用户名）
socks5://user@1.2.3.4:1080

# 无认证
socks5://1.2.3.4:1080

# v2rayN 风格（base64(user:pass)）
socks://dXNlcjpwYXNz@1.2.3.4:1080#remark

# 纯文本简写（系统按 SOCKS 处理）
1.2.3.4:1080
1.2.3.4:1080:user:pass

直连模式（不走代理）

Direct

当代理链接填入 Direct 时，环境启动不会拉起 xray 内核，将直接使用本地网络连接。

FAQ

Q: Why is TikTok/Facebook still flagging my account?

A: Fingerprint isolation only protects device identity. You MUST use a high-quality Clean/Dedicated IP. Shared IPs are easily detected.

Q: White screen on startup?

A: Try setting Timezone to "Auto" in settings. Some sites (like Oracle) require precise time synchronization.

API 文档

GeekEZ Browser REST API 仅监听本地地址 127.0.0.1。请在 设置 → 高级设置 → API 服务 中启用。

通用说明

  • 所有 :idOrName 参数均支持环境 ID（UUID）或环境名称。
  • 列表接口支持按标签精确筛选：GET /api/profiles?tag=标签名。
  • 若开启“远程调试”，创建/更新返回中会包含 remoteDebugPort。

创建环境（Create Profile）说明

POST /api/profiles 支持完整参数输入。

必须参数：name、proxyStr。

其余参数：不填时将自动按默认策略/随机策略生成。

curl -X POST http://localhost:12138/api/profiles \
  -H "Content-Type: application/json" \
  -d '{
    "name": "US-TikTok-01",
    "proxyStr": "socks5://1.2.3.4:1080"
  }'

接口与示例

1) 查询运行状态 GET /api/status

curl http://localhost:12138/api/status

2) 查询环境列表 GET /api/profiles

curl http://localhost:12138/api/profiles

3) 按标签筛选环境 GET /api/profiles?tag=tiktok

curl "http://localhost:12138/api/profiles?tag=tiktok"

4) 查询单个环境详情 GET /api/profiles/:idOrName

curl http://localhost:12138/api/profiles/US-TikTok-01

5) 创建环境（完整参数示例） POST /api/profiles

curl -X POST http://localhost:12138/api/profiles \
  -H "Content-Type: application/json" \
  -d '{
    "name": "US-TikTok-02",
    "proxyStr": "http://user:pass@1.2.3.4:8080",
    "tags": ["tiktok", "us"],
    "preProxyOverride": "default",
    "timezone": "America/New_York",
    "language": "en-US",
    "screen": { "width": 1920, "height": 1080 },
    "uaMode": "spoof",
    "browserType": "chrome",
    "browserMajorVersion": 136,
    "webglProfile": "win_nvidia_1650"
  }'

6) 更新环境 PUT /api/profiles/:idOrName

curl -X PUT http://localhost:12138/api/profiles/US-TikTok-01 \
  -H "Content-Type: application/json" \
  -d '{
    "tags": ["tiktok", "us", "shop"],
    "language": "en-US"
  }'

7) 删除环境 DELETE /api/profiles/:idOrName

curl -X DELETE http://localhost:12138/api/profiles/US-TikTok-01

8) 启动环境 GET /api/open/:idOrName

curl http://localhost:12138/api/open/US-TikTok-01

9) 停止环境 POST /api/profiles/:idOrName/stop

curl -X POST http://localhost:12138/api/profiles/US-TikTok-01/stop

10) 导出加密完整备份 GET /api/export/all?password=你的密码

curl "http://localhost:12138/api/export/all?password=123456"

11) 导出指纹 YAML GET /api/export/fingerprint

curl http://localhost:12138/api/export/fingerprint

12) 导入（YAML 或加密备份） POST /api/import

curl -X POST http://localhost:12138/api/import \
  -H "Content-Type: application/json" \
  -d '{
    "content": "这里填 YAML 文本或加密备份的 Base64 内容",
    "password": "加密备份时需要，YAML 可不填"
  }'