{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"云浏览器","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"云浏览器","__idx":0},"children":["云浏览器"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["通过 MoreLogin API 以编程方式启动、停止、连接和管理云浏览器环境。"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"概述","__idx":1},"children":["概述"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["云浏览器 API 会将 MoreLogin 浏览器环境运行在远端主机上。启动环境后，您可以通过 Chrome DevTools 协议（CDP）连接该环境，并使用 Puppeteer、Playwright 或 Selenium 等自动化框架进行操作。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["云浏览器支持两种 API 接入方式："]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"方式"},"children":["方式"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Base URL"},"children":["Base URL"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"适用场景"},"children":["适用场景"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["开放 API"]},"（远程）"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.morelogin.com"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["可从任意位置访问，使用 OAuth2 鉴权"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["本地 API"]},"（本地）"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["http://127.0.0.1:40000"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["从运行 MoreLogin 客户端的本机访问"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["如需远程访问或服务端对服务端集成，请选择",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["开放 API"]},"。"," ","如果自动化脚本与 MoreLogin 客户端运行在同一台机器上，请选择",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["本地 API"]},"。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["鉴权详情请参阅",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/api-reference/getting-started/authentication"},"children":["身份验证"]},"。"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"功能","__idx":2},"children":["功能"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"操作"},"children":["操作"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["启动"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["启动云浏览器环境"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["停止"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["停止运行中的环境，可选择强制释放"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["分页"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["分页查询环境，支持按名称、分组和关键词过滤"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["连接"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["获取运行中环境的 CDP 地址，用于接入自动化工具"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"典型流程","__idx":3},"children":["典型流程"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["使用 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envId"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["启动"]},"环境，环境进入 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STARTING"]}," 状态。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["轮询"]},"分页列表，直到 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cloudBrowserStatus"]}," 变为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RUNNING"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["连接"]},"以获取 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cdpUrl"]},"，然后通过 CDP 接入 Puppeteer / Playwright / Selenium。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["自动化任务结束后",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["停止"]},"环境。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"环境状态","__idx":4},"children":["环境状态"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"状态"},"children":["状态"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STARTING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["启动中"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RUNNING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["运行中"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLOSED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["已关闭"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"连接信息","__idx":5},"children":["连接信息"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["连接接口会返回两个地址："]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 0,\n  \"msg\": null,\n  \"data\": {\n    \"cdpUrl\": \"https://runtime1.morelogin.com:16167?token=c62fedaaac524e41a0f02fc4345d41cb\",\n    \"accessUrl\": \"https://official-website.morelogin.com/browser-remote?token=eyJkZXNrdG9wVXJsIjoi...ZW52SWQiOiIyMDczMzk1NDg5NzM4OTE5OTM2In0%3D&envName=P-1267&lang=en-US\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"字段"},"children":["字段"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cdpUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["带访问 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token"]}," 的 CDP 地址，可传入 Puppeteer、Playwright 或 Selenium。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accessUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["云浏览器远程桌面页面地址，用于查看和操作会话；未配置时为空。"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accessUrl"]}," 中的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token"]}," 是 Base64 编码的载荷，包含桌面地址、桌面 token、过期时间以及团队、用户、成员和环境 ID。请将这两个地址视为凭据，不要对外泄露。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-参考","__idx":6},"children":["API 参考"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API"},"children":["API"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/api-reference/cloud-browser/open-api"},"children":["云浏览器开放 API"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["通过 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.morelogin.com"]}," 远程访问，使用 OAuth2 鉴权"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/api-reference/cloud-browser/local-api"},"children":["云浏览器本地 API"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["通过 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["http://127.0.0.1:40000"]}," 本地访问，使用 token 鉴权"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["注意"]},"：两套 API 提供相同的操作。本地 API 路径使用 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/cloudbrowser/..."]}," 前缀，开放 API 路径使用 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/cloudbrowser/..."]},"。具体路径和参数请始终参考对应的 API 参考文档。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"相关指南","__idx":7},"children":["相关指南"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"指南"},"children":["指南"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/api-reference/getting-started/authentication"},"children":["身份验证"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["OAuth2 token 配置（开放 API）与 token 鉴权（本地 API）"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/api-reference/getting-started/quickstart"},"children":["快速开始"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["发起您的第一个 MoreLogin API 调用"]}]}]}]}]}]},"headings":[{"value":"云浏览器","id":"云浏览器","depth":1},{"value":"概述","id":"概述","depth":2},{"value":"功能","id":"功能","depth":2},{"value":"典型流程","id":"典型流程","depth":2},{"value":"环境状态","id":"环境状态","depth":2},{"value":"连接信息","id":"连接信息","depth":2},{"value":"API 参考","id":"api-参考","depth":2},{"value":"相关指南","id":"相关指南","depth":2}],"frontmatter":{"seo":{"title":"云浏览器"}},"lastModified":"2026-08-05T03:07:19.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh/api-reference/cloud-browser","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}