MyBrowser Pro 是一款基于 Go + Wails + Vue 3 开发的轻量级、深度反检测浏览器。它集成了 Camoufox 内核,通过 C++ 底层注入技术提供高强度的指纹保护,专为隐私保护、多账号管理及电商/社媒环境设计。
Desktop UI preview with redacted demo profiles and local-only storage controls.
- 深度指纹混淆与一致性配对:基于 Camoufox 内核,并结合真实 Telemetry 数据集提供指纹一致性配对池,杜绝 WebGL 显卡、分辨率和 Canvas 噪音的 Lie 统计学冲突。
- 隐藏 WebDriver 调试痕迹:通过偏好设置在启动时自动化覆写配置(如
dom.webdriver.enabled、marionette.enabled等),有效降低暴露调试接口后的指纹特征泄露。 - 物理级 Cookie 同步:支持“先启动登录、后一键同步”的闭环流程。通过提取物理
cookies.sqlite实现 Google/Facebook 账号免密登录。 - 全协议代理支持:支持 HTTP/HTTPS/SOCKS5 代理。开启 DNS 防泄漏,确保网络层面的彻底隔离。
- 本地存储隐私安全:默认将 Cookie 与环境配置存储在
%LOCALAPPDATA%\MyBrowser,绝不上传云端。若程序同目录存在portable.flag,则自动切换到便携模式并使用同目录下的MyBrowserData。首次启动公开版时,如检测到旧版data目录,会自动迁移并保留旧目录以便核对。 - 极致轻量:Go 语言后端实现,相比 Python 方案,控制层内存占用降低 80%+。
项目启动前需获取 Camoufox 运行环境:
- 运行
pip install camoufox - 运行
camoufox fetch - 或者将下载好的
camoufox-xxx-win.x86_64放置在项目根目录下。
# 开发模式
wails dev
# 编译为 .exe (单文件)
wails build- 当前仓库会保留
frontend/dist,因为桌面端入口会直接嵌入它用于打包。 - 修改
frontend/src、frontend/wailsjs或界面文案后,请先在frontend目录执行一次npm run build,再提交到仓库。 - 若
frontend/dist与源码不同步,公开仓库中的桌面构建结果可能不是最新界面。
- 默认安装模式:数据保存在
%LOCALAPPDATA%\MyBrowser,适合日常安装、升级和卸载,程序文件与用户数据分离。 - 便携模式:在程序同目录放置一个空文件
portable.flag后,应用会自动把数据切换到同目录下的MyBrowserData。 - 旧数据迁移:如果检测到旧版
data目录,而新目录还没有数据,程序会自动迁移,并保留旧目录供您确认。
- 删除程序本体不会自动删除数据目录。
- 若使用默认安装模式,数据通常位于
%LOCALAPPDATA%\MyBrowser。 - 若使用便携模式,数据位于程序同目录下的
MyBrowserData。 - 应用内的“清理浏览器注册”只会移除 MyBrowser 写入的注册表项,不会删除您的环境数据。
- 新建环境:填入名称,协议可选 SOCKS5 (默认 7891) 或 HTTP (默认 7890)。
- 连接测试:在设置中心点击“测试”验证代理是否通畅。
- 环境隔离:点击“🚀 启动环境”,在浏览器中完成账号登录。
- 状态保存:关闭浏览器后,点击“💾 同步 Cookie”保存登录状态。
- 指纹验证:点击“🔍”图标直达 Pixelscan 验证防关联强度。
- MyBrowser Pro 内置了本地开发者 API,可在
Automation侧边栏中查看实际监听地址、Bearer token、当前活动会话以及 BiDi 连接地址。 - API 只监听
127.0.0.1,默认启用 Bearer token 鉴权;普通“启动环境”不会暴露调试口,只有“自动化启动”才会创建 BiDi 会话。 - v1 首发只承诺 Firefox / Camoufox 的 WebDriver BiDi 接入,不承诺 Chromium CDP 或 Playwright
connect_over_cdp兼容。 - 日常简单操作可以直接在 Automation 面板里选环境、贴链接、一键打开;这条 UI 链路与下方 Python 示例走的是同一套 BiDi 导航流程。Python 示例则保留给批量、多步、联动脚本等高级场景。
GET /api/v1/automation/infoGET /api/v1/automation/profilesGET /api/v1/automation/sessionsPOST /api/v1/automation/sessionsGET /api/v1/automation/sessions/{session_id}DELETE /api/v1/automation/sessions/{session_id}POST /api/v1/automation/token/rotate
curl -X POST "http://127.0.0.1:9090/api/v1/automation/sessions" \
-H "Authorization: Bearer YOUR_LOCAL_API_TOKEN" \
-H "Content-Type: application/json" \
-d "{\"profile_id\":\"YOUR_PROFILE_ID\"}"先安装依赖:
pip install requests websocket-client官方示例会直接连接本地 connect_url,并使用 suppress_origin=True 规避 Firefox / Camoufox 对本地 WebSocket 握手的严格 Origin 校验;BiDi 是事件流协议,所以示例会按命令 id 循环等待真正的回执,而不是假设 recv() 的第一条就是响应。导航时固定使用 wait: "none",把 Cloudflare / ChatGPT 这类长时间验证页面交给 GUI 浏览器自己处理,避免脚本侧超时崩溃。
import json
import time
import requests
import websocket
BASE_URL = "http://127.0.0.1:9090"
TOKEN = "YOUR_LOCAL_API_TOKEN"
PROFILE_ID = "YOUR_PROFILE_ID"
TARGET_URL = "https://example.com/"
def send_bidi(ws, command_id, method, params=None, timeout=30.0):
payload = {
"id": command_id,
"method": method,
"params": params or {},
}
ws.send(json.dumps(payload))
deadline = time.time() + timeout
while time.time() < deadline:
remaining = max(0.1, deadline - time.time())
ws.settimeout(min(1.0, remaining))
raw_message = ws.recv()
message = json.loads(raw_message)
if "id" not in message:
continue
if message["id"] != command_id:
continue
if "error" in message:
raise RuntimeError(f"{method} failed: {message['error']}")
return message
raise TimeoutError(f"{method} timed out after {timeout} seconds")
headers = {
"Authorization": f"Bearer {TOKEN}",
"Content-Type": "application/json",
}
resp = requests.post(
f"{BASE_URL}/api/v1/automation/sessions",
headers=headers,
json={"profile_id": PROFILE_ID},
timeout=15,
)
resp.raise_for_status()
session = resp.json()["data"]
connect_url = session["connect_url"]
ws = websocket.create_connection(
connect_url,
timeout=30,
suppress_origin=True,
)
command_id = 1
try:
try:
send_bidi(
ws,
command_id,
"session.new",
{"capabilities": {"alwaysMatch": {}}},
)
except RuntimeError as err:
print(f"session.new returned a compatibility warning: {err}")
command_id += 1
tree = send_bidi(ws, command_id, "browsingContext.getTree")
contexts = tree["result"].get("contexts", [])
if not contexts:
raise RuntimeError("No browsing context returned by browsingContext.getTree")
context_id = contexts[0]["context"]
command_id += 1
navigation = send_bidi(
ws,
command_id,
"browsingContext.navigate",
{
"context": context_id,
"url": TARGET_URL,
"wait": "none",
},
)
print("Navigate dispatched:", navigation)
finally:
ws.close()MyBrowser Pro 提供了开箱即用的行为拟真算法以及无人值守的自动化测试套件:
- 拟真控制示例:在 examples/bidi_stealth.py 中,展示了通过 BiDi 执行二阶贝塞尔曲线鼠标平滑滑动、模拟物理持载时间点击以及变频延迟打字的交互方式。
- 防检测自动检测套件:在 scripts/verify_stealth.py 中,提供了一键式自动化审计脚本,可无人值守完成
navigator.webdriver隐藏检测、WebGL/Canvas 扰动校验,并能在对照模式下进行在线 reCAPTCHA 自动跑分。运行命令如下:# 1. 离线指纹与调试端口暴露审计 python scripts/verify_stealth.py --token YOUR_TOKEN --profile-id YOUR_PROFILE_ID # 2. 包含在线 CreepJS Lies 检测及 reCAPTCHA 自动跑分的交叉对照评测 python scripts/verify_stealth.py --token YOUR_TOKEN --profile-id YOUR_PROFILE_ID --online
- 日常维护与发版前,默认执行这组校验命令:
go test ./...cd frontend && npm run buildwails build -clean -f
- 默认 Windows 构建产物位于
build/bin/my-browser.exe - 桌面流程的手动检查项整理在: docs/SMOKE_CHECKLIST.md
- 仓库现在包含 GitHub Actions 工作流: windows-release.yml
- 当推送形如
v*的 tag 时,GitHub 会自动:- 在 Windows Runner 上执行
wails build -clean -f - 产出
my-browser.exe - 组装便携包 zip,内容包含
my-browser.exe、portable.flag、README-QuickStart.txt - 将产物上传到对应 GitHub Release
- 在 Windows Runner 上执行
- 也可以手动通过
workflow_dispatch触发,先验证构建链路是否正常。
本项目为纯本地开源工具。除非您手动配置了外部代理,否则所有流量和环境数据仅驻留在您的设备上。
MIT License
