blog
Painéis

Limite de anexo de e-mail no cPanel: três tetos, um sintoma

Base64, WHM e código de retorno. Como decidir em 30 segundos se o problema é o seu servidor ou o do destinatário, e o que padronizar na carteira de clientes.

JR · · 9 min de leitura · 4 tabelas · 3 blocos de código

Resposta curta: um anexo de 25 MB chega ao servidor com cerca de 33 MB, porque o base64 infla a mensagem em torno de 33%. O teto que você controla é o de origem (Exim) e, em parte, o da composição (webmail e PHP). O do destinatário, não.

Neste artigo
  1. O arquivo de 25 MB nunca chega ao servidor com 25 MB
  2. Os três tetos que a agência trata como um só
  3. Descobrir se a recusa veio da origem ou do destino
  4. Ajustar o teto de origem no WHM
  5. O que pedir ao provedor quando você não tem WHM
  6. A regra dos 10 MB que evita rediagnosticar o mesmo caso
  7. A frase que explica ao cliente por que o e-mail voltou

O arquivo de 25 MB nunca chega ao servidor com 25 MB

Anexo em e-mail não viaja como binário. O MIME codifica o arquivo em base64, que representa 3 bytes originais com 4 caracteres ASCII. A conta é direta: o corpo codificado fica cerca de 33% maior que o arquivo, mais as quebras de linha, os cabeçalhos, os delimitadores de parte e o texto da própria mensagem.

É por isso que a conversa com o cliente trava. Ele anexou um PDF de 25 MB, o servidor recusou uma mensagem de 33 MB e ninguém está mentindo.

Arquivo original Depois do base64 (≈ +33%) Teto mínimo (× 1,4) Valor redondo usado na prática
5 MB ≈ 6,7 MB 7 MB 10 MB
10 MB ≈ 13,3 MB 14 MB 20 MB
25 MB ≈ 33,3 MB 35 MB 40 MB
50 MB ≈ 66,7 MB 70 MB 80 MB

A regra que importa: multiplique o maior anexo que o cliente precisa mandar por 1,4. Esse é o piso, o valor abaixo do qual a mensagem não passa. O 1,4 cobre o base64 e deixa uma sobra pequena para cabeçalhos. A última coluna é só o arredondamento para cima em número redondo, que é o que a maioria das equipes acaba configurando para não ter que refazer a conta quando o cliente anexa dois arquivos em vez de um, ou uma assinatura com imagem. Nenhum dos dois valores é recomendação universal: são dimensionamento.

Há ainda a ambiguidade de unidade. Alguns painéis e MTAs tratam "M" como mebibyte (1.048.576 bytes) e outras interfaces mostram megabyte decimal. A diferença é pequena, mas ela existe exatamente na fronteira, que é onde o e-mail costuma bater. Mais um motivo para não configurar o teto rente ao tamanho do arquivo.

Os três tetos que a agência trata como um só

O sintoma é sempre o mesmo ("o e-mail não sai"), mas os limites são três, em camadas diferentes, com donos diferentes.

Teto Onde mora Quem ajusta Sintoma típico
Servidor de origem message_size_limit do Exim, no servidor que hospeda a conta quem tem WHM (root) ou o provedor erro no ato do envio, a mensagem nem sai da caixa
Composição do cliente Outlook desktop, webmail Roundcube, Gmail web, app do celular parcialmente ajustável (webmail e PHP), fixo em interfaces de terceiros o programa recusa o anexo antes de enviar
Servidor do destinatário MTA de quem recebe (Gmail, Microsoft 365, servidor próprio do cliente dele) ninguém do seu lado a mensagem sai, some por minutos e volta com um retorno

Ajustar o primeiro teto é trabalho de cinco minutos. O segundo você ajusta em parte. Ajustar o terceiro é impossível. Se você não separar origem de destino antes de mexer em qualquer coisa, vai aumentar o limite do servidor, pedir para o cliente tentar de novo e receber o mesmo retorno, agora com a sua credibilidade envolvida.

Onde moram os três tetos de anexoServidor de origemExim do servidor que hospedaPrograma de composiçãoOutlook, webmail, app do celularServidor do destinatárioMTA de quem recebe
Três tetos em camadas diferentes, com donos diferentes. Só o primeiro é ajuste rápido do seu lado.

Descobrir se a recusa veio da origem ou do destino

O atalho que resolve a maioria dos casos antes de abrir log

Pergunte uma coisa só: o erro apareceu na hora de clicar em enviar, ou a mensagem saiu e voltou depois?

Esse teste erra em um caso: clientes que fazem envio assíncrono e transformam a recusa imediata em retorno. Por isso, confirme no texto do retorno.

O que o código de recusa diz e o que ele não decide

O retorno (DSN) traz um cabeçalho Diagnostic-Code e, quase sempre, o nome do host que respondeu. É ali que a dúvida acaba.

Trecho no retorno Leitura
552 5.3.4 message size exceeds fixed maximum message size limite fixo do MTA que respondeu; confira qual host respondeu
550 5.2.3 ou 552 5.2.3, "message length exceeds administrative limit" limite de política, também no MTA que respondeu
SMTP error from remote mail server after end of data: seguido de um host que não é o seu recusa na entrada, do lado do destinatário
Erro exibido pelo cliente de e-mail, sem mensagem de retorno recusa na saída, pelo seu servidor

O texto exato varia por provedor, e o mesmo par de códigos pode aparecer nos dois lados. O número não decide nada. O que decide é de quem é o host que respondeu.

Onde achar esse host: no cabeçalho Remote-MTA do DSN, e no próprio Diagnostic-Code, no nome que aparece entre host e o código de resposta. Não use o Reporting-MTA para isso: ele identifica o servidor que gerou o aviso de retorno, que quase sempre é o seu próprio servidor de origem. Ler o Reporting-MTA como culpado é o jeito mais rápido de inverter o diagnóstico e mexer no lugar errado. Se o Remote-MTA for o MX do destinatário, acabou: o problema está lá.

Confirmar no exim_mainlog quando você tem root

Com acesso de root no servidor, dois comandos resolvem. O primeiro mostra o teto que o Exim está aplicando de fato, não o que a interface diz:

exim -bP message_size_limit

O segundo procura a recusa no log principal, filtrando pelo endereço do remetente ou do destinatário:

grep -i '[email protected]' /var/log/exim_mainlog | tail -20

Se a linha de rejeição vier do seu próprio Exim, o teto de origem é o culpado. Se a linha mostrar a resposta de um host remoto, você já tem a frase pronta para mandar ao cliente, com o nome do servidor que recusou.

Origem ou destino: caminho do diagnósticoErro na hora de enviar?Mensagem parada na caixa de saídaSim: recusa na origemConfirme com exim -bP message_size_limitNão: chegou retorno (DSN)Abra os cabeçalhos do retornoLeia o Remote-MTAIgnore o Reporting-MTA no diagnósticoHost é o MX do destinoNada a ajustar do seu lado
O código da recusa não decide nada. Quem decide é o host que respondeu.

Ajustar o teto de origem no WHM

No WHM, as opções do Exim ficam em Service Configuration » Exim Configuration Manager, que a documentação do cPanel divide em Basic Editor e Advanced Editor. O Basic Editor expõe as opções mais comuns em formulário; o Advanced Editor permite escrever diretivas do Exim diretamente.

Descobrir o teto que o Exim aplica de fato

Antes de mudar qualquer coisa, rode exim -bP message_size_limit. Anote o valor. Sem esse número você não sabe se o ajuste funcionou nem tem como voltar atrás.

Alterar o message_size_limit no Basic ou no Advanced Editor

Abra o Basic Editor e verifique se existe ali a opção de tamanho máximo de mensagem. Se existir, use ela: é o caminho que o WHM valida e reconstrói sozinho. Se não existir na sua versão, vá ao Advanced Editor e defina a diretiva message_size_limit na seção de configuração do Exim. O nome da diretiva é o mesmo nos dois casos, e é ele que o exim -bP vai devolver depois.

A posição exata da opção muda entre versões do WHM. Trate isso como nota, não como instrução: se o rótulo não estiver onde você esperava no Basic Editor, o Advanced Editor resolve sempre.

Defina o valor com folga sobre o base64: para um anexo de 25 MB, o piso é 35 MB e 40 MB é um ponto de partida razoável (dimensionamento, não número oficial). Salve e deixe o WHM reconstruir a configuração do Exim.

O valor 0 desativa a checagem. Não use 0 em servidor com contas de cliente: sem teto, uma mensagem gigante trava fila, enche disco e derruba a entrega das outras. Um limite alto e explícito é melhor que nenhum limite.

Confirme o resultado com o mesmo exim -bP message_size_limit. Se a saída não mudou, a configuração não foi aplicada; descubra por quê antes de pedir novo teste ao cliente.

O limite do webmail é outro e mora no PHP do painel

O Exim aceitar 40 MB não significa que o Roundcube deixe anexar 25 MB. O webmail é uma aplicação PHP e obedece a upload_max_filesize, post_max_size e, dependendo do caso, memory_limit. O post_max_size precisa ser maior que a soma dos anexos mais o corpo, não igual ao maior arquivo.

Detalhe que consome tempo de agência: em cPanel, o webmail roda sob a instalação de PHP do próprio painel, não sob a versão de PHP que você escolheu para o site no MultiPHP INI Editor. Mexer no .user.ini do site não muda o limite do Roundcube. Se o envio pelo cliente de e-mail funciona e pelo webmail não, é aí que está.

Validar com um arquivo de tamanho conhecido

Gere um arquivo de tamanho conhecido, anexe e envie para um endereço seu em outro provedor:

dd if=/dev/zero of=teste-24mb.bin bs=1M count=24

Se passar, documente o valor. Se voltar, releia o retorno: agora o host no Remote-MTA deve ser o do destino, e você acabou de trocar um problema seu por um problema de terceiro, o que é progresso.

O que pedir ao provedor quando você não tem WHM

Sem root, o teto do Exim é do provedor e não aparece no cPanel. Nesse cenário, o chamado bem escrito economiza dois dias de ida e volta.

O que pedir, nessa ordem:

  1. Qual é o message_size_limit aplicado ao servidor da conta, em MB.
  2. Se esse limite pode ser elevado para a conta ou se é global do servidor.
  3. Qual é o limite de upload do webmail (upload_max_filesize e post_max_size da instalação que roda o Roundcube).

Anexe ao chamado o retorno completo, com cabeçalhos, e a linha do Diagnostic-Code. Isso reduz o chamado a uma pergunta objetiva.

O que não adianta pedir: que o provedor libere a entrega em um destino que recusou. Se o Remote-MTA do retorno é o MX do Gmail, do Microsoft 365 ou do servidor do cliente do seu cliente, nenhum provedor de origem tem como aceitar por eles. Pedir isso só queima tempo.

A regra dos 10 MB que evita rediagnosticar o mesmo caso

Tratar caso a caso é o que torna esse problema caro. Ele é recorrente e previsível, então vira política.

Regra geral: anexo até 10 MB vai anexado; acima disso, vai como link de download com expiração. O 10 MB não é mágico, é o valor que passa em praticamente qualquer destino depois da inflação do base64 (≈ 13,3 MB) sem depender do teto de ninguém.

Para o link, três caminhos que você já tem: uma pasta protegida no próprio site do cliente, o armazenamento em nuvem que ele já paga, ou um plugin de entrega de arquivos no WordPress. O ganho colateral é rastreabilidade: você sabe se o arquivo foi baixado, coisa que o anexo não diz.

Mantenha uma planilha única da carteira, com uma linha por cliente:

Campo Para que serve
Provedor de e-mail do cliente define quem controla o teto de origem
Teto de origem confirmado (MB) evita rediagnosticar o mesmo caso
Data da última verificação o provedor pode mudar o valor sem aviso
Destinos críticos e limite publicado clientes que mandam sempre para o mesmo órgão ou empresa
Método padrão para arquivo grande link, nuvem, pasta no site

Preencha na implantação, não na emergência. A verificação leva um minuto por conta com exim -bP ou com um teste de envio, e transforma um chamado de meia hora em uma consulta de dez segundos.

A frase que explica ao cliente por que o e-mail voltou

O ponto mais difícil não é técnico. É explicar que a agência mexeu no servidor, cobrou pelo serviço, e o e-mail voltou mesmo assim.

Texto pronto, para copiar e adaptar:

Duas coisas fazem essa frase funcionar. Ela mostra o código real do retorno, o que tira a conversa do campo da opinião. E ela termina com o que fazer, não com o que não deu.

Se o retorno apontar o seu próprio servidor, a frase é outra e é curta: o limite era nosso, foi ajustado para [X] MB, pode reenviar.

Referências

  1. Documentação oficial (cpanel) — Exim Configuration Manager: Basic Editor. Consultado em 2026-09-25.
Leia também