如何解决 Multilogin 的 Linux 服务器问题
如果浏览器配置文件无法在 Linux 服务器上启动,请先直接发送本地 API 请求进行测试。如果能手动启动,请对比你的 API 参数与正常运行的配置文件设置。如果启动失败,请检查代理程序日志、SSL/TLS 错误以及 Xvfb/无头模式设置。
➡️ 保持 Multilogin 桌面应用运行;如果使用网页界面,则连接代理程序 → 使用 同一个浏览器配置文件通过 curl 启动 → 检查结果 → 如果失败,查看日志。
开始前
请确认:
- Multilogin 桌面应用正在运行;如果使用网页界面,则代理程序已连接
- 你知道该浏览器配置文件的
folder_id和profile_id - 你可以在 Linux 服务器上运行
curl命令 - 如果使用无头模式,已安装 Xvfb
手动启动配置文件
- 打开 Terminal
- 运行以下命令(分别替换
folder_id和profile_id):curl -X GET https://localhost:45000/api/v2/profile/f/<folder_id>/p/<profile_id>/start - 检查配置文件是否成功启动
预期结果:配置文件成功启动,API 返回启动响应。
- 如果手动发送
curl请求成功,Linux 环境和本地启动器很可能运行正常。请将失败的自动化请求与这个成功请求进行对比。 - 如果手动请求失败,请继续执行以下日志、SSL/TLS 和无头模式检查。
查找并分析代理程序日志
- 前往以下任一目录:
/opt/usr/mlx//home/%username%/mlx/logs
- 查找
launcher_<date>.log和agent_<date>.log
排查 SSL/TLS 错误
- 检查日志中是否出现“Bad record MAC”错误:
SSL: DECRYPTION_FAILED_OR_BAD_RECORD_MAC - 确保 Linux 服务器的 OpenSSL 配置正确
有关 OpenSSL 配置的更多信息,请参阅:Open SSL - Ubuntu Server 文档
对比 API 和界面的运行情况
- 如果通过界面可以启动,但 API 启动失败,请检查 API 参数与界面设置是否一致
- 使用相同的配置文件 ID 和设置,通过
curl手动测试
有关 curl 命令,请参阅“手动启动配置文件”部分;有关 GET Start Browser Profile 端点的信息,请参阅我们的API 文档。
检查 Linux 环境设置
- 确保已安装 Xvfb,并为无头模式正确配置。更多信息请参阅以下文章:
- 确认 Multilogin 代理程序或应用正在运行,并可通过正确的端口访问(参阅以下文章中的步骤:如何解决代理程序连接问题)
仍然无法解决?
如果问题仍然存在,请发送日志文件,我们会进一步帮你排查。
- 重现问题,或等待错误消息出现
- 将以下位置的 logs 文件夹打包:
/home/%username%/mlx - 发送邮件至 [email protected],并提供:
- 清晰的问题描述
- 打包后的 logs 文件夹附件
本文包含第三方链接,我们并未正式认可这些网站。