如何用 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 步:运行脚本
准备好后,就可以检查连接了。
- 在电脑上打开终端
-
进入包含
auto.py的文件夹 - 运行:
python3 auto.py- 按提示输入自动化令牌。
- 查看每台服务器的结果。
- 如果服务器连接成功,你会看到:
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 连接传输,但远程脚本在运行时可以访问它。控制服务器的人可能截获该令牌,并利用其工作区权限。