Pular para o conteúdo
MultiloginCentral de ajuda

Como corrigir problemas de servidor Linux no Multilogin

Se os perfis de navegador não iniciarem em um servidor Linux, primeiro teste o perfil com uma solicitação de API local direta. Se a inicialização manual funcionar, compare os parâmetros da API com as configurações do perfil que funciona. Se falhar, verifique os logs do agente, erros de SSL/TLS e a configuração do Xvfb/headless.

➡️ Mantenha o aplicativo desktop do Multilogin em execução ou conecte o agente se você usa a interface web → inicie o mesmo perfil de navegador com curl → verifique o resultado → se falhar, revise os logs.

Antes de começar

Verifique se:

  • O aplicativo desktop do Multilogin está em execução ou o agente está conectado, se você usa a interface web
  • Você sabe o folder_id e o profile_id do perfil de navegador
  • Você pode executar comandos curl no servidor Linux
  • O Xvfb está instalado se você usa o modo headless

Iniciar perfis manualmente

Mantenha o aplicativo para desktop aberto (ou conecte o agente se estiver usando a interface web).

  1. Terminal de lançamento
  2. Execute o seguinte comando (substitua folder_id e profile_id, respectivamente):
    curl -X GET https://localhost:45000/api/v2/profile/f/<folder_id>/p/<profile_id>/start
  3. Verifique se o perfil foi iniciado com sucesso

Resultado esperado: o perfil é iniciado com sucesso e a API retorna a resposta de inicialização.

Se a solicitação manual com curl funcionar, o ambiente Linux e o launcher local provavelmente estão funcionando corretamente. Compare a solicitação de automação que falhou com essa solicitação que funciona.

Se a solicitação manual falhar, continue com as verificações de logs, SSL/TLS e headless abaixo.

Localizar e analisar registros do agente

  1. Acesse um dos seguintes diretórios:
    1. /opt/usr/mlx/
    2. /home/%username%/mlx/logs
  2. Procure pelos launcher_<date>.log e agent_<date>.log

Investigar erros de SSL/TLS

  1. Verifique se há erros de "MAC de registro inválido" nos logs: SSL: DECRYPTION_FAILED_OR_BAD_RECORD_MAC
  2. Certifique-se de que a configuração OpenSSL do servidor Linux esteja correta.

Leia mais detalhes sobre a configuração do OpenSSL aqui: Open SSL - Ubuntu Server documentation

Comparar o comportamento API e da interface do usuário

  1. Se o lançamento pela interface do usuário funcionar, mas API falhar, verifique os parâmetros API e as configurações da interface do usuário (eles devem ser iguais).
  2. Faça o teste manualmente usando o mesmo ID de perfil e configurações via curl

Para obter informações sobre o comando curl, consulte o capítulo "Iniciar perfis manualmente" e as informações sobre o endpoint GET Start Browser Profile em nossa documentação de API.

Verifique a configuração do ambiente Linux

  1. Certifique-se de que o Xvfb esteja instalado e configurado corretamente para o modo headless. Consulte os seguintes artigos para obter mais detalhes:
    1. Como conectar o agente no Multilogin (conexão em Linux headless)
    2. Iniciando o agente automaticamente
  2. Confirme se o agente ou aplicativo Multilogin está em execução e acessível pela porta correta (consulte a etapa no seguinte artigo: Como corrigir problemas de conexão do agente).

Nada funciona?

Se o problema persistir, envie-nos seus arquivos de registro e investigaremos o caso mais a fundo.

  1. Recrie o problema ou aguarde até que a mensagem de erro apareça.
  2. Arquive a pasta de registros encontrada neste local:
    /home/%username%/mlx
  3. Envie um e-mail para [email protected] com as seguintes informações:
    1. Uma descrição clara do problema
    2. A pasta de registros arquivados está anexada.

Este artigo inclui links de terceiros que não endossamos oficialmente.

Fique por dentro

Veja as últimas atualizações, troque dicas e explore casos de uso práticos.

Novidades do produtoCanal no TelegramPergunte a outrosChat no TelegramExplore casos de usoComunidade no Discord