跳转到内容
Multilogin帮助中心

如何用 Python 在多台服务器上运行 Multilogin API 脚本

需要在多台服务器上运行相同的 Multilogin API 脚本?通过 Python 和 SSH,你可以在一台电脑上统一运行,无需逐台连接服务器并手动启动脚本。

➡️ 生成自动化令牌→设置 SSH 访问→将 remote_api.py 添加到每台服务器→在电脑上运行 auto.py。

本示例通过获取云手机列表来检查 Multilogin API 连接。测试成功后,你可以替换测试请求,改为自己的自动化任务。

开始之前

你需要:

  • 电脑和远程服务器上安装 Python 3
  • 可通过 SSH 密钥访问每台服务器,并已验证其主机密钥
  • 有效的 Multilogin 自动化令牌
  • 每台服务器均可联网访问 Multilogin API

SSH 和 Multilogin 使用不同的凭据。SSH 密钥用于连接服务器,自动化令牌用于让脚本发送 Multilogin API 请求。

本示例使用 Linux 或 macOS 服务器
也可以使用 Windows 服务器,但需要调整文件路径和 Python 命令。

第 1 步:准备服务器

首先,确认你可以通过 SSH 连接每台服务器。

在电脑上打开终端,尝试运行:

ssh username@server-ip

将 username 和 server-ip 替换为你的信息。

首次连接时,请先与管理员核对服务器的 SSH 指纹,再信任该服务器。

接下来,安装 Python 库。

在你的电脑上:

python3 -m pip install paramiko

在每台远程服务器上:

python3 -m pip install requests

如果使用 Python 虚拟环境,请在该环境中安装库,并使用该环境运行脚本。

第 2 步:创建 Multilogin API 脚本

先进行简单测试,向 Multilogin API 请求云手机列表,确认每台服务器都能连接。

在每台远程服务器的主目录中创建名为 remote_api.py 的文件。

import sys
import requests

token = sys.stdin.readline().strip()

if not token:
    raise SystemExit("No automation token provided.")

url = "https://api.multilogin.com/mobile_profiles/phone/list"

headers = {
    "Authorization": f"Bearer {token}",
    "Accept": "application/json",
}

params = {
    "page": 1,
    "page_size": 10,
}

try:
    response = requests.get(
        url,
        headers=headers,
        params=params,
        timeout=30,
    )
    response.raise_for_status()

    result = response.json()
    status = result.get("status", {})

    if status.get("http_code") != 200:
        raise RuntimeError(
            status.get("message", "Unknown API error")
        )

    print("Connected to Multilogin API successfully.")

except (requests.RequestException, ValueError, RuntimeError) as error:
    print(f"API request failed: {error}")
    raise SystemExit(1)

脚本运行时会接收自动化令牌。你无需在文件中保存 Multilogin 邮箱、密码或令牌。

此测试不会更改配置文件。它只请求云手机列表的第一页。

第 3 步:创建服务器连接脚本

现在,将各部分连接起来。

在电脑上创建 auto.py。该脚本会连接每台服务器、传入自动化令牌,并运行 remote_api.py。

import sys
import getpass
import paramiko

servers = [
    {"username": "username1", "host": "server1-ip", "port": 22},
    {"username": "username2", "host": "server2-ip", "port": 22},
]

token = getpass.getpass("Multilogin automation token: ")

if not token:
    raise SystemExit("No automation token provided.")

failed_servers = []

for server in servers:
    username = server["username"]
    host = server["host"]
    port = server.get("port", 22)

    print(f"\nConnecting to {username}@{host}")

    try:
        with paramiko.SSHClient() as ssh:
            ssh.load_system_host_keys()
            ssh.set_missing_host_key_policy(
                paramiko.RejectPolicy()
            )

            ssh.connect(
                hostname=host,
                port=port,
                username=username,
                look_for_keys=True,
                allow_agent=True,
                timeout=15,
            )

            stdin, stdout, stderr = ssh.exec_command(
                "python3 ~/remote_api.py"
            )

            stdin.write(token + "\n")
            stdin.flush()
            stdin.channel.shutdown_write()

            output = stdout.read().decode().strip()
            errors = stderr.read().decode().strip()
            exit_code = stdout.channel.recv_exit_status()

            if output:
                print(output)

            if errors:
                print(errors)

            if exit_code != 0:
                print(f"Script failed with code {exit_code}")
                failed_servers.append(host)

    except Exception as error:
        print(f"Connection failed: {error}")
        failed_servers.append(host)

if failed_servers:
    print("\nFailed servers: " + ", ".join(failed_servers))
    sys.exit(1)

将示例中的用户名、服务器地址和端口替换为你自己的值。

脚本使用 SSH 密钥,因此无需在代码中填写服务器密码。连接前,它也会检查服务器是否可信。

第 4 步:运行脚本

准备好后,就可以检查连接了。

  1. 在电脑上打开终端
  2. 进入包含 auto.py 的文件夹
  3. 运行:
python3 auto.py
  1. 按提示输入自动化令牌。
  2. 查看每台服务器的结果。
  3. 如果服务器连接成功,你会看到:
Connected to Multilogin API successfully.

如果出现问题,脚本会显示哪台服务器失败。

输入令牌时不会显示字符,脚本也不会打印或保存令牌。

第 5 步:添加自己的自动化任务

测试通过后,你就可以执行连接检查以外的任务。

将 remote_api.py 中的测试请求替换为所需的 Multilogin API 操作。

例如,你可以:

  • 获取云手机或浏览器配置文件列表
  • 检查哪些配置文件正在运行
  • 创建或更新配置文件
  • 启动或停止受支持的配置文件

例如,你在多台服务器上管理账户,可以通过此设置统一检查配置文件状态,无需逐台连接。

可用端点、必填参数和响应示例均在 Multilogin API 文档中。

使用本地启动器端点?
如果脚本通过本地启动器 API 启动或控制浏览器配置文件,服务器上必须运行所需的 Multilogin 桌面组件。仅连接云端 API 不会启动桌面应用。

故障排查

SSH 连接失败

尝试手动连接:

ssh username@server-ip

如果仍无法连接,请检查 SSH 密钥,并确认你有权访问服务器。

如果出现未知主机密钥错误,请验证服务器指纹,将其加入受信任的 SSH 主机后重试。

Python 找不到库

确认已在正确的位置安装正确的库:

  • 你的电脑: paramiko
  • 远程服务器: requests

如果使用虚拟环境,请确认通过正确的 Python 解释器运行脚本。

Multilogin API 返回错误

先查看错误消息。常见响应如下:

  • 401 – Unauthorized:自动化令牌可能缺失、不正确或已过期
  • 403 – Forbidden:你的工作区或角色可能没有发送此请求的权限
  • 429 – Too Many Requests:工作区已达到 API 速率限制

更多帮助请参阅Multilogin API 速率限制与响应代码。

Python 无法验证 API 证书

如果使用公司代理或自定义网络配置,Python 可能无法识别连接所用的证书。

请向管理员索取批准的证书颁发机构(CA)证书包,并配置 Requests 使用该证书包。

不要关闭证书验证。它用于保护你的连接。

妥善保管自动化令牌

只在你信任的服务器上运行这些脚本。

自动化令牌通过加密 SSH 连接传输,但远程脚本在运行时可以访问它。控制服务器的人可能截获该令牌,并利用其工作区权限。

随时掌握最新动态

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

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