Virtual Browser

https://virtualbrowser.cc/zh/guide/
Admin
Virtual Browser is a free and open-source fingerprint browser that provides comprehensive...
Tokens:26,908
Snippets:351
Trust Score:6.5
Update:3 months ago
Show doc for...
Tokens:
Raw
### Start CLI Service (Windows)

Source: https://virtualbrowser.cc/zh/guide/cli-mode.html

Launches the Virtual Browser CLI service in the background on Windows.

```bash
VirtualBrowser.exe --cli
```

--------------------------------

### Start CLI Service (macOS)

Source: https://virtualbrowser.cc/zh/guide/cli-mode.html

Launches the Virtual Browser CLI service in the background on macOS.

```bash
"/Applications/Virtual Browser.app/Contents/MacOS/Virtual Browser" --cli
```

--------------------------------

### Environment Naming Convention Example

Source: https://virtualbrowser.cc/zh/guide/best-practices.html

Follow this naming convention for organizing browser environments for different accounts and platforms.

```text
[平台]-[账号类型]-[用途]-[序号]
例如：
- Amazon-Seller-Main-001
- Facebook-Ads-001
- TikTok-Creator-001
- Shopify-Store-001
```

--------------------------------

### Virtual Browser Configuration Example

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

This JSON snippet shows the expected configuration for browser executables, user data directories, and temporary directories. Ensure these paths are correct and accessible.

```json
{
  "browser": {
    "executablePath": "C:\\Program Files\\VirtualBrowser\\chrome.exe",
    "userDataDir": "C:\\Users\\%USERNAME%\\AppData\\Local\\VirtualBrowser\\UserData",
    "tempDir": "C:\\Users\\%USERNAME%\\AppData\\Local\\VirtualBrowser\\Temp"
  }
}
```

--------------------------------

### Account Grouping by Platform Example

Source: https://virtualbrowser.cc/zh/guide/best-practices.html

Organize accounts by platform for better management, with sub-groupings for account types.

```text
电商平台
├── Amazon
│   ├── 卖家账号
│   ├── 买家账号
│   └── 广告账号
├── eBay
│   ├── 卖家账号
│   └── 买家账号
└── Shopify
    ├── 店铺账号
    └── 管理账号
```

--------------------------------

### Start CLI Service in Foreground (Debug)

Source: https://virtualbrowser.cc/zh/guide/cli-mode.html

Starts the Virtual Browser CLI service in the foreground, occupying the current terminal for easier log viewing.

```bash
VirtualBrowser.exe --cli --cli-foreground
```

--------------------------------

### Facebook Personal Environment Configuration

Source: https://virtualbrowser.cc/zh/guide/best-practices.html

Example configuration for a Facebook personal account, including fingerprint, proxy, and behavioral settings.

```json
{
  "fb_personal_001": {
    "fingerprint": {
      "screen": { "width": 1920, "height": 1080 },
      "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
      "language": "en-US",
      "timezone": "America/New_York"
    },
    "proxy": {
      "type": "http",
      "host": "us-proxy.example.com",
      "port": 8080
    },
    "behavior": {
      "postingInterval": "2-4 hours",
      "interactionPattern": "natural",
      "friendRequestLimit": 50
    }
  }
}
```

--------------------------------

### Supported Chrome Web Store Link Formats

Source: https://virtualbrowser.cc/zh/guide/install-crx.html

These are the valid URL formats for installing extensions from the Chrome Web Store.

```text
https://chrome.google.com/webstore/detail/[插件名称]/[插件ID]
```

```text
https://chromewebstore.google.com/detail/[插件ID]
```

--------------------------------

### Account Grouping by Purpose Example

Source: https://virtualbrowser.cc/zh/guide/best-practices.html

Group accounts by their operational purpose to streamline workflows and resource allocation.

```text
运营用途
├── 内容创作
├── 广告投放
├── 客户服务
├── 数据分析
└── 测试环境
```

--------------------------------

### Restore Data from Backup

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

Use this command to copy all files from a backup directory to the Virtual Browser installation directory. The /E flag copies directories and subdirectories, and /Y suppresses prompting to confirm you want to overwrite an existing destination file.

```batch
@echo off
copy "C:\Backup\VirtualBrowser\*" "C:\Users\%USERNAME%\AppData\Local\VirtualBrowser\" /E /Y
```

--------------------------------

### Supported Microsoft Edge Add-ons Link Formats

Source: https://virtualbrowser.cc/zh/guide/install-crx.html

These are the valid URL formats for installing extensions from the Microsoft Edge Add-ons store.

```text
https://microsoftedge.microsoft.com/addons/detail/[插件名称]/[插件ID]
```

```text
https://edge.microsoft.com/addons/detail/[插件ID]
```

--------------------------------

### Launch Virtual Browser Environment (REST API)

Source: https://virtualbrowser.cc/zh/guide/playwright-integration.html

Use this POST request to launch a browser environment. Ensure you replace `{port}` with the actual port displayed on the API page and `YOUR_API_KEY` with your valid API key. The response will contain the `debuggingPort` needed for CDP connection.

```http
POST http://localhost:{port}/api/launchBrowser
Content-Type: application/json
api-key: YOUR_API_KEY

{
  "id": 1
}
```

--------------------------------

### Basic Configuration Template

Source: https://virtualbrowser.cc/zh/guide/advanced-configuration.html

Use this JSON template for general browsing configurations. It defines basic fingerprinting, proxy settings (null for no proxy), and performance parameters.

```json
{
  "name": "基础配置",
  "description": "适用于一般浏览的配置",
  "fingerprint": {
    "screen": { "width": 1920, "height": 1080 },
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
    "language": "zh-CN",
    "timezone": "Asia/Shanghai"
  },
  "proxy": null,
  "performance": {
    "maxBrowsers": 5,
    "maxTabs": 20
  }
}
```

--------------------------------

### Configure HTTP/HTTPS Proxy

Source: https://virtualbrowser.cc/zh/guide/advanced-configuration.html

Set up an HTTP or HTTPS proxy with host, port, and authentication details. Requires host, port, and optionally username/password.

```json
{
  "proxy": {
    "type": "http",
    "host": "proxy.example.com",
    "port": 8080,
    "username": "user",
    "password": "pass",
    "protocol": "http"
  }
}
```

--------------------------------

### Login with Username/Password or Token

Source: https://virtualbrowser.cc/zh/guide/cli-mode.html

Authenticates the CLI service using either username and password or a provided token.

```bash
# 用户名密码
VirtualBrowser.exe --cli --username=YOUR_USERNAME --password=YOUR_PASSWORD
```

```bash
# 短参数
VirtualBrowser.exe --cli -u YOUR_USERNAME -p YOUR_PASSWORD
```

```bash
# Token
VirtualBrowser.exe --cli --token=YOUR_TOKEN
```

```bash
VirtualBrowser.exe --cli --x-token=YOUR_TOKEN
```

--------------------------------

### Optimize Performance with Resource Limits

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

JSON configuration for setting performance-related limits, including maximum heap size, old space size, garbage collection interval, and concurrency settings.

```json
{
  "performance": {
    "memory": {
      "maxHeapSize": "2GB",
      "maxOldSpaceSize": "1GB",
      "gcInterval": 30000
    },
    "concurrency": {
      "maxBrowsers": 8,
      "maxTabs": 40,
      "maxWorkers": 4
    }
  }
}
```

--------------------------------

### Configure HTTP Proxy Settings

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

JSON configuration for setting up an HTTP proxy, including host, port, authentication, and timeouts.

```json
{
  "proxy": {
    "type": "http",
    "host": "proxy.example.com",
    "port": 8080,
    "username": "user",
    "password": "pass",
    "protocol": "http",
    "timeout": 30000,
    "retries": 3
  }
}
```

--------------------------------

### MCP Endpoint and Tools

Source: https://virtualbrowser.cc/zh/guide/mcp.html

The MCP protocol provides HTTP endpoints for controlling browser environments. Key tools include getting browser lists, launching, and stopping browsers.

```APIDOC
## MCP Protocol

Virtual Browser Professional Edition offers HTTP endpoints based on the Model Context Protocol (MCP) that allow AI tools such as Cursor and Claude Desktop to control the browser environment.

### Endpoint Address

After the service starts, the MCP address format is:
`http://localhost:{port}/mcp`

* `{port}` is the local port displayed in the client's API menu.
* Transport Method: **Streamable HTTP**

### Built-in Tools

The Virtual Browser MCP service registers the following tools:

* `getBrowserList`: Retrieves a list of browser environments (ID, name, group, etc.).
* `launchBrowser`: Launches a specified environment and returns the `debuggingPort` for Playwright connection.
* `stopBrowser`: Closes a specified environment.

### Configuration Examples

**Cursor Configuration:**
```json
{
  "mcpServers": {
    "virtual-browser": {
      "url": "http://localhost:{port}/mcp"
    }
  }
}
```

**Claude Desktop Configuration:**
```json
{
  "mcpServers": {
    "virtual-browser": {
      "url": "http://localhost:{port}/mcp"
    }
  }
}
```

### Example Dialogues

1. **List Environments**: "Call getBrowserList and tell me what browser environments are available."
2. **Launch and Open Webpage**: "Use launchBrowser to start environment with ID 1, then open https://example.com using Playwright."
3. **End**: "stopBrowser to close ID 1."
```

--------------------------------

### Set Up Market Research and Competitor Analysis Profiles

Source: https://virtualbrowser.cc/zh/guide/use-cases.html

Configure browser profiles for market research and competitor analysis. This includes defining competitor URLs, setting up research-specific fingerprints, and configuring rotating proxies for data collection.

```json
{
  "marketResearch": {
    "competitors": [
      {
        "name": "Competitor-A",
        "urls": ["amazon.com", "ebay.com", "shopify.com"],
        "fingerprint": "research-profile-1",
        "proxy": "rotating-proxy-1"
      },
      {
        "name": "Competitor-B",
        "urls": ["walmart.com", "target.com"],
        "fingerprint": "research-profile-2",
        "proxy": "rotating-proxy-2"
      }
    ],
    "dataCollection": {
      "products": true,
      "pricing": true,
      "reviews": true,
      "marketing": true
    }
  }
}
```

--------------------------------

### Remove Quarantine Attribute on macOS

Source: https://virtualbrowser.cc/zh/guide/system-requirements.html

If macOS prompts that the application is damaged or cannot be opened, execute this command in the terminal to remove the quarantine attribute. Ensure the path reflects your actual installation name.

```bash
xattr -d com.apple.quarantine "/Applications/Virtual Browser.app"
```

--------------------------------

### Configure Performance Monitoring

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

This JSON configuration enables performance monitoring, collects CPU, memory, network, and disk metrics every 5 seconds, and sets alert thresholds for CPU (80%), memory (85%), and disk (90%).

```json
{
  "monitoring": {
    "enabled": true,
    "metrics": ["cpu", "memory", "network", "disk"],
    "interval": 5000,
    "alerts": {
      "cpuThreshold": 80,
      "memoryThreshold": 85,
      "diskThreshold": 90
    }
  }
}
```

--------------------------------

### Configure Device Memory and CPU Cores

Source: https://virtualbrowser.cc/zh/guide/advanced-configuration.html

Specify device memory in GB and the number of CPU cores. Tailor to different device capabilities.

```json
{
  "deviceMemory": 8,
  "hardwareConcurrency": 8
}
```

--------------------------------

### Connect Playwright (Node.js) to Virtual Browser CDP

Source: https://virtualbrowser.cc/zh/guide/playwright-integration.html

This Node.js script shows how to launch a browser environment via REST API, get the debugging port, and connect Playwright using `chromium.connectOverCDP`. It then navigates to a page, logs the title, and stops the browser.

```javascript
import fetch from 'node-fetch';
import { chromium } from 'playwright';

const BASE = 'http://localhost:9000';
const headers = { 'Content-Type': 'application/json', 'api-key': 'YOUR_API_KEY' };

const launch = await fetch(`${BASE}/api/launchBrowser`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ id: 1 }),
}).then((r) => r.json());

if (!launch.success) throw new Error(JSON.stringify(launch));

const port = launch.data.debuggingPort;
const browser = await chromium.connectOverCDP(`http://127.0.0.1:${port}`);
const page = browser.contexts()[0]?.pages()[0] ?? (await browser.newContext()).newPage();
await page.goto('https://example.com');
console.log(await page.title());

await fetch(`${BASE}/api/stopBrowser`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ id: 1 }),
});
```

--------------------------------

### Configure Price Monitoring for E-commerce

Source: https://virtualbrowser.cc/zh/guide/use-cases.html

Sets up product monitoring for price and stock changes across competitor websites, including specified URLs, fingerprints, proxies, and monitoring frequency. Use this to automate competitive pricing strategies and receive alerts for critical market shifts.

```json
{
  "priceMonitoring": {
    "products": [
      {
        "name": "Product-A",
        "urls": ["competitor1.com", "competitor2.com"],
        "fingerprint": "monitor-profile-1",
        "proxy": "monitor-proxy-1",
        "frequency": "hourly"
      }
    ],
    "alerts": {
      "priceChange": true,
      "stockChange": true,
      "competitorActivity": true
    }
  }
}
```

--------------------------------

### Configure Network Settings for Optimization

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

JSON configuration for network parameters like DNS servers, timeouts, keep-alive, and compression.

```json
{
  "network": {
    "dns": ["8.8.8.8", "1.1.1.1"],
    "timeout": 30000,
    "keepAlive": true,
    "compression": true
  }
}
```

--------------------------------

### Check System Resources for Virtual Browser

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

Use tasklist to check if Virtual Browser is running and dir to inspect its application data directory. Ensure sufficient system resources are available.

```bash
# 检查内存使用情况
tasklist /fi "imagename eq VirtualBrowser.exe"

# 检查磁盘空间
dir C:\Users\%USERNAME%\AppData\Local\VirtualBrowser
```

--------------------------------

### Problem Report Template - Environment Information

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

This section captures the system and Virtual Browser configuration details, including CPU, memory, disk, network, browser environment count, proxy configuration, and fingerprint configuration.

```markdown
系统配置:
- CPU: [处理器型号]
- 内存: [内存大小]
- 磁盘: [磁盘类型和大小]
- 网络: [网络环境]

Virtual Browser 配置:
- 浏览器环境数量: [数量]
- 代理配置: [代理类型和数量]
- 指纹配置: [指纹类型]
```

--------------------------------

### eBay Seller Environment Configuration

Source: https://virtualbrowser.cc/zh/guide/best-practices.html

Set up an environment for an eBay seller account, specifying fingerprint and proxy details.

```json
{
  "ebay_seller_001": {
    "fingerprint": {
      "screen": { "width": 1366, "height": 768 },
      "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
      "language": "en-GB",
      "timezone": "Europe/London"
    },
    "proxy": {
      "type": "socks5",
      "host": "uk-proxy.example.com",
      "port": 1080
    }
  }
}
```

--------------------------------

### Optimize Behavior Simulation Settings

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

Fine-tune behavior simulation parameters for mouse movements, typing, and navigation. These settings aim to mimic realistic user interactions.

```json
{
  "behavior": {
    "mouseMovement": {
      "natural": true,
      "acceleration": 0.1,
      "randomness": 0.05
    },
    "typing": {
      "speed": "human",
      "mistakes": 0.02,
      "corrections": true
    },
    "navigation": {
      "pageLoadTime": "2-5s",
      "scrollBehavior": "natural",
      "clickDelay": "100-300ms"
    }
  }
}
```

--------------------------------

### Windows 系统服务与虚拟内存优化

Source: https://virtualbrowser.cc/zh/guide/performance-optimization.html

通过 PowerShell 关闭不必要的 Windows 服务（如 SysMain、WSearch），并调整虚拟内存设置以优化系统性能。

```powershell
powershell
# 关闭不必要的服务
Stop-Service -Name "SysMain" -Force
Stop-Service -Name "WSearch" -Force

# 调整虚拟内存
wmic computersystem set AutomaticManagedPagefile=False
wmic pagefileset create name="C:\pagefile.sys",initialsize=8192,maximumsize=16384

# 优化磁盘性能
defrag C: /O /U

```

--------------------------------

### Configure User Agent String

Source: https://virtualbrowser.cc/zh/guide/advanced-configuration.html

Set the User-Agent string to mimic specific browser versions and operating systems. Keep it updated with stable releases.

```json
{
  "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
}
```

--------------------------------

### Configure Proxy Pool with Round Robin Strategy

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

JSON configuration for managing a pool of proxies with round-robin rotation, health checks, and failover.

```json
{
  "proxyPool": {
    "proxies": [
      { "host": "proxy1.example.com", "port": 8080 },
      { "host": "proxy2.example.com", "port": 8080 },
      { "host": "proxy3.example.com", "port": 8080 }
    ],
    "strategy": "round_robin",
    "healthCheck": true,
    "failover": true
  }
}
```

--------------------------------

### Configure WebGL Fingerprint Parameters

Source: https://virtualbrowser.cc/zh/guide/advanced-configuration.html

Set WebGL vendor, renderer information, and noise level. Helps in randomizing WebGL output.

```json
{
  "webgl": {
    "vendor": "Google Inc. (Intel)",
    "renderer": "ANGLE (Intel, Intel(R) UHD Graphics 620 Direct3D11 vs_5_0 ps_5_0)",
    "noise": 0.05
  }
}
```

--------------------------------

### Configure Multiple Game Accounts

Source: https://virtualbrowser.cc/zh/guide/use-cases.html

Sets up multiple game accounts for different blockchain games, specifying account names, fingerprints, proxies, and the types of in-game tasks to perform. Ideal for players needing to manage several game instances simultaneously for tasks like farming or trading.

```json
{
  "gaming": {
    "games": {
      "axie": {
        "accounts": [
          {
            "name": "Axie-Account-1",
            "fingerprint": "gaming-profile-1",
            "proxy": "gaming-proxy-1",
            "tasks": ["daily", "adventure", "arena"]
          }
        ]
      },
      "stepn": {
        "accounts": [
          {
            "name": "StepN-Account-1",
            "fingerprint": "gaming-profile-2",
            "proxy": "gaming-proxy-2",
            "tasks": ["walking", "minting", "trading"]
          }
        ]
      }
    }
  }
}
```

--------------------------------

### Configure Backup Settings

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

This JSON configuration enables automatic backups, sets the backup interval to 1 hour, retains backups for 7 days, and enables auto-save with a 5-minute interval.

```json
{
  "storage": {
    "backupEnabled": true,
    "backupInterval": 3600000,
    "backupRetention": 7,
    "autoSave": true,
    "saveInterval": 300000
  }
}
```

--------------------------------

### Configure Time-Based Proxy Rotation

Source: https://virtualbrowser.cc/zh/guide/advanced-configuration.html

Set up proxy rotation based on a time interval. Proxies are rotated after a specified interval in seconds.

```json
{
  "proxyRotation": {
    "strategy": "time",
    "interval": 300,
    "proxies": ["proxy1", "proxy2", "proxy3"]
  }
}
```

--------------------------------

### Basic Security Configuration

Source: https://virtualbrowser.cc/zh/guide/security-privacy.html

Configure fundamental security settings such as sandboxing, encryption, auto-cleanup, and session timeouts.

```json
{
  "security": {
    "enableSandbox": true,
    "enableEncryption": true,
    "autoCleanup": true,
    "sessionTimeout": 3600
  }
}
```

--------------------------------

### Shopify Store Environment Configuration

Source: https://virtualbrowser.cc/zh/guide/best-practices.html

Configure an environment for a Shopify store, including screen resolution, user agent, language, timezone, and proxy settings.

```json
{
  "shopify_store_001": {
    "fingerprint": {
      "screen": { "width": 2560, "height": 1440 },
      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
      "language": "en-US",
      "timezone": "America/Los_Angeles"
    },
    "proxy": {
      "type": "http",
      "host": "ca-proxy.example.com",
      "port": 8080
    }
  }
}
```

--------------------------------

### Enable Automatic Tuning Configuration

Source: https://virtualbrowser.cc/zh/guide/performance-optimization.html

This JSON configuration enables automatic performance tuning, specifying the tuning interval, optimization targets, and learning mode.

```json
{
  "autoTuning": {
    "enable": true,
    "tuningInterval": 300000,
    "optimizationTargets": ["memory", "cpu", "network", "startup"],
    "learningMode": true
  }
}
```

--------------------------------

### Configure Screen Resolution

Source: https://virtualbrowser.cc/zh/guide/advanced-configuration.html

Set screen resolution, color depth, and pixel depth. Use common resolutions for better compatibility.

```json
{
  "screen": {
    "width": 1920,
    "height": 1080,
    "colorDepth": 24,
    "pixelDepth": 24,
    "availWidth": 1920,
    "availHeight": 1040
  }
}
```

--------------------------------

### Optimize Network Connection Settings

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

JSON configuration for network connection parameters, including maximum connections per host, connection timeout, and keep-alive.

```json
{
  "network": {
    "maxConnections": 80,
    "maxConnectionsPerHost": 6,
    "connectionTimeout": 20000,
    "keepAlive": true
  }
}
```

--------------------------------

### Configure Memory Limits for Heap and Old Space

Source: https://virtualbrowser.cc/zh/guide/advanced-configuration.html

Set maximum heap size, old generation space size, and garbage collection interval. Optimizes memory usage.

```json
{
  "memory": {
    "maxHeapSize": "2GB",
    "maxOldSpaceSize": "1GB",
    "gcInterval": 30000
  }
}
```

--------------------------------

### Configure Language and Timezone

Source: https://virtualbrowser.cc/zh/guide/advanced-configuration.html

Define the primary language, language preferences, timezone identifier, and offset. Match user's expected locale.

```json
{
  "language": "zh-CN",
  "languages": ["zh-CN", "zh", "en-US", "en"],
  "timezone": "Asia/Shanghai",
  "timezoneOffset": -480
}
```

--------------------------------

### Configure Network Connection Limits

Source: https://virtualbrowser.cc/zh/guide/advanced-configuration.html

Define limits for total network connections, connections per host, and connection timeout. Optimizes network performance.

```json
{
  "network": {
    "maxConnections": 100,
    "maxConnectionsPerHost": 6,
    "connectionTimeout": 30000
  }
}
```

--------------------------------

### Configure Cache Settings

Source: https://virtualbrowser.cc/zh/guide/advanced-configuration.html

Define cache size, time-to-live (TTL), and cleanup interval. Manages browser cache for performance.

```json
{
  "cache": {
    "maxSize": "500MB",
    "ttl": 3600000,
    "cleanupInterval": 300000
  }
}
```

--------------------------------

### DNS 配置优化

Source: https://virtualbrowser.cc/zh/guide/performance-optimization.html

配置 DNS 服务器列表、缓存大小、缓存超时时间和是否启用预取功能。

```json
json
{
  "dns": {
    "servers": ["8.8.8.8", "1.1.1.1", "114.114.114.114"],
    "cacheSize": 1000,
    "cacheTimeout": 3600000,
    "enablePrefetch": true
  }
}

```

--------------------------------

### Configure Smart Proxy Rotation

Source: https://virtualbrowser.cc/zh/guide/advanced-configuration.html

Implement intelligent proxy rotation with health checks and error limits. Automatically adapts to proxy availability.

```json
{
  "proxyRotation": {
    "strategy": "smart",
    "maxErrors": 5,
    "healthCheck": true,
    "proxies": ["proxy1", "proxy2", "proxy3"]
  }
}
```

--------------------------------

### Optimize Cache Settings

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

JSON configuration for cache management, including maximum size, time-to-live, cleanup interval, and compression.

```json
{
  "cache": {
    "maxSize": "500MB",
    "ttl": 1800000,
    "cleanupInterval": 300000,
    "compression": true
  }
}
```

--------------------------------

### Data Recovery Steps

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

Placeholder for data recovery commands. This section requires specific commands to be filled in.

```bash

```

--------------------------------

### Performance Optimization Configuration

Source: https://virtualbrowser.cc/zh/guide/best-practices.html

Configuration for performance optimization, detailing memory management and concurrency limits.

```json
{
  "performance": {
    "memory": {
      "maxHeapSize": "2GB",
      "gcInterval": 30000,
      "cleanupThreshold": 0.8
    },
    "concurrency": {
      "maxBrowsers": 10,
      "maxTabs": 50,
      "maxWorkers": 4
    }
  }
}
```

--------------------------------

### Enable Debug Mode

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

This JSON configuration enables debugging with verbose logging, logs to both file and console, and enables profiling and tracing.

```json
{
  "debug": {
    "enabled": true,
    "level": "verbose",
    "logToFile": true,
    "logToConsole": true,
    "profiling": true,
    "trace": true
  }
}
```

--------------------------------

### Configure Data Synchronization

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

This JSON configuration enables cloud synchronization with Dropbox, sets the sync interval to 30 minutes, and enables encryption for synced data.

```json
{
  "sync": {
    "enabled": true,
    "cloudStorage": "dropbox",
    "syncInterval": 1800000,
    "encryption": true
  }
}
```

--------------------------------

### Monitor Virtual Browser Memory and Page File Usage

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

Use WMIC command to check the Working Set Size and Page File Usage for the VirtualBrowser.exe process.

```bash
# 监控内存使用
wmic process where name="VirtualBrowser.exe" get WorkingSetSize,PageFileUsage
```

--------------------------------

### 本地存储优化配置

Source: https://virtualbrowser.cc/zh/guide/performance-optimization.html

配置本地存储（localStorage 和 sessionStorage）的最大大小和清理间隔。

```json
json
{
  "storage": {
    "localStorage": {
      "maxSize": 10,
      "cleanupInterval": 86400000
    },
    "sessionStorage": {
      "maxSize": 5,
      "cleanupInterval": 3600000
    }
  }
}

```

--------------------------------

### Monitor System-Wide CPU Usage

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

Use typeperf to monitor the percentage of processor time used by the system.

```bash
# 监控CPU使用
typeperf "\Processor(_Total)\% Processor Time"
```

--------------------------------

### 浏览器网络配置优化

Source: https://virtualbrowser.cc/zh/guide/performance-optimization.html

优化网络连接设置，包括最大并发连接数、启用 HTTP/2 和 QUIC 协议，以及配置 DNS 缓存大小。

```json
json
{
  "network": {
    "maxConcurrentConnections": 32,
    "enableHttp2": true,
    "enableQuic": true,
    "dnsCacheSize": 1000
  }
}

```

--------------------------------

### Problem Report Template - Problem Description

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

This section details the problem, including a comprehensive description of the issue, step-by-step reproduction instructions, expected results, and actual observed behavior.

```markdown
详细描述:
[详细描述问题现象]

重现步骤:
1. [步骤1]
2. [步骤2]
3. [步骤3]

预期结果:
[期望的正常行为]

实际结果:
[实际观察到的行为]
```

--------------------------------

### Improve Proxy Rotation Strategy

Source: https://virtualbrowser.cc/zh/guide/troubleshooting.html

Configure proxy rotation settings, including strategy, interval, health checks, and geolocation. This helps in maintaining consistent and effective proxy usage.

```json
{
  "proxy": {
    "rotation": {
      "strategy": "smart",
      "interval": 300,
      "healthCheck": true,
      "maxErrors": 3
    },
    "geolocation": {
      "country": "US",
      "city": "New York",
      "timezone": "America/New_York"
    }
  }
}
```

--------------------------------

### Amazon Shop Environment Configuration

Source: https://virtualbrowser.cc/zh/guide/best-practices.html

Configure a specific environment for an Amazon shop, including fingerprint, proxy, and general settings.

```json
{
  "amazon_shop_001": {
    "fingerprint": {
      "screen": { "width": 1920, "height": 1080 },
      "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
      "language": "en-US",
      "timezone": "America/New_York"
    },
    "proxy": {
      "type": "http",
      "host": "us-proxy.example.com",
      "port": 8080
    },
    "settings": {
      "autoSave": true,
      "sessionTimeout": 3600,
      "backupInterval": 86400
    }
  }
}
```

--------------------------------

### 性能监控指标与告警配置

Source: https://virtualbrowser.cc/zh/guide/performance-optimization.html

配置性能监控的指标、采样间隔以及告警阈值，包括内存使用率、CPU 使用率和启动时间。

```json
json
{
  "monitoring": {
    "metrics": ["startupTime", "memoryUsage", "cpuUsage", "networkLatency", "pageLoadTime"],
    "samplingInterval": 5000,
    "alertThresholds": {
      "memoryUsage": 80,
      "cpuUsage": 70,
      "startupTime": 10000
    }
  }
}

```

--------------------------------

### Configure Access Control Whitelists and Blocklists

Source: https://virtualbrowser.cc/zh/guide/advanced-configuration.html

Define IP and domain whitelists, and blocked domains. Controls network access for security.

```json
{
  "accessControl": {
    "ipWhitelist": ["192.168.1.0/24", "10.0.0.0/8"],
    "domainWhitelist": ["example.com", "trusted-site.com"],
    "blockedDomains": ["malware.com", "phishing.com"]
  }
}
```

--------------------------------

### Configure Airdrop Wallets and Tasks

Source: https://virtualbrowser.cc/zh/guide/use-cases.html

Defines wallet configurations including fingerprints and proxies, and specifies tasks for airdrop participation. Use this to set up multiple distinct identities for engaging in various airdrop campaigns.

```json
{
  "airdrop": {
    "wallets": [
      {
        "name": "Wallet-1",
        "fingerprint": "wallet-profile-1",
        "proxy": "proxy-1",
        "networks": ["Ethereum", "Polygon", "BSC"]
      },
      {
        "name": "Wallet-2",
        "fingerprint": "wallet-profile-2",
        "proxy": "proxy-2",
        "networks": ["Arbitrum", "Optimism", "Avalanche"]
      }
    ],
    "tasks": {
      "socialTasks": true,
      "onchainTasks": true,
      "referralTasks": true
    }
  }
}
```

--------------------------------

### 基础指纹参数优化

Source: https://virtualbrowser.cc/zh/guide/performance-optimization.html

配置基础指纹参数，包括启用画布和 WebGL 指纹随机化，并设置更新间隔和随机种子。

```json
json
{
  "fingerprint": {
    "canvas": {
      "enableRandomization": true,
      "randomSeed": "auto",
      "updateInterval": 300000
    },
    "webgl": {
      "enableRandomization": true,
      "vendorRandomization": true,
      "rendererRandomization": true
    }
  }
}

```
Tokens:
Raw