跳转到内容
Multilogin帮助中心

如何解决 Multilogin 的 Linux 服务器问题

如果浏览器配置文件无法在 Linux 服务器上启动,请先直接发送本地 API 请求进行测试。如果能手动启动,请对比你的 API 参数与正常运行的配置文件设置。如果启动失败,请检查代理程序日志、SSL/TLS 错误以及 Xvfb/无头模式设置。

➡️ 保持 Multilogin 桌面应用运行;如果使用网页界面,则连接代理程序 → 使用 同一个浏览器配置文件通过 curl 启动 → 检查结果 → 如果失败,查看日志。

开始前

请确认:

  • Multilogin 桌面应用正在运行;如果使用网页界面,则代理程序已连接
  • 你知道该浏览器配置文件的 folder_id 和 profile_id
  • 你可以在 Linux 服务器上运行 curl 命令
  • 如果使用无头模式,已安装 Xvfb

手动启动配置文件

保持桌面应用打开(如果使用网页界面,则连接代理程序)。

  1. 打开 Terminal
  2. 运行以下命令(分别替换 folder_id 和 profile_id):
    curl -X GET https://localhost:45000/api/v2/profile/f/<folder_id>/p/<profile_id>/start
  3. 检查配置文件是否成功启动

预期结果:配置文件成功启动,API 返回启动响应。

  • 如果手动发送 curl 请求成功,Linux 环境和本地启动器很可能运行正常。请将失败的自动化请求与这个成功请求进行对比。
  • 如果手动请求失败,请继续执行以下日志、SSL/TLS 和无头模式检查。

查找并分析代理程序日志

  1. 前往以下任一目录:
    1. /opt/usr/mlx/
    2. /home/%username%/mlx/logs
  2. 查找 launcher_<date>.log 和 agent_<date>.log

排查 SSL/TLS 错误

  1. 检查日志中是否出现“Bad record MAC”错误:SSL: DECRYPTION_FAILED_OR_BAD_RECORD_MAC
  2. 确保 Linux 服务器的 OpenSSL 配置正确

有关 OpenSSL 配置的更多信息,请参阅:Open SSL - Ubuntu Server 文档

对比 API 和界面的运行情况

  1. 如果通过界面可以启动,但 API 启动失败,请检查 API 参数与界面设置是否一致
  2. 使用相同的配置文件 ID 和设置,通过 curl 手动测试

有关 curl 命令,请参阅“手动启动配置文件”部分;有关 GET Start Browser Profile 端点的信息,请参阅我们的API 文档。

检查 Linux 环境设置

  1. 确保已安装 Xvfb,并为无头模式正确配置。更多信息请参阅以下文章:
    1. 如何在 Multilogin 中连接代理程序(Linux 无头模式连接)
    2. 在 Linux 中配置代理程序的无头模式和自动启动
  2. 确认 Multilogin 代理程序或应用正在运行,并可通过正确的端口访问(参阅以下文章中的步骤:如何解决代理程序连接问题)

仍然无法解决?

如果问题仍然存在,请发送日志文件,我们会进一步帮你排查。

  1. 重现问题,或等待错误消息出现
  2. 将以下位置的 logs 文件夹打包:
    /home/%username%/mlx
  3. 发送邮件至 [email protected],并提供:
    1. 清晰的问题描述
    2. 打包后的 logs 文件夹附件

本文包含第三方链接,我们并未正式认可这些网站。

随时掌握最新动态

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

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