Ao configurar o envio de e-mails no MagnusBilling, a causa mais comum de travamentos ou falhas não é o próprio sistema, mas sim um problema de conectividade entre o servidor e o provedor externo de SMTP. Para economizar tempo, é recomendável testar a conexão SMTP antes de registrar as credenciais no MagnusBilling. Este guia mostra como realizar esses testes diretamente no servidor.
1) Verificar se a Porta SMTP Está Aberta
A maioria dos provedores utiliza uma destas portas:
- 465 (SSL/TLS)
- 587 (STARTTLS)
- 2525 (porta alternativa em alguns provedores)
Execute no servidor MagnusBilling:
nc -vz -w5 smtp.your_domain.com 465
nc -vz -w5 smtp.your_domain.com 587
nc -vz -w5 smtp.your_domain.com 2525
Se o resultado mostrar succeeded!, a porta está aberta. Se aparecer Connection timed out ou Connection refused, o datacenter ou firewall está bloqueando o SMTP de saída.
2) Testar o Handshake TLS/SSL com OpenSSL
Porta 465 (SSL/TLS direto)
openssl s_client -connect smtp.your_domain.com:465 -servername smtp.your_domain.com -crlf -quiet
Porta 587 (STARTTLS)
openssl s_client -starttls smtp -connect smtp.your_domain.com:587 -servername smtp.your_domain.com -crlf -quiet
Resultado esperado:
- Banner iniciando com
220 ... ESMTP - Certificado válido:
Verify return code: 0 (ok)
Se a conexão travar ou falhar antes do banner ou da validação, possivelmente a porta está bloqueada pelo datacenter.
3) Realizar um Teste Completo de Autenticação com Swaks
Swaks é uma ferramenta em linha de comando que simula toda a transação SMTP. Instale e rode:
apt install swaks -y
Exemplo (substitua pelas suas credenciais):
swaks --server smtp.your_domain.com --port 465 \
--auth LOGIN \
--auth-user user@your_domain.com \
--auth-password 'suasenha' \
--tls
O teste mostrará claramente se o problema está no DNS, TCP, TLS ou autenticação.
4) Problemas Comuns e Soluções
- Datacenter bloqueia SMTP de saída (465/587)
Abra um chamado pedindo a liberação. Se não for possível, verifique se o provedor oferece a porta 2525. - Problemas no handshake TLS
Confirme se a data/hora do servidor estão corretas e atualize os certificados CA:apt update && apt install ca-certificates -y - Falha na autenticação
Verifique usuário e senha. Alguns provedores exigem que o campo From corresponda ao usuário autenticado.
5) Configurar no MagnusBilling
Somente após confirmar que o servidor SMTP responde corretamente você deve configurá-lo no MagnusBilling. Isso garante que os e-mails sejam enviados sem travar por causa de restrições de rede ou erros de TLS.
Conclusão: Testar o SMTP com nc, openssl e swaks antes de configurar no MagnusBilling é a forma mais rápida de identificar problemas de conectividade e garantir envios confiáveis desde o início.
