打开环境

POST

http://127.0.0.1:6873/api/v1/browser/start

用于启动指定的环境，启动成功后可以获取浏览器debug端口用于执行selenium和puppeteer自动化脚本

目前Hubstudio采用100版Chrome内核

Selenium需要使用到匹配的Webdriver，需更新到应用版本2.4.2及以上版本。返回的debuggingPort参数可用于自动化工具连接。

请求参数

Header 参数

Body 参数application/json

示例

{
    "containerCode": "223012801",  // 环境ID
    "isWebDriverReadOnlyMode": false,  // 是否只读模式，默认false。（true代表只读模式，不会保存cookie等数据）
    "skipSystemResourceCheck":false, // 默认false不跳过系统可用资源检测(仅支持v3.6.0及以上版本)
    "containerTabs": ["https://www.hubstudio.cn/", "https://www.baidu.com/"],  // 启动url
    "cdpHide": false, // 是否屏蔽cdp检测，默认false（true代表屏蔽）仅支持ChroBrowser133及以上内核版本
    "shouldCloseTabsOnOpen": false, // 是否打开历史标签页。需要在客户端 "偏好设置-个人设置-启动环境时" 选项中，选择 "打开上次"，此参数才会生效。当 shouldCloseTabsOnOpen 为 true 时，会同步服务端的标签页数据到客户端，即打开上次关闭时的标签页。当 shouldCloseTabsOnOpen 为 false 时，不会同步服务端的标签页数据，客户端的现有标签页数据不会被覆盖。
    "pageZoom": 1.5, // 只能传原生支持的比例，原生支持 50%，75%， 100%，125%，150%，175%，200%，其它参数不支持，150% 传 1.5。此参数仅支持3.46.0及以上版本
    "isHeadless": false,  // 浏览器无头模式。默认false，设置无头后如无法连接，请使用用"args"参数进行设置: ["--headless=new"] 
    "args": ["--kiosk"] //启动参数
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1:6873/api/v1/browser/start' \
--header 'Authorization: ' \
--header 'X-Nonce-Id: ' \
--header 'X-Api-Id: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "containerCode": "223012801",  // 环境ID
    "isWebDriverReadOnlyMode": false,  // 是否只读模式，默认false。（true代表只读模式，不会保存cookie等数据）
    "skipSystemResourceCheck":false, // 默认false不跳过系统可用资源检测(仅支持v3.6.0及以上版本)
    "containerTabs": ["https://www.hubstudio.cn/", "https://www.baidu.com/"],  // 启动url
    "cdpHide": false, // 是否屏蔽cdp检测，默认false（true代表屏蔽）仅支持ChroBrowser133及以上内核版本
    "shouldCloseTabsOnOpen": false, // 是否打开历史标签页。需要在客户端 "偏好设置-个人设置-启动环境时" 选项中，选择 "打开上次"，此参数才会生效。当 shouldCloseTabsOnOpen 为 true 时，会同步服务端的标签页数据到客户端，即打开上次关闭时的标签页。当 shouldCloseTabsOnOpen 为 false 时，不会同步服务端的标签页数据，客户端的现有标签页数据不会被覆盖。
    "pageZoom": 1.5, // 只能传原生支持的比例，原生支持 50%，75%， 100%，125%，150%，175%，200%，其它参数不支持，150% 传 1.5。此参数仅支持3.46.0及以上版本
    "isHeadless": false,  // 浏览器无头模式。默认false，设置无头后如无法连接，请使用用"args"参数进行设置: ["--headless=new"] 
    "args": ["--kiosk"] //启动参数
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "requestId": "48e54351-2bcc-42e0-945c-1866aa9a17f0",
    "msg": "Success",
    "code": 0,
    "data": {
        "action": "startBrowserByCode",
        "backgroundPluginId": "hbefgchohflbmmnecchdioangfpcgfjn",
        "browserID": 332034,
        "browserPath": "C:\\Users\\Administrator\\AppData\\Local\\env-kit\\Core\\chrome_64_130_202411271729\\hubstudio",
        "containerCode": "11320340",
        "containerId": 332034,
        "debuggingPort": "59591",
        "downloadPath": "C:\\Users\\Administrator\\Desktop\\Hubstudio\\万前般清",
        "duplicate": 4739,
        "err": "成功(Success)",
        "ip": "103.136.249.48",
        "isDynamicIp": false,
        "launcherPage": "about:blank",
        "proxyType": "socks5",
        "requestId": "48e54351-2bcc-42e0-945c-1866aa9a17f0",
        "runMode": 2,
        "statusCode": "0",
        "webdriver": "C:\\Users\\Administrator\\AppData\\Local\\env-kit\\Core\\chrome_64_130_202411271729\\webdriver.exe"
    }
}

修改于 2025-11-24 03:09:31

修改云手机信息

关闭环境