# 云浏览器

通过 MoreLogin API 以编程方式启动、停止、连接和管理云浏览器环境。

## 概述

云浏览器 API 会将 MoreLogin 浏览器环境运行在远端主机上。启动环境后，您可以通过 Chrome DevTools 协议（CDP）连接该环境，并使用 Puppeteer、Playwright 或 Selenium 等自动化框架进行操作。

**云浏览器支持两种 API 接入方式：**

| 方式 | Base URL | 适用场景 |
|  --- | --- | --- |
| **开放 API**（远程） | `https://api.morelogin.com` | 可从任意位置访问，使用 OAuth2 鉴权 |
| **本地 API**（本地） | `http://127.0.0.1:40000` | 从运行 MoreLogin 客户端的本机访问 |


> 如需远程访问或服务端对服务端集成，请选择**开放 API**。
如果自动化脚本与 MoreLogin 客户端运行在同一台机器上，请选择**本地 API**。


鉴权详情请参阅[身份验证](/zh/api-reference/getting-started/authentication)。

## 功能

| 操作 | 说明 |
|  --- | --- |
| **启动** | 启动云浏览器环境 |
| **停止** | 停止运行中的环境，可选择强制释放 |
| **分页** | 分页查询环境，支持按名称、分组和关键词过滤 |
| **连接** | 获取运行中环境的 CDP 地址，用于接入自动化工具 |


## 典型流程

1. 使用 `envId` **启动**环境，环境进入 `STARTING` 状态。
2. **轮询**分页列表，直到 `cloudBrowserStatus` 变为 `RUNNING`。
3. **连接**以获取 `cdpUrl`，然后通过 CDP 接入 Puppeteer / Playwright / Selenium。
4. 自动化任务结束后**停止**环境。


## 环境状态

| 状态 | 说明 |
|  --- | --- |
| `STARTING` | 启动中 |
| `RUNNING` | 运行中 |
| `CLOSED` | 已关闭 |


## 连接信息

连接接口会返回两个地址：

```json
{
  "code": 0,
  "msg": null,
  "data": {
    "cdpUrl": "https://runtime1.morelogin.com:16167?token=c62fedaaac524e41a0f02fc4345d41cb",
    "accessUrl": "https://official-website.morelogin.com/browser-remote?token=eyJkZXNrdG9wVXJsIjoi...ZW52SWQiOiIyMDczMzk1NDg5NzM4OTE5OTM2In0%3D&envName=P-1267&lang=en-US"
  }
}
```

| 字段 | 说明 |
|  --- | --- |
| `cdpUrl` | 带访问 `token` 的 CDP 地址，可传入 Puppeteer、Playwright 或 Selenium。 |
| `accessUrl` | 云浏览器远程桌面页面地址，用于查看和操作会话；未配置时为空。 |


> `accessUrl` 中的 `token` 是 Base64 编码的载荷，包含桌面地址、桌面 token、过期时间以及团队、用户、成员和环境 ID。请将这两个地址视为凭据，不要对外泄露。


## API 参考

| API | 说明 |
|  --- | --- |
| [云浏览器开放 API](/zh/api-reference/cloud-browser/open-api) | 通过 `https://api.morelogin.com` 远程访问，使用 OAuth2 鉴权 |
| [云浏览器本地 API](/zh/api-reference/cloud-browser/local-api) | 通过 `http://127.0.0.1:40000` 本地访问，使用 token 鉴权 |


> **注意**：两套 API 提供相同的操作。本地 API 路径使用 `/api/cloudbrowser/...` 前缀，开放 API 路径使用 `/cloudbrowser/...`。具体路径和参数请始终参考对应的 API 参考文档。


## 相关指南

| 指南 | 说明 |
|  --- | --- |
| [身份验证](/zh/api-reference/getting-started/authentication) | OAuth2 token 配置（开放 API）与 token 鉴权（本地 API） |
| [快速开始](/zh/api-reference/getting-started/quickstart) | 发起您的第一个 MoreLogin API 调用 |