Content
<p align="center">
<img src="ui/crossguard.png" alt="CrossGuard Logo" width="120">
</p>
<h1 align="center">CrossGuard</h1>
<p align="center">
Chromium 138 based open-source fingerprint browser with multi-environment isolation and full-parameter fingerprint configuration
</p>
<p align="center">
<img src="https://img.shields.io/badge/Chromium-138-blue" alt="Chromium Version">
<img src="https://img.shields.io/badge/Version-2.2.40-brightgreen" alt="Version">
<img src="https://img.shields.io/badge/Platform-Windows-green" alt="Platform">
<img src="https://img.shields.io/badge/License-GPL-orange" alt="License">
<img src="https://img.shields.io/badge/MCP-AI%20Automation-purple" alt="MCP">
</p>
---
## Tool List
- **Multi-environment isolation** — Independent Cookie, history record, LocalStorage for each environment, no interference
- **Full-parameter fingerprint configuration** — Covering 25+ browser fingerprint dimensions, support custom/noise/follow IP modes
- **🤖 MCP AI Automation** — Built-in MCP service, let AI (Claude / any MCP client) remotely control browser in each fingerprint environment, 13 tools realize navigation/execute script/screenshot/Cookie/tab page full-process automation
- **Proxy support** — HTTP / HTTPS / SOCKS4 / SOCKS5, support username and password authentication
- **IP intelligent linkage** — Automatically set timezone, language, geographic location, and voice when proxy is enabled
- **WebRTC protection** — Automatically protect real IP from leakage when proxy is detected
- **DNS leak protection** — Built-in DNS leak protection, prevent DNS request leakage under proxy
- **Device fingerprint camouflage** — Hostname / MAC address / SSL-TLS handshake / hardware acceleration full-chain camouflage
- **UACH self-consistency** — Complete User-Agent Client Hints, platform version and UA always consistent, bypass modern fingerprint detection
- **Visual management** — Web UI manage all environments, one-click create/edit/launch
- **High fingerprint authenticity** — BrowserScan detect close to 100% authenticity (Canvas/WebGL no tampering traces)
- **Heavy website stability** — Deep adaptation to various heavy SPA websites, long-time running without crash
## Screenshots
### Environment Management
<img src="assets/img-001.png" alt="Environment Management" width="800">
### Fingerprint Configuration
<img src="assets/img-002.png" alt="Fingerprint Configuration" width="800">
### Environment Homepage
<img src="assets/img-003.png" alt="Environment Homepage" width="800">
### Fingerprint Detection (BrowserScan 97%)
<img src="assets/img-004.png" alt="Fingerprint Detection" width="800">
## Supported Fingerprint Parameters
| Category | Parameter | Mode |
|------|------|------|
| Basic Information | UserAgent | Default / Custom |
| Basic Information | UACH / Client Hints | Follow UA / Custom |
| Basic Information | Platform | Default / Custom |
| Basic Information | Language | Default / Local / IP-based |
| Basic Information | Timezone | Default / Custom / IP-based |
| Basic Information | Do Not Track | Default / Local / Custom |
| Network | Proxy | Direct / HTTP / HTTPS / SOCKS4 / SOCKS5 |
| Network | WebRTC | Off / Replace IP / Disable UDP / Public Interface Only |
| Network | Geolocation | Default / Local / IP-based |
| Network | DNS Leak Protection | On / Off |
| Network | SSL / TLS Fingerprint | Default / Custom |
| Hardware | Resolution | Default / Local |
| Hardware | CPU / Memory | Default / Local |
| Hardware | Media Devices | Default / Local |
| Hardware | Device Name / Hostname | Default / Custom |
| Hardware | MAC Address | Default / Noise / Custom |
| Hardware | Hardware Acceleration | On / Off |
| Rendering | Canvas | Default / Local / Noise |
| Rendering | WebGL | Default / Local / Noise |
| Rendering | GupGL | Default / Local / Noise |
| Rendering | ClientRects | Default / Local / Noise |
| Audio | AudioContext | Default / Local / Noise |
| Font | Font List | Default / Local / Noise |
| Speech | SpeechVoices | Default / Local / Noise / IP-based |
| Security | Port Protection | Default / Local |
## 🤖 MCP AI Automation
CrossGuard built-in MCP (Model Context Protocol) service, let AI client (Claude / Cursor / any MCP Host) **remotely control browser in each fingerprint environment**, realize end-to-end automation.
**13 tools**: Environment management (`list_environments` / `launch_environment` / `close_environment` / `list_running`) + Page automation (`navigate` / `evaluate_script` / `screenshot` / `get_cookies` / `set_cookies` / `list_tabs` / `new_tab` / `close_tab`).
Configure `.mcp.json` in AI client:
```json
{
"mcpServers": {
"crossguard": {
"url": "http://<machineIP>:18901/mcp",
"headers": { "Authorization": "Bearer <Token>" }
}
}
}
```
Token can be generated/reset in management interface 'MCP Service' card. Typical process: `list_environments → launch_environment(id) → navigate → evaluate_script → screenshot → close_environment`.
## Quick Start
### Requirements
- Windows 10/11 (64-bit)
- Python >= 3.10
- `pip install pycryptodome`
### Run
```bash
cd CrossGuardLauncher/
# Launch management interface + Chrome
python launcher.py
# Launch HTTP service only
python launcher.py --no-launch
# Specify chrome path and port
python launcher.py --chrome "path/to/chrome.exe" --port 18900
```
Access http://127.0.0.1:18900 to open management interface.
### Build
```bash
cd CrossGuardLauncher/
pip install pyinstaller
# Build exe + portable package
python build.py
# Generate installer (require Inno Setup 6)
ISCC.exe setup.iss
```
## Project Structure
```
CrossGuard/ # Chromium 138 patch files (override to chromium/src/)
├── chrome/ # Browser process patches
│ └── app/ # Launch entry, AES encryption/decryption, fingerprint JSON parsing
├── third_party/blink/ # Blink rendering engine patches (fingerprint injection core)
├── content/ # Font proxy, Mojo IPC
├── components/ # UA, language, permission patches
├── base/ # Fingerprint global singleton
├── cc/ # Command-line switch definition
├── net/ # Hostname, MAC address spoofing
├── ui/ # Resolution spoofing, Logo
└── assets/ # Screenshot resources
CrossGuardLauncher/ # Python launcher (independent directory)
├── launcher.py # HTTP service + Chrome environment management
├── config.html # Web management interface
├── build.py # Build script
└── docs/ # Development documents
```
See detailed documents in [`CrossGuardLauncher/docs/`](../CrossGuardLauncher/docs/):
- [Build Guide](../CrossGuardLauncher/docs/BUILD.md)
- [Architecture Description](../CrossGuardLauncher/docs/ARCHITECTURE.md)
- [Configuration Path Description](../CrossGuardLauncher/docs/CONFIG.md)
- [Development Guide](../CrossGuardLauncher/docs/DEVELOPMENT.md)
## Contact Us
QQ Group: 1035164839
<img src="assets/img-006.jpg" alt="Fingerprint Detection" width="800">
<img src="assets/img-005.png" alt="Fingerprint Detection" width="800">
> Please protect your privacy and security, and be cautious when providing personal information in public discussion groups.
---
**License**: GPL
Connection Info
You Might Also Like
No recommendations available