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.

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
- O arquivo de 25 MB nunca chega ao servidor com 25 MB
- Os três tetos que a agência trata como um só
- Descobrir se a recusa veio da origem ou do destino
- Ajustar o teto de origem no WHM
- O que pedir ao provedor quando você não tem WHM
- A regra dos 10 MB que evita rediagnosticar o mesmo caso
- 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.
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?
- Erro imediato, mensagem parada na caixa de saída: seu servidor recusou no momento do envio. A recusa pode vir logo no
MAIL FROM, quando o cliente anuncia o tamanho pela extensão SIZE, ou ao fim doDATA, quando o servidor conta os bytes que chegaram. Nos dois casos existe algo a ajustar do seu lado. - Mensagem consta em Enviados e um retorno chega segundos ou minutos depois: seu servidor aceitou e tentou entregar. Quem recusou foi o destino, ou algum salto no meio.
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.
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:
- Qual é o
message_size_limitaplicado ao servidor da conta, em MB. - Se esse limite pode ser elevado para a conta ou se é global do servidor.
- Qual é o limite de upload do webmail (
upload_max_filesizeepost_max_sizeda 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
- Documentação oficial (cpanel) — Exim Configuration Manager: Basic Editor. Consultado em 2026-09-25.