跳转到内容
Multilogin帮助中心

如何在 Docker 容器中运行 Multilogin

当你需要无头环境进行浏览器自动化时,可以在 Docker 容器中运行 Multilogin 启动器。

➡️ 创建下面的 Docker Compose 文件→启动容器→检查启动器是否正常→使用自动化令牌发送快捷配置文件请求。

此设置需使用自动化令牌。不要使用刷新令牌来授权启动器请求。刷新令牌仅用于获取新的常规 API 令牌。

开始前的准备

确保具备:

如果同一计算机上正在运行 Multilogin 桌面应用或代理程序,请在启动容器前关闭。它通常使用端口 45001,导致 Docker 无法绑定相同端口。

创建 Docker Compose 文件

  1. 在任意目录中为 Docker 文件创建文件夹
  2. 打开文本编辑器并粘贴以下文本:

    docker-compose.yaml

    services:
        launcher:
          image: public.ecr.aws/d3n0b1o9/mlx-launcher:mlx-latest
          ports:
            - "45001:45001"   # HTTPS REST API
            - "45003:45003"   # WSS
          restart: unless-stopped
  3. 将其保存为 docker-compose.yaml,放在步骤 1 的文件夹中

启动容器

确保至少有 500 MB 可用磁盘空间来存储镜像。

  1. 打开 Terminal 或 Command prompt(取决于操作系统)
  2. 下载 Docker 镜像。它包含预装了 Multilogin 启动器的定制 Ubuntu 环境:
    docker pull public.ecr.aws/d3n0b1o9/mlx-launcher:mlx-latest
  3. 前往包含 docker-compose.yaml 文件的文件夹,使用 cd 命令

    假设你在用户文件夹中创建了名为“container”的文件夹。Terminal 默认使用用户文件夹,此时请运行:

    cd container

  4. 输入以下命令创建容器:docker compose up -d

该命令会创建名为 %your folder%_default 的网络和名为 %your folder%-launcher-1 的容器。请复制容器名称,后续执行时需要使用。

以下是一些有用的 Docker 命令:

  • docker compose up -d——创建并启动容器
  • docker compose logs -f——显示容器中启动器状态和命令结果的日志
  • docker compose down——停止并移除容器

打开容器终端

要打开容器终端,请运行:

docker exec -it %container name% bash

如果成功,你会看到容器终端。现在你已进入容器。接下来会运行几个测试 API 命令。

终端中的 docker compose up -d 和打开 launcher 容器终端的 docker exec 命令

检查启动器是否正在运行

要从容器内部发送 API 请求,需要使用 cURL。使用以下命令确保启动器正常工作:

如果启动器正在运行,你会看到代码为 200 的响应:

{"data":{"env":"Multilogin EU","version":"master"},"status":{"error_code":"","http_code":200,"message":""}}

下文介绍如何启动和停止配置文件。更多 API 请求请参阅 Multilogin API 文档。

启动快捷配置文件

要查看配置文件能否在容器中运行,请尝试使用 POST Start Quick Profile v3 请求。需要添加包含自动化令牌的授权请求头。你可以参考以下示例,并按需修改配置文件参数。别忘了填写自动化令牌(将 YOUR_TOKEN 替换为你的自动化令牌):

包含 Start Quick Profile v3 请求的 cURL 命令

curl --location 'https://launcher.mlx.yt:45001/api/v3/profile/quick' \
--header 'Authorization: YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
  "browser_type": "mimic",
  "os_type": "macos",
  "parameters": {
    "flags": {
      "navigator_masking": "mask",
      "audio_masking": "mask",
      "localization_masking": "mask",
      "geolocation_popup": "prompt",
      "geolocation_masking": "mask",
      "timezone_masking": "mask",
      "canvas_noise": "natural",
      "graphics_noise": "natural",
      "graphics_masking": "mask",
      "webrtc_masking": "natural",
      "fonts_masking": "mask",
      "media_devices_masking": "mask",
      "screen_masking": "mask",
      "proxy_masking": "custom",
      "ports_masking": "mask"
    }
  }
}'

成功响应如下:

{"data":{"browser_type":"mimic","core_version":148,"id":"PROFILE_ID","is_quick":true},"status":{"error_code":"","http_code":200,"message":"Quick profile started successfully"}}

容器终端中的快速配置文件 cURL 请求和启动成功响应

复制配置文件 ID,停止配置文件时需要使用。

更多快捷配置文件信息请参阅:如何通过 Postman 创建 Multilogin 快捷配置文件。

停止配置文件

现在使用 GET Stop Browser Profile 请求停止配置文件。修改 PROFILE_ID 和 YOUR_TOKEN 的值:

包含 Stop Browser Profile 请求的 cURL 命令

curl --location 'https://launcher.mlx.yt:45001/api/v1/profile/stop/p/PROFILE_ID' \
--header 'Authorization: YOUR_TOKEN' \
--header 'Accept: application/json'

请求后,配置文件应停止运行。

注意:即使出现以下消息,API 仍可能已关闭配置文件:

{"status":{"error_code":"INTERNAL_SERVER_ERROR","http_code":500,"message":"profile already stopped"}}

这通常表示配置文件已经停止,无需担心。

如何使用自己的 cURL 命令

你可以使用 Multilogin API 文档中的任意请求,但需要将其调整为 cURL 格式。先复制请求:

  1. 复制并保存你的自动化令牌,用于验证 Multilogin API 请求
  2. 前往 Multilogin API 文档
  3. 展开文档库控制台中的文件夹
  4. 选择要使用的端点
  5. 将请求示例语言设为 cURL
  6. 点击“Copy”
Multilogin API 文档,已选择 cURL,并突出显示示例请求的复制按钮。

然后编辑请求:

  1. 在第一行下添加身份验证请求头:--header 'Authorization: YOUR_TOKEN' \
  2. 修改参数值。

然后复制命令,粘贴到容器内部的终端中。

文本编辑器中的快速配置文件 cURL 请求,包含认证请求头和指纹参数

其他技巧

  • 本文中的 Docker 镜像是定制的 Ubuntu 环境。如果想安装其他工具(如 Python 脚本支持),请运行以下命令,以超级用户身份操作容器:docker exec -it -u 0 %container name% bash
  • 如果需要停止容器但不移除它,请输入此命令:docker stop %container name%
  • 如果需要启动未运行的容器,请输入此命令:docker start %container name%

故障排查

no matching manifest for linux/arm64/v8

启动器镜像针对 AMD64 构建。请确保服务包含:

platform: linux/amd64

bind: address already in use

另一个进程已在使用端口 45001 或 45003。

关闭 Multilogin 桌面应用或代理程序,然后运行:

docker compose up -d

401 – Authorization error

请确保使用的是工作区自动化令牌。不要使用:

  • 刷新令牌
  • 已过期的常规 API 令牌
  • 令牌来自其他工作区

通过工作区自动化令牌生成新令牌。

BROWSER_VERSION_NOT_FOUND

Mimic 浏览器内核可能仍在下载。检查“Loaded Browser Cores”,出现 Mimic 版本后再重试。

启动请求返回 200,但配置文件未运行

检查 /api/v1/profile/statuses。

对于此 Docker 设置,请确保请求包含:

"is_headless": true

"proxy_masking": "disabled"(未提供全局IP时)

no-sandbox 和 disable-dev-shm-usage 命令参数

常见问题

可以使用常规 API 令牌吗?

此 Docker 工作流请使用工作区自动化令牌。常规 API 令牌会在 30 分钟后过期,且在测试中启动器配置文件端点未接受此类令牌。

可以使用刷新令牌吗?

不可以。刷新令牌无法授权常规 API 或启动器请求。它仅与“User Refresh Token (Switch Workspace)”一起用于获取新的常规令牌。

快捷配置文件会保存吗?

不会。快捷配置文件是临时的,停止后会移除其浏览数据。

可以使用全局IP吗?

可以。在 parameters.proxy 下添加有效的全局IP对象,并将 proxy_masking 设为 custom。如果不提供全局IP,请将 proxy_masking 保持为 disabled。

随时掌握最新动态

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

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