Mirage-Browser

---

简体中文

幻境浏览器（Mirage Browser）是一款基于 Electron 的指纹浏览器管理工具。
它能在同一台机器上同时启动多个完全隔离的 Chrome 实例，每个实例拥有独立的用户数据、自定义浏览器指纹和独立的代理出口，专为多账号运营、隐私保护和自动化场景设计。

界面采用经典 Windows XP 复古风格（XP.css）。

---

💾 为什么选 Windows XP 主题？

那是一个拨号上网还要抢时间的年代。

第一次坐在那台方正台式机前，屏幕上亮起了熟悉的蓝绿色桌面——那朵白云、那片绿草，Windows XP 默认壁纸《Bliss》。就是那一刻，我的计算机世界的大门悄悄打开了。

后来，我开始学习「黑客技术」——那时候还不懂什么是渗透测试，只是痴迷于各种批处理脚本、网络扫描工具，以及 BBS 论坛上流传的各种神秘命令。每一次打开 cmd.exe，每一次看到光标在黑色窗口里闪烁，都觉得自己离某种更深的秘密近了一步。

那个年代没有云计算，没有容器，没有指纹浏览器。只有 XP、只有 IE 6、只有 ipconfig /all 和一腔热血。

多年之后，我写了这个工具，专门用来管理浏览器指纹、隔离多个数字身份——这恰恰是当年那个在 XP 前痴迷折腾的少年，梦想中的「黑客工具」。

于是，我把那个开启一切的操作系统界面，作为这个工具永久的外衣。
不是因为怀旧，而是一种致敬——
致那扇打开计算机世界的蓝绿色大门。

---

自定义浏览器指纹信息

浏览器指纹检测

---

✨ 功能特性

🪟 多环境隔离管理

• 一键创建、启动、关闭任意数量的独立 Chrome 环境
• 每个环境拥有完全独立的 Profile 目录，Cookie、缓存、存储互不干扰
• 支持批量创建（最多 100 个），自动生成随机指纹配置
• 可为每个环境单独设置主页、备注

🎭 浏览器指纹伪造

通过 Chrome DevTools Protocol (CDP) 在每个环境启动时注入指纹覆盖脚本：

指纹维度	支持项
地区	时区、语言（navigator.language）、地理坐标（Geolocation API）
硬件	逻辑处理器数、设备内存、屏幕分辨率、色深、刷新率、像素比
平台	navigator.platform、navigator.userAgent、CPU 架构
渲染	Canvas 2D 噪声种子、WebGL 渲染参数噪声、GPU Vendor / Renderer
设备	触控点数、电池电量/充电状态、网络连接类型

支持随机生成或手动指定每项参数，内置 16 个城市地理坐标预设。

🌐 代理集成

• 直连代理：为每个环境独立指定 HTTP/SOCKS 代理地址，可精准对接 Burp Suite、mitmproxy 等抓包工具，实现对特定环境的流量拦截与分析，满足渗透测试全流程需求
• Mihomo 订阅代理：
  • 内置 Mihomo（原 Clash Meta）内核下载与管理
  • 支持导入订阅链接或本地 YAML 配置文件
  • 节点延迟测试（TCP Ping），按延迟排序筛选
  • 每个环境可绑定不同的订阅源和节点

💉 脚本注入

• 编写自定义 JavaScript，通过 CDP 注入到指定运行中的环境
• 支持多个脚本管理，可随时切换并执行

🔐 证书管理

• 导入 CA 证书（.pem / .crt / .cer）到操作系统信任存储
• 支持 macOS Keychain、Windows 证书存储、Linux NSS 数据库
• 自动提取证书指纹（SHA-256/SHA-1）用于验证

---

📦 安装

下载预构建包

前往 Releases 页面，下载对应平台的安装包：

平台	便携包（解压即用）	安装包
macOS	.zip	—
Windows	.zip	.exe（Squirrel 安装包）
Linux	.zip	.deb / .rpm

前置要求

• Google Chrome 或 Chromium 浏览器（需已安装）
• macOS 10.15+ / Windows 10+ / Ubuntu 20.04+

---

🚀 快速上手

1. 启动应用，在「设置」页面确认 Chrome 路径已自动检测
2. 前往「环境」页面，点击「新建环境」创建一个浏览器实例
3. 配置指纹参数（或使用随机生成）、选择代理节点
4. 点击「启动」，即可打开一个带有自定义指纹的 Chrome 实例
5. 如需代理，在「代理」页面添加订阅链接，测试节点延迟后绑定到对应环境

---

🛠️ 开发

环境准备

# 需要 Node.js 18+
node -v

# 克隆仓库
git clone https://github.com/taills/Mirage-Browser.git
cd Mirage-Browser

# 安装依赖
npm install

开发模式（含热更新）

npm start

构建 & 打包

npm run make        # 构建当前平台安装包，输出到 out/make/
npm run package     # 仅打包（不生成安装包）

发布多平台包

推送 v* 格式 tag，GitHub Actions 自动在 macOS / Windows / Linux 三端并行构建并发布到 Releases：

git tag v1.0.0
git push origin v1.0.0

---

🏗️ 技术栈

层	技术
框架	Electron 42 + Vite 5
语言	TypeScript
UI	XP.css（Windows XP 复古风格）
浏览器控制	Chrome DevTools Protocol (CDP) via WebSocket
代理内核	Mihomo（原 Clash Meta）
构建 & 发布	Electron Forge + GitHub Actions

---

🔗 相关参考

• 指纹检测工具：browseris.com · passer-by.com/browser · github.com/mumuy/browser
• Mihomo 文档
• Chrome DevTools Protocol

---

📄 授权协议

MIT © 2024 taills

---

繁體中文

幻境瀏覽器（Mirage Browser）是一款基於 Electron 的指紋瀏覽器管理工具。
它能在同一台機器上同時啟動多個完全隔離的 Chrome 實例，每個實例擁有獨立的使用者資料、自訂瀏覽器指紋和獨立的代理出口，專為多帳號運營、隱私保護和自動化場景設計。

介面採用經典 Windows XP 復古風格（XP.css）。

---

💾 為什麼選擇 Windows XP 主題？

那是一個撥號上網還要搶時間的年代。

第一次坐在那台方正桌機前，螢幕亮起了熟悉的藍綠色桌面——那朵白雲、那片綠草，Windows XP 預設桌布《Bliss》。就是那一刻，我的電腦世界的大門悄悄開啟了。

後來，我開始學習「駭客技術」——那時還不懂什麼是滲透測試，只是著迷於各種批次腳本、網路掃描工具，以及 BBS 論壇上流傳的各種神秘指令。每一次打開 cmd.exe，每一次看到游標在黑色視窗裡閃爍，都覺得自己離某種更深的秘密又近了一步。

那個年代沒有雲端運算，沒有容器，沒有指紋瀏覽器。只有 XP、只有 IE 6、只有 ipconfig /all 和滿腔熱血。

多年之後，我寫了這個工具，專門用來管理瀏覽器指紋、隔離多個數位身份——這恰恰是當年那個在 XP 前著迷折騰的少年，夢想中的「駭客工具」。

於是，我把那個開啟一切的作業系統介面，作為這個工具永久的外衣。
不是因為懷舊，而是一種致敬——
致那扇開啟電腦世界的藍綠色大門。

---

✨ 功能特性

🪟 多環境隔離管理

• 一鍵建立、啟動、關閉任意數量的獨立 Chrome 環境
• 每個環境擁有完全獨立的 Profile 目錄，Cookie、快取、儲存互不干擾
• 支援批次建立（最多 100 個），自動產生隨機指紋配置
• 可為每個環境單獨設定首頁、備註

🎭 瀏覽器指紋偽造

透過 Chrome DevTools Protocol (CDP) 在每個環境啟動時注入指紋覆寫腳本：

指紋維度	支援項目
地區	時區、語言（navigator.language）、地理坐標（Geolocation API）
硬體	邏輯處理器數、裝置記憶體、螢幕解析度、色深、更新率、像素比
平台	navigator.platform、navigator.userAgent、CPU 架構
渲染	Canvas 2D 雜訊種子、WebGL 渲染參數雜訊、GPU Vendor / Renderer
裝置	觸控點數、電池電量/充電狀態、網路連線類型

支援隨機產生或手動指定每項參數，內建 16 個城市地理坐標預設。

🌐 代理整合

• 直連代理：為每個環境獨立指定 HTTP/SOCKS 代理位址，可精準對接 Burp Suite、mitmproxy 等攔截工具，對特定環境進行流量截持與分析，滿足滲透測試全流程需求
• Mihomo 訂閱代理：
  • 內建 Mihomo（原 Clash Meta）核心下載與管理
  • 支援匯入訂閱連結或本地 YAML 設定檔
  • 節點延遲測試（TCP Ping），依延遲排序篩選
  • 每個環境可綁定不同的訂閱來源和節點

💉 腳本注入

• 撰寫自訂 JavaScript，透過 CDP 注入至指定執行中的環境
• 支援多個腳本管理，可隨時切換並執行

🔐 憑證管理

• 匯入 CA 憑證（.pem / .crt / .cer）至作業系統信任存放區
• 支援 macOS Keychain、Windows 憑證存放區、Linux NSS 資料庫
• 自動提取憑證指紋（SHA-256/SHA-1）用於驗證

---

📦 安裝

下載預建套件

前往 Releases 頁面，下載對應平台的安裝包：

平台	便攜包（解壓即用）	安裝包
macOS	.zip	—
Windows	.zip	.exe（Squirrel 安裝包）
Linux	.zip	.deb / .rpm

前置要求

• Google Chrome 或 Chromium 瀏覽器（需已安裝）
• macOS 10.15+ / Windows 10+ / Ubuntu 20.04+

---

🚀 快速上手

1. 啟動應用程式，在「設定」頁面確認 Chrome 路徑已自動偵測
2. 前往「環境」頁面，點擊「新建環境」建立一個瀏覽器實例
3. 配置指紋參數（或使用隨機產生）、選擇代理節點
4. 點擊「啟動」，即可開啟一個帶有自訂指紋的 Chrome 實例
5. 如需代理，在「代理」頁面新增訂閱連結，測試節點延遲後綁定至對應環境

---

🛠️ 開發

環境準備

# 需要 Node.js 18+
node -v

# 複製倉庫
git clone https://github.com/taills/Mirage-Browser.git
cd Mirage-Browser

# 安裝相依套件
npm install

開發模式（含熱更新）

npm start

建置 & 打包

npm run make        # 建置當前平台安裝包，輸出至 out/make/
npm run package     # 僅打包（不產生安裝包）

發布多平台套件

推送 v* 格式 tag，GitHub Actions 自動在 macOS / Windows / Linux 三端並行建置並發布至 Releases：

git tag v1.0.0
git push origin v1.0.0

---

🏗️ 技術堆疊

層次	技術
框架	Electron 42 + Vite 5
語言	TypeScript
UI	XP.css（Windows XP 復古風格）
瀏覽器控制	Chrome DevTools Protocol (CDP) via WebSocket
代理核心	Mihomo（原 Clash Meta）
建置 & 發布	Electron Forge + GitHub Actions

---

🔗 相關參考

• 指紋檢測工具：browseris.com · passer-by.com/browser · github.com/mumuy/browser
• Mihomo 文件
• Chrome DevTools Protocol

---

📄 授權協議

MIT © 2024 taills

---

English

Mirage Browser is an Electron-based fingerprint browser manager.
It launches multiple fully isolated Chrome instances on a single machine — each with its own user data directory, spoofed browser fingerprint, and dedicated proxy — designed for multi-account management, privacy protection, and browser automation.

The UI uses the classic Windows XP retro style via XP.css.

---

💾 Why Windows XP?

It was the era when dial-up internet meant racing against the clock.

The first time I sat in front of that old desktop, the screen lit up with the unmistakable teal-green wallpaper — the fluffy clouds, the rolling green hills, that iconic photo called Bliss. That was the moment the door to my computing world quietly swung open.

I started learning “hacking” — though back then I had no idea what penetration testing meant. I was just obsessed with batch scripts, network scanners, and the mysterious commands circulating on bulletin boards. Every time I opened cmd.exe and watched the cursor blink in that black window, I felt one step closer to some deeper secret.

There was no cloud computing back then. No containers. No fingerprint browsers. Just XP, IE 6, ipconfig /all, and boundless curiosity.

Years later, I built this tool — for managing browser fingerprints, isolating multiple digital identities. It’s exactly the kind of “hacker tool” that teenage kid hunched over Windows XP once dreamed of.

So I dressed this project in the interface of the OS that started it all.
Not out of nostalgia, but as a tribute —
to the teal-green door that opened my computer world.

---

✨ Features

🪟 Multi-Environment Isolation

• Create, launch, and close any number of independent Chrome environments with a single click
• Each environment has a completely isolated Profile directory — cookies, cache, and storage never cross-contaminate
• Batch creation (up to 100 at once) with auto-generated random fingerprint configs
• Per-environment custom homepage and notes

🎭 Browser Fingerprint Spoofing

Fingerprint override scripts are injected via Chrome DevTools Protocol (CDP) at environment startup:

Dimension	Spoofed Properties
Region	Timezone, language (navigator.language), geolocation coordinates
Hardware	CPU logical cores, device memory, screen resolution, color depth, refresh rate, device pixel ratio
Platform	navigator.platform, navigator.userAgent, CPU architecture
Rendering	Canvas 2D noise seed, WebGL rendering noise, GPU Vendor / Renderer
Device	Max touch points, battery level / charging status, network effective type

Every parameter supports random generation or manual override, with 16 built-in city geolocation presets.

🌐 Proxy Integration

• Direct proxy: Assign a dedicated HTTP/SOCKS proxy per environment — seamlessly integrates with Burp Suite, mitmproxy, and other interception proxies for targeted traffic capture and analysis throughout the entire penetration testing workflow
• Mihomo subscription proxy:
  • Built-in Mihomo (formerly Clash Meta) core download and lifecycle management
  • Import subscription URLs or local YAML config files
  • TCP Ping latency test with latency-sorted node filtering
  • Each environment can be bound to a different subscription source and node

💉 Script Injection

• Write custom JavaScript and inject it into any running environment via CDP
• Manage multiple scripts and switch between them at any time

🔐 Certificate Management

• Import CA certificates (.pem / .crt / .cer) into the OS trust store
• Supports macOS Keychain, Windows Certificate Store, and Linux NSS database
• Automatically extracts SHA-256 / SHA-1 fingerprints for verification

---

📦 Installation

Download Pre-built Packages

Visit the Releases page and download the package for your platform:

Platform	Portable (no install needed)	Installer
macOS	.zip	—
Windows	.zip	.exe (Squirrel installer)
Linux	.zip	.deb / .rpm

Prerequisites

• Google Chrome or Chromium browser (must be installed separately)
• macOS 10.15+ / Windows 10+ / Ubuntu 20.04+

---

🚀 Quick Start

1. Launch the app — confirm Chrome path is auto-detected on the Settings page
2. Go to the Environments page and click New Environment
3. Configure fingerprint parameters (or use random generation) and select a proxy node
4. Click Launch — a Chrome instance with your custom fingerprint opens
5. For proxy support, add a subscription URL on the Proxy page, test node latency, then bind it to the environment

---

🛠️ Development

Prerequisites

# Requires Node.js 18+
node -v

# Clone the repository
git clone https://github.com/taills/Mirage-Browser.git
cd Mirage-Browser

# Install dependencies
npm install

Dev Mode (with hot reload)

npm start

Build & Package

npm run make        # Build installer for current platform → out/make/
npm run package     # Package only (no installer)

Release Multi-Platform Builds

Push a v* tag — GitHub Actions automatically builds and publishes for macOS / Windows / Linux in parallel:

git tag v1.0.0
git push origin v1.0.0

---

🏗️ Tech Stack

Layer	Technology
Framework	Electron 42 + Vite 5
Language	TypeScript
UI	XP.css (Windows XP retro style)
Browser Control	Chrome DevTools Protocol (CDP) over WebSocket
Proxy Core	Mihomo (formerly Clash Meta)
Build & Release	Electron Forge + GitHub Actions

---

🔗 References

• Fingerprint detection tools: browseris.com · passer-by.com/browser · github.com/mumuy/browser
• Mihomo Documentation
• Chrome DevTools Protocol

---

📄 License

MIT © 2024 taills