跳转到内容
Multilogin帮助中心

如何以无头模式运行浏览器配置文件

无头模式可以通过自动化运行 Multilogin 浏览器配置文件,而不打开可见的浏览器窗口。如果希望通过 API 脚本、脚本运行器或 CLI 在后台运行浏览器自动化,可以使用此模式。

本文介绍浏览器配置文件的无头自动化。要自动化云手机中的原生 Android 应用,请改用 ADB 或 Appium。

何时使用无头模式

如果你想实现以下目标,可以使用无头模式:

  • 运行浏览器自动化,而不打开可见的浏览器窗口
  • 同时运行多项自动化任务时,减少屏幕上的窗口
  • 比可见的浏览器会话占用更少的界面资源

开始之前

确保你已准备好:

  • 一个 Multilogin 浏览器配置文件
  • 浏览器配置文件自动化的访问权限
  • Selenium、Puppeteer 或 Playwright 脚本
  • 配置文件 ID
  • 已打开的 Multilogin 桌面应用
  • 如果使用脚本运行器,需配置好 Postman 或 Multilogin CLI

选择无头自动化的运行方式

API 或自己的脚本——在 Start Browser Profile 请求中设置 headless_mode=true

Postman Script runner——在请求体中添加 "is_headless": true

Multilogin CLI——在 --profile-id 标志中添加无头模式值

使用无头模式前的准备工作

你可以通过自动化脚本、Postman Script runner 或 Multilogin CLI 使用无头模式。不确定从哪里开始?请按照以下步骤操作。

第 1 步:选择自动化框架

阅读以下文章,选择最适合你用途的框架:如何选择合适的自动化框架

如果刚接触浏览器自动化,Selenium 是常见的起点。可以参考以下文章:Selenium 自动化示例。

第 2 步:编写脚本或使用参考脚本

你需要编写连接 Multilogin API 的脚本,并使用 GET Start Browser Profile 端点。不知道怎么写?我们提供了参考脚本,你可以使用并按需修改。

参考脚本:

第 3 步:在端点参数中启用无头模式

在自己的脚本(或参考脚本)中找到 GET Start Browser Profile 端点。例如,在 Selenium 参考脚本中可以找到该端点:

`https://launcher.mlx.yt:45001/api/v2/profile/f/${folder_id}/p/${profile_id}/start?automation_type=selenium&headless_mode=false`

将 headless_mode=false 改为 headless_mode=true。端点会如下所示:

`https://launcher.mlx.yt:45001/api/v2/profile/f/${folder_id}/p/${profile_id}/start?automation_type=selenium&headless_mode=true`

之后,可以通过 IDE(用于编写和编辑脚本的软件)、终端/Command Prompt,或我们的脚本运行器来运行它。脚本运行器支持 Postman 和 Multilogin CLI。接下来的章节会介绍如何使用脚本运行器。

尝试启动脚本前,确保已启动应用。

注意,以下步骤针对脚本运行器。

如何通过 Script runner(Postman)运行脚本

第 1 步:将脚本放入 Multilogin 脚本文件夹

如果要通过脚本运行器运行脚本,请将脚本放入对应文件夹。

  1. 打开 Multilogin 目录中的 scripts 文件夹:
    1. Windows:C:\Users\%username%\mlx\deps\scripts
    2. macOS:/Users/%username%/mlx\deps\scripts
    3. Linux:/home/%username%/mlx/deps/scripts
  2. 将脚本粘贴到此文件夹。例如,脚本名为 profile.py

第 2 步:安装并配置 Postman

要启动 Script runner,需要配置 Postman。请按照以下文章操作,直到“Add the CookieRobot script”步骤之前:如何在 Postman 中使用 Script runner 启动 CookieRobot。

第 3 步:编辑请求体

在 Postman 中配置并打开 GET Start Script Runner 端点 后,需要编辑请求体。它会如下所示:

{
    "script_file": "<string>",
    "profile_ids": [
        {
            "profile_id": "<string>"
        }
    ]
}

具体操作如下:

  1. 将 script_file 的值替换为脚本名称。在本例中是 profile.py
  2. 将 profile_id 的值替换为要运行的配置文件 ID。查找方法见:如何在 Multilogin 中复制配置文件 ID
  3. 添加 is_headless 参数,并将值设为 true

请求结构如下:

{
    "script_file": "<string>",
    "profile_ids": [
        {
            "profile_id": "<string>",
            "is_headless": true
        }
    ]
}
Postman Start Script Runner 的 JSON 请求体中 is_headless 设为 true

第 4 步:运行脚本

点击“Send”。

检查无头模式是否正常工作

如果设置成功,浏览器配置文件会通过自动化启动,但不会打开可见的浏览器窗口。脚本会继续在后台执行浏览器操作。

如何通过脚本运行器(Multilogin CLI)运行脚本

第 1 步:将脚本放入 Multilogin 脚本文件夹

如果要通过脚本运行器运行脚本,请将脚本放入对应文件夹。

  1. 打开 Multilogin 目录中的 scripts 文件夹:
    1. Windows:C:\Users\%username%\mlx\deps\scripts
    2. macOS:/Users/%username%/mlx\deps\scripts
    3. Linux:/home/%username%/mlx/deps/scripts
  2. 将脚本粘贴到此文件夹。例如,脚本名为 profile.py

第 2 步:启动并配置 Multilogin CLI

按照以下文章操作:如何使用 Multilogin CLI 的脚本运行器。

第 3 步:运行脚本

启动 Multilogin CLI 后,就可以运行脚本并设置以无头模式启动配置文件。输入 start-script 命令,并带上 --script 和 --profile-id 标志。在配置文件 ID 后添加 :true,以无头模式运行。最终命令如下:

  • Windows:xcli start-script --script <your script title> --profile-id <profile id>:true
  • macOS/Linux:./xcli start-script --script <your script title> --profile-id <profile id>:true

将 <profile id> 的值替换为要运行的配置文件 ID。查找方法见:如何在 Multilogin 中复制配置文件 ID

终端使用 headless 标志运行 Multilogin CLI 脚本,结果表中显示 SUCCESS。

无头模式无法正常工作时

配置文件无法启动

  • 确保 Multilogin 桌面应用已打开
  • 检查配置文件 ID

仍然出现浏览器窗口

  • 检查 headless_mode 或 is_headless 是否设为 true

脚本运行器无法启动

  • 检查 Postman 或 CLI 的脚本运行器设置
  • 确保脚本位于 Multilogin 的 scripts 文件夹中

 

随时掌握最新动态

获取最新动态,交流经验,了解实际使用场景。

获取产品更新Telegram频道向其他用户提问Telegram聊天查看使用场景Discord社区