Quick Start

中文文档: /start

This guide helps you quickly get started with TgeBrowser's core features: multi-account management, environment isolation, and automation integration.

System Requirements

Minimum Configuration

Component	Specification
OS	Windows 10/11
Processor	Dual-core processor
Memory	4GB RAM
Storage	2GB available space
Network	Stable network connection

Recommended Configuration

Component	Specification
Processor	Quad-core processor or higher
Memory	8GB RAM or higher
Storage	5GB+ available space

Note

When operating 50+ environments, it is recommended to use 16GB or more memory.

Download and Installation

1. Visit the official website to download the latest version
2. Run the installer and follow the wizard to complete installation
3. Launch the TgeBrowser application

Initial Configuration

1. Create Browser Environment

After launching the application, click the "New Environment" button to create your first browser environment.

Basic Information

Configuration	Description	Example
Environment Name	Easy-to-identify name	Facebook-Account1
Group	Environment categorization	Group by platform or purpose
Notes	Detailed description (optional)	Account usage, etc.

2. Fingerprint Configuration

Configure browser fingerprint parameters to achieve environment isolation:

Parameter	Description	Recommendation
Operating System	OS type	Windows/macOS/Android
System Version	Version number	Select according to needs
Kernel Version	Browser kernel	Use latest stable version
Resolution	Screen resolution	Common resolutions like 1920x1080
Language	Browser language	zh-CN/en-US
Timezone	System timezone	Match proxy IP location
Canvas	Canvas fingerprint	Enable randomization
WebGL	WebGL fingerprint	Enable randomization

3. Proxy Settings

Proxy Types

Type	Description
HTTP/HTTPS	Regular proxy, fast speed
SOCKS5	Supports UDP, more secure
No Proxy	Use local IP

Configuration Example

SOCKS5 Proxy:

Protocol: socks5
Address: proxy.example.com
Port: 1080
Username: your_username
Password: your_password

HTTP Proxy:

Protocol: http
Address: proxy.example.com
Port: 8080
Username: your_username (optional)
Password: your_password (optional)

Note

• Use different proxy IPs for different accounts
• Proxy IP location should match account registration location

4. Start Environment

After configuration is complete, click the "Start" button to open the browser environment.

Basic Operations

Environment Management

Operation	Description
Start	Open browser environment
Stop	Close browser environment
Edit	Modify environment configuration
Copy	Create new environment based on existing one
Delete	Remove environment (irreversible)

Batch Operations

• Batch Start: Select multiple environments, right-click and choose "Batch Start"
• Batch Edit: Modify configuration of multiple environments uniformly
• Batch Delete: Clean up unnecessary environments in bulk

Automation Integration

TgeBrowser supports mainstream automation tools:

• Puppeteer - Node.js Chrome control
• Playwright - Cross-browser automation
• Selenium - Web automation framework
• DrissionPage - Python automation tool

Puppeteer Example

const puppeteer = require('puppeteer')

async function connectToBrowser() {
  // Connect to TgeBrowser environment
  const browser = await puppeteer.connect({
    browserWSEndpoint: 'ws://localhost:9222/devtools/browser/xxx',
    defaultViewport: null
  })

  const page = await browser.newPage()
  await page.goto('https://example.com')

  // Perform automation tasks
  await page.type('#username', 'your_username')
  await page.type('#password', 'your_password')
  await page.click('#login')
}

connectToBrowser()

Playwright Example

from playwright.sync_api import sync_playwright

def run():
    with sync_playwright() as p:
        browser = p.chromium.connect_over_cdp(
            "ws://localhost:9222/devtools/browser/xxx"
        )

        page = browser.new_page()
        page.goto("https://example.com")

        page.fill("#username", "your_username")
        page.fill("#password", "your_password")
        page.click("#login")

        browser.close()

run()

API Calls

Control browser environments remotely via RESTful API.

Start Environment

curl -X POST http://127.0.0.1:50326/api/browser/start \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"envId": 1001}'

Create Environment

curl -X POST http://127.0.0.1:50326/api/browser/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "browserName": "Automation Environment",
    "proxy": {
      "protocol": "socks5",
      "host": "proxy.example.com",
      "port": 1080
    }
  }'

For detailed API documentation, please refer to: API Documentation

Common Issues

Environment Startup Failure

Issue: Environment fails to start, showing "Proxy connection timeout"

Solution:

1. Check proxy server status
2. Verify proxy address, port, and authentication information
3. Check local firewall settings
4. Try switching to other proxy nodes

Fingerprint Detection

Issue: Abnormal display on fingerprint detection websites

Solution:

1. Adjust fingerprint configuration, use common parameter combinations
2. Ensure timezone matches proxy IP geographic location
3. Avoid using overly unique fingerprint configurations

Multi-Account Association

Issue: How to avoid association between multiple accounts?

Best Practices:

1. Use different proxy IPs for each account
2. Ensure significant fingerprint differences between environments
3. Avoid mechanical operations, simulate real user behavior
4. Maintain reasonable time intervals between account operations

Performance Optimization

Issue: System slows down when running multiple environments simultaneously

Optimization Methods:

1. Close unnecessary environments
2. Regularly clean environment cache
3. Increase system memory
4. Use SSD hard drive

Next Steps

After mastering basic usage, you can:

1. Deep API Integration → API Documentation

   • Learn complete API calling methods
   • Implement automated batch operations

2. Private Deployment → Private Deployment

   • Learn about enterprise-level deployment solutions
   • Configure private servers

3. Advanced Features

   • Team collaboration and permission management
   • Batch environment import/export
   • Custom configuration

---

Thank you for using TgeBrowser!