如果浏览器配置文件无法在 Linux 服务器上启动，请先通过直接的本地 API 请求测试该配置文件。如果手动启动成功，请将 API 参数与正常工作的配置文件设置进行比较。如果启动失败，请检查 agent 日志、SSL/TLS 错误以及 Xvfb/headless 配置。

➡️ 保持 Multilogin 桌面应用运行；如果您使用 Web 界面，请连接 agent → 使用 curl 启动同一个浏览器配置文件 → 检查结果 → 如果失败，请查看日志。

开始之前

请确保：

• Multilogin 桌面应用正在运行；如果您使用 Web 界面，agent 已连接
• 您知道浏览器配置文件的 folder_id 和 profile_id
• 您可以在 Linux 服务器上运行 curl 命令
• 如果您使用 headless 模式，已安装 Xvfb

手动启动配置文件

1. 打开终端
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 环境和本地 launcher 很可能工作正常。请将失败的自动化请求与这个成功的请求进行比较。

如果手动请求失败，请继续检查下面的日志、SSL/TLS 和 headless 设置。

查找并分析agent日志

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配置正确。

比较API和UI行为

1. 如果通过用户界面启动成功，但API启动失败，请检查API参数和用户界面设置（它们应该匹配）。
2. 使用相同的配置文件ID和设置，通过curl手动进行测试。

检查Linux环境设置

1. 请确保已安装并正确配置Xvfb以支持无头模式。更多详情请参阅以下文章：
   1. 如何在Multilogin中连接Agent（Linux headless下的连接）
   2. 如何自动启动Agent
2. 确认Multilogin agent或应用程序正在运行并且可以通过正确的端口访问（请参阅以下文章中的步骤： 如何修复代理连接问题）

什么方法都试过了？

如果问题仍然存在，请将您的日志文件发送给我们，我们将为您进一步调查。

1. 重现问题或等待错误消息出现。
2. 将位于此位置的日志文件夹存档：
   /home/%username%/mlx
3. 请发送电子邮件至[email protected]获取支持，邮件内容如下：
   1. 对问题的清晰描述
   2. 已附上的存档日志文件夹