# 启动浏览器

用于启动浏览器；您必须指定配置文件 ID。
启动成功后，您可以获取浏览器调试界面，用于
执行 Selenium 和 Puppeteer 自动化脚本。对于 Selenium，请使用
与相应内核版本匹配的 WebDriver。WebDriver 路径
可以从配置文件启动后的响应中获取。需要
MoreLogin 客户端版本 2.15.0 或更高版本。
已记录的业务错误码：`19099`, `19143`。 各错误码的含义见 [Error Codes](../Getting%20Started/error-codes.md)。任何接口还可能返回通用错误码。

Endpoint: POST /api/env/start
Version: 2026-09-05

## Request fields (application/json):

  - `envId` (string)
    环境 ID。必须提供 `envId` 或 `uniqueId` 中的一个。
如果同时提供了这两个 ID，则以 `envId` 为准。
    Example: 1993244721490239488

  - `uniqueId` (integer)
    环境序列号（小整数 ID）。必须提供 `envId` 或 `uniqueId` 中的一个。
如果两者都提供了，则 `envId` 优先。
    Example: 1

  - `encryptKey` (string)
    加密密钥。仅当环境启用端到端加密时才需要。
    Example: xxx

  - `isHeadless` (boolean)
    是否以无头模式启动。如果省略，则默认为 `false`。
注意：需要客户端版本 v2.36.0 或更高版本。
    Example: false

  - `cdpEvasion` (boolean)
    启用 CDP 指纹规避功能以降低检测风险。
仅适用于 PC 环境。
默认值：`false`。
注意：需要客户端版本 v2.36.0 或更高版本。
    Example: false

  - `closeCheckIPPage` (boolean)
    是否跳过打开检测页面。
true：执行前进行代理检测
false：执行后进行代理检测
注意：需要客户端 v2.56.0 及以上版本。
    Example: false

  - `checkIPErrorHandle` (integer)
    代理检测失败时采取的动作
数字类型：1 或 2
1：代理检测失败则不启动环境
2：代理检测失败也启动环境
若已传入 closeCheckIPPage，则忽略本参数；默认值：1
注意：需要客户端 v2.56.0 及以上版本。
    Example: 1

## Response 200:

  - `200` (unknown)
    成功。`data` 是对象，包含字段 `envId`、`debugPort`、`type`、`version`、`webdriver`。

## Response 200 fields (application/json):

  - `code` (integer)

  - `msg` (string | null)

  - `data` (object, required)

  - `data.envId` (string, required)
    轮廓

  - `data.debugPort` (string, required)

  - `data.type` (string, required)

  - `data.version` (integer, required)

  - `data.webdriver` (string, required)

  - `requestId` (string)
    请求唯一标识；联系支持时请提供