TgeBrowser

主题

快速开始 ​

本指南帮助你快速上手 TgeBrowser 的核心功能：多账号管理、环境隔离和自动化集成。

系统要求 ​

最低配置 ​

组件规格
操作系统Windows 10/11
处理器双核处理器
内存4GB RAM
存储空间2GB 可用空间
网络稳定的网络连接

推荐配置 ​

组件规格
处理器四核处理器或更高
内存8GB RAM 或更高
存储空间5GB+ 可用空间

提示

运营 50+ 环境时，建议使用 16GB 以上内存。

下载与安装 ​

  1. 访问官网下载最新版本安装包
  2. 运行安装程序，按照向导完成安装
  3. 启动 TgeBrowser 应用

首次配置 ​

1. 创建浏览器环境 ​

启动应用后，点击"新建环境"按钮创建第一个浏览器环境。

基础信息 ​

配置项说明示例
环境名称便于识别的名称Facebook-账号1
分组环境分类管理按平台或用途分组
备注详细说明（可选）账号用途等

2. 指纹配置 ​

配置浏览器指纹参数，实现环境隔离：

参数说明建议
操作系统OS 类型Windows/macOS/Android
系统版本版本号根据需求选择
内核版本浏览器内核使用最新稳定版
分辨率屏幕分辨率1920x1080 等常见分辨率
语言浏览器语言zh-CN/en-US
时区系统时区与代理 IP 位置匹配
CanvasCanvas 指纹开启随机
WebGLWebGL 指纹开启随机

3. 代理设置 ​

代理类型 ​

类型说明
HTTP/HTTPS普通代理，速度快
SOCKS5支持 UDP，更安全
无代理使用本地 IP

配置示例 ​

SOCKS5 代理：

协议：socks5
地址：proxy.example.com
端口：1080
用户名：your_username
密码：your_password

HTTP 代理：

协议：http
地址：proxy.example.com
端口：8080
用户名：your_username（可选）
密码：your_password（可选）

注意

  • 不同账号使用不同代理 IP
  • 代理 IP 地理位置应与账号注册地一致

4. 启动环境 ​

配置完成后，点击"启动"按钮打开浏览器环境。

基本操作 ​

环境管理 ​

操作说明
启动打开浏览器环境
停止关闭浏览器环境
编辑修改环境配置
复制基于现有环境创建新环境
删除移除环境（不可恢复）

批量操作 ​

  • 批量启动：选中多个环境，右键选择"批量启动"
  • 批量编辑：统一修改多个环境的配置
  • 批量删除：批量清理不需要的环境

自动化集成 ​

TgeBrowser 支持主流自动化工具：

  • Puppeteer - Node.js 控制 Chrome
  • Playwright - 跨浏览器自动化
  • Selenium - Web 自动化框架
  • DrissionPage - Python 自动化工具

Puppeteer 示例 ​

javascript
const puppeteer = require('puppeteer')

async function connectToBrowser() {
  // 连接到 TgeBrowser 环境
  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')

  // 执行自动化任务
  await page.type('#username', 'your_username')
  await page.type('#password', 'your_password')
  await page.click('#login')
}

connectToBrowser()

Playwright 示例 ​

python
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 调用 ​

通过 RESTful API 远程控制浏览器环境。

启动环境 ​

bash
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}'

创建环境 ​

bash
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": "自动化环境",
    "proxy": {
      "protocol": "socks5",
      "host": "proxy.example.com",
      "port": 1080
    }
  }'

详细 API 文档请参考：API 文档

常见问题 ​

环境启动失败 ​

问题： 环境启动失败，显示"代理连接超时"

解决方案：

  1. 检查代理服务器状态
  2. 验证代理地址、端口、认证信息
  3. 检查本地防火墙设置
  4. 尝试更换其他代理节点

指纹被检测 ​

问题： 在指纹检测网站显示异常

解决方案：

  1. 调整指纹配置，使用常见参数组合
  2. 确保时区与代理 IP 地理位置匹配
  3. 避免使用过于独特的指纹配置

多账号关联 ​

问题： 如何避免多个账号之间的关联？

最佳实践：

  1. 每个账号使用不同的代理 IP
  2. 确保各环境指纹差异明显
  3. 避免机械化操作，模拟真实用户行为
  4. 账号操作间保持合理时间间隔

性能优化 ​

问题： 同时运行多个环境时系统变慢

优化方法：

  1. 关闭不必要的环境
  2. 定期清理环境缓存
  3. 增加系统内存
  4. 使用 SSD 硬盘

下一步 ​

掌握基本使用后，可以：

  1. 深入 API 集成 → API 文档

    • 学习完整的 API 调用方法
    • 实现自动化批量操作

  2. 私有化部署 → 私有部署

    • 了解企业级部署方案
    • 配置私有服务器

  3. 高级功能

    • 团队协作与权限管理
    • 批量环境导入导出
    • 自定义配置

感谢使用 TgeBrowser！