Introdução
Controlar o tamanho máximo de arquivos enviados via Nginx é essencial para evitar erros de upload, proteger o servidor e garantir a estabilidade de aplicações em VPS Linux e servidores dedicados. Veja como configurar o parâmetro client_max_body_size de forma segura e eficiente.
Passo a passo para definir o limite de arquivos no Nginx
- Acesse seu servidor via SSH
Utilize um terminal seguro para acessar seu VPS Linux ou servidor dedicado. - Abra o arquivo de configuração do Nginx
Normalmente localizado em/etc/nginx/nginx.confou em arquivos de sites em/etc/nginx/sites-available/.sudo nano /etc/nginx/nginx.conf - Defina o parâmetro
client_max_body_size
Adicione ou edite a linha dentro do blocohttp,serveroulocationconforme a necessidade:
Substituaclient_max_body_size 20M;20Mpelo valor desejado. - Salve e feche o arquivo
Confirme as alterações e saia do editor. - Teste a configuração do Nginx
Evite erros de sintaxe antes de reiniciar:sudo nginx -t - Recarregue o Nginx
Para aplicar as mudanças sem interromper o serviço:sudo systemctl reload nginx
Checklist rápido
- Faça backup do arquivo de configuração antes de editar.
- Escolha um valor adequado ao perfil do seu site/aplicação.
- Verifique permissões de usuário para editar arquivos do Nginx.
- Teste uploads após a alteração para garantir funcionamento.
Resolução de problemas comuns
- Erro 413 Request Entity Too Large: O valor de
client_max_body_sizeestá baixo. Aumente o limite e recarregue o Nginx. - Alteração não surte efeito: Verifique se o parâmetro foi definido no bloco correto (http, server ou location).
- Erro de sintaxe ao recarregar: Use
nginx -tpara identificar e corrigir erros no arquivo de configuração. - Permissões insuficientes: Execute os comandos como root ou com
sudo.
Resumo
- Definir
client_max_body_sizeevita falhas de upload. - Configuração flexível por site ou globalmente.
- Testar e validar após alterações garante estabilidade.
Contrate Agora
Garanta performance e segurança para seus projetos com servidores dedicados AviraHost. Suporte 24/7 e infraestrutura robusta para aplicações exigentes. Veja planos de servidor dedicado e eleve o nível do seu ambiente!