Virus Scanner no cPanel: ativar sem estourar a RAM
O plugin ClamAV no WHM, a Feature List que faz o ícone aparecer para o cliente e o critério para desligar o daemon residente quando ele passa a competir com MySQL e PHP.

Resposta curta: instale o plugin `clamavconnector` em WHM → cPanel → Manage Plugins e libere o recurso de varredura de vírus na Feature List de cada pacote. Só com as duas etapas o ícone Virus Scanner aparece no cPanel da conta. É varredura sob demanda, não proteção em tempo real.
Neste artigo
- O que o Virus Scanner do cPanel detecta e o que ele não impede
- Instalar o plugin clamavconnector pelo WHM e conferir os binários
- Marcar o recurso na Feature List certa para o ícone aparecer
- Qual escopo de varredura vale a pena e qual só gasta I/O
- O que o daemon clamd custa em memória residente
- Quando desligar o daemon e ainda assim manter a varredura
- Como explicar ao cliente que o botão sumiu do painel
- Checklist de 10 itens para padronizar vários servidores
- Cinco erros que fazem você perder a tarde no lugar errado
O que o Virus Scanner do cPanel detecta e o que ele não impede
O botão que o cliente procura em cPanel → Avançado → Virus Scanner não existe por padrão. Ele aparece quando duas coisas estão feitas no servidor: o plugin clamavconnector instalado no WHM e o recurso liberado na Feature List do pacote daquela conta. Faltando qualquer uma, o ícone some e o cliente abre chamado dizendo que "o antivírus do cPanel desapareceu".
Antes de ligar, alinhe a expectativa. Segundo a documentação oficial do cPanel, o ClamAV Scanner é uma varredura sob demanda: o usuário escolhe o escopo, clica em escanear e recebe a lista do que o ClamAV classificou como infectado. Não é proteção em tempo real, não bloqueia upload, não impede que um plugin WordPress desatualizado seja explorado às três da manhã. É um detector que roda quando alguém manda rodar.
Isso muda a conversa com o cliente. Vender "antivírus no servidor" como camada de segurança cria a expectativa errada e, pior, cria a desculpa errada quando o site é invadido. O papel real da ferramenta é triagem: confirmar rapidamente se há webshell conhecida no home, apontar arquivos para inspeção e dar um ponto de partida antes da limpeza manual.
Instalar o plugin clamavconnector pelo WHM e conferir os binários
O caminho documentado é WHM → cPanel → Manage Plugins, marcar clamavconnector e instalar. O WHM baixa, compila e configura o ClamAV junto com o conector que expõe a interface no cPanel.
Se preferir pela linha de comando, existe um caminho alternativo com os scripts de manutenção de RPM do cPanel. Ele não consta na página de configuração do ClamAV Scanner citada acima, então trate como procedimento operacional e valide o resultado depois pelo Manage Plugins:
/usr/local/cpanel/scripts/update_local_rpm_versions --edit target_settings.clamav installed
/usr/local/cpanel/scripts/check_cpanel_rpms --fix --targets=clamav
Depois da instalação, confirme que o binário e o daemon existem antes de prometer qualquer coisa ao cliente:
which clamscan clamdscan freshclam
systemctl status clamd
clamscan --version
O clamscan --version devolve a versão do engine e a versão da base de assinaturas. Se a base aparecer como desatualizada ou ausente, o scanner roda e não acha nada, o que é pior que não ter scanner: dá falsa segurança.
Rodar o freshclam uma vez antes de prometer resultado ao cliente
freshclam
Rode uma vez manualmente logo após instalar. O download inicial das bases é grande e demorado. Se ele falhar por rede ou por mirror, você descobre agora e não quando o cliente estiver esperando resultado.
Marcar o recurso na Feature List certa para o ícone aparecer
Instalar o plugin não coloca o ícone no cPanel de ninguém. O controle é por WHM → Packages → Feature Manager, no recurso de varredura de vírus, e cada pacote de hospedagem aponta para uma Feature List.
Para agência e revenda, o erro clássico é editar a lista default achando que resolve todo mundo. Quem tem pacote apontando para outra lista continua sem o botão. O procedimento que evita retrabalho:
- Liste as Feature Lists existentes em WHM → Packages → Feature Manager.
- Decida em quais o Virus Scanner entra. Sugestão: liberar nos pacotes de clientes que você mesmo administra e deixar fora de pacotes revendidos sem suporte, para não gerar expectativa que você não vai atender.
- Edite cada lista escolhida e marque o recurso.
- Confirme em WHM → Packages → Edit a Package qual lista cada pacote usa.
- Teste entrando no cPanel de uma conta real de cada pacote.
O passo 5 não é formalidade. É o único que prova que o cliente vai ver o botão.
| Camada | Onde se configura | Efeito se faltar |
|---|---|---|
| Plugin ClamAV | WHM → Manage Plugins | Nenhuma conta tem o recurso, nem com Feature List marcada |
| Recurso na Feature List | WHM → Feature Manager | Plugin instalado, mas ícone ausente no cPanel |
| Pacote apontando para a lista | WHM → Edit a Package | Algumas contas veem, outras não, sem padrão aparente |
| Base de assinaturas atualizada | freshclam / cron |
Varredura roda e não detecta nada |
Daemon clamd ativo |
systemctl |
Varredura pela interface do cPanel indisponível: desmarque o recurso na Feature List junto |
Qual escopo de varredura vale a pena e qual só gasta I/O
Na interface do cPanel, o usuário escolhe o escopo da varredura. Os alvos típicos são a caixa de correio, o diretório home, o espaço web público e o espaço público de FTP. Traduzindo para o que importa num site WordPress:
- Caixa de correio: arquivos de mensagem em
/home/usuario/mail. É onde mais aparece anexo malicioso recebido, que normalmente não compromete o site, mas infla disco e inode. - Espaço web público:
public_html. É aqui que mora a webshell em PHP, o arquivowp-content/uploads/xyz.phpe o backdoor plantado emwp-includes. - Diretório home inteiro: tudo acima mais backups, pastas fora do docroot e lixo de migração antiga.
Um aviso que vale colocar no seu próprio runbook: varrer o home inteiro de uma conta com backup grande significa ler cada byte de cada arquivo. É a varredura mais cara e a que menos agrega, porque malware de WordPress está quase sempre no docroot. Oriente o cliente a começar pelo espaço web público.
Detecção do ClamAV é baseada em assinatura. Webshell ofuscada e gerada sob medida passa batido. Por isso o resultado "nenhum arquivo infectado" não é prova de que o site está limpo, é prova de que não há malware conhecido com assinatura na base atual. Diga isso ao cliente antes que ele conclua sozinho o contrário.
O que o daemon clamd custa em memória residente
O ClamAV trabalha carregando a base de assinaturas na memória. Quando o daemon clamd fica residente para servir varreduras rápidas via clamdscan, essa memória fica ocupada o tempo todo, inclusive às três da manhã de domingo quando ninguém vai escanear nada.
Em servidor grande isso é irrelevante. Em VPS pequeno, onde PHP-FPM, MySQL e o próprio cPanel já disputam RAM, o daemon vira um concorrente permanente. O sintoma não é "o antivírus está pesado": é o MySQL sendo morto pelo OOM killer, o site caindo com erro de conexão ao banco e você passando a tarde investigando o lugar errado.
Como confirmar que o culpado é ele:
free -m
ps -o pid,rss,comm -C clamd
grep -i 'killed process' /var/log/messages
dmesg -T | grep -i oom
O rss mostra a memória residente do processo em kilobytes. O log de OOM diz qual processo o kernel matou e quanta memória estava em jogo. Se o clamd aparece entre os maiores consumidores e o MySQL é o morto recorrente, você tem a resposta sem precisar trocar de plano.
Não temos medição própria de consumo para publicar aqui, então não vou inventar um número. O que dá para afirmar com segurança: o consumo cresce junto com o tamanho da base de assinaturas, e a base cresce ao longo do tempo. Um servidor que convivia bem com o daemon há um ano pode não conviver mais hoje.
Quando desligar o daemon e ainda assim manter a varredura
A decisão não é binária entre "antivírus ligado" e "antivírus desligado". Dá para manter a capacidade de varrer e devolver a memória residente ao servidor.
Daemon ativo, para servidor com folga de RAM
Faz sentido quando o servidor tem folga de RAM e o uso da varredura pela interface do cPanel é frequente. As varreduras começam rápido porque a base já está carregada.
Daemon desligado e varredura via clamscan, para VPS apertado
Faz sentido em VPS apertado. Sem o daemon, o clamscan carrega a base a cada execução, o que torna cada varredura mais lenta de iniciar, mas a memória só é ocupada durante o scan.
Consequência direta: sem o clamd rodando, a varredura pela interface do cPanel não funciona. O botão continua visível e o cliente recebe erro ao clicar. Então desligue o daemon e desmarque o recurso na Feature List dos pacotes afetados na mesma janela de manutenção. Essa é a parte que precisa de comunicação, não de comando.
systemctl stop clamd
systemctl disable clamd
Varredura agendada na madrugada, melhor custo-benefício para agência
O melhor custo-benefício para agência que administra vários sites. Você desliga o residente, agenda a varredura em janela de baixa carga e entrega relatório.
nice -n 19 ionice -c3 clamscan -ri /home/usuario/public_html \
--exclude-dir='^/home/usuario/public_html/wp-content/cache' \
--log=/var/log/clamscan-usuario.log
O -r é recursivo, o -i imprime só os infectados, nice e ionice reduzem a prioridade de CPU e de disco para não brigar com o tráfego real. Excluir diretório de cache evita varrer milhares de arquivos descartáveis.
Coloque no cron em horário de madrugada e escalone os horários entre contas, para não rodar dez varreduras simultâneas no mesmo servidor.
Com que frequência atualizar a base de assinaturas
O freshclam baixa as bases atualizadas. Atualizar com frequência alta num servidor que só varre uma vez por semana é gasto de banda e de I/O sem retorno. Regra simples: varredura semanal, uma atualização por dia (ou a cada dois dias) basta; várias vezes ao dia só faz sentido para quem varre diariamente. O que não pode é a base ficar parada por meses.
freshclam --help | grep -i 'config-file'
grep -i 'Checks' /usr/local/cpanel/3rdparty/etc/freshclam.conf
Com o clamavconnector, o arquivo em uso costuma ficar em /usr/local/cpanel/3rdparty/etc/freshclam.conf, não em /etc/freshclam.conf. Confirme o caminho padrão do binário antes de editar: se o grep não devolver nada, procure com find / -name freshclam.conf 2>/dev/null.
O parâmetro Checks define quantas verificações por dia o freshclam faz quando roda em modo daemon.
Como explicar ao cliente que o botão sumiu do painel
Se você desligar a ferramenta num servidor onde ela existia, alguém vai notar. Frase pronta, honesta e sem prometer o que não existe:
Três coisas acontecem nessa frase: você explica a causa técnica em linguagem de consequência (site instável), desfaz a crença de proteção em tempo real e oferece substituto concreto. Nenhuma delas depende de upgrade de plano.
Se o cliente insistir em proteção contínua, a conversa honesta é outra: atualização de core, tema e plugin em dia, senha forte e 2FA no wp-admin, remoção de plugin abandonado e backup testado resolvem mais incidentes do que qualquer scanner de assinatura rodando depois do estrago.
Checklist de 10 itens para padronizar vários servidores
Use como runbook em cada servidor novo da agência. Marque o estado, não a intenção.
| # | Item | Verificação | Decisão registrada |
|---|---|---|---|
| 1 | Plugin instalado | which clamscan responde |
sim / não |
| 2 | Base de assinaturas presente | clamscan --version mostra versão da base |
data da base |
| 3 | freshclam agendado |
entrada no cron ou daemon ativo | frequência escolhida |
| 4 | Daemon clamd |
systemctl is-enabled clamd |
residente / desligado |
| 5 | Feature Lists com o recurso | lista por lista no Feature Manager | quais |
| 6 | Pacotes apontando para essas listas | Edit a Package | quais |
| 7 | Teste real no cPanel | ícone visível em conta de cada pacote | ok / falhou |
| 8 | Escopo padrão orientado ao cliente | documentado no onboarding | espaço web público |
| 9 | Varredura agendada | cron com nice/ionice e log próprio |
horário |
| 10 | Monitoramento de OOM | checagem de dmesg//var/log/messages |
ativo / não |
Dois itens merecem política escrita, não decisão caso a caso:
- Servidor abaixo do seu limite de RAM confortável: daemon desligado por padrão, varredura só agendada. Defina o limite uma vez e aplique igual em todos.
- Conta com histórico de invasão: varredura agendada mais frequente e revisão manual do
public_html, porque assinatura sozinha não fecha o caso.
Quando a varredura apontar arquivo infectado, o próximo passo é do lado do cliente: interpretar o relatório, isolar o arquivo, conferir se é falso positivo (acontece com cache e com biblioteca minificada) e limpar. Instalar o scanner é trabalho de admin; limpar o site é trabalho de quem conhece a instalação. Separar essas duas tarefas no seu fluxo evita que você vire responsável por código que não escreveu.
Cinco erros que fazem você perder a tarde no lugar errado
- Marcar a Feature List errada. O sintoma é "funciona para uns clientes e não para outros". Sempre volte em Edit a Package.
- Instalar e nunca rodar
freshclam. Scanner com base antiga devolve resultado limpo e gera confiança indevida. - Varrer o home inteiro por padrão. Custa I/O, demora e detecta quase sempre coisa irrelevante em backup antigo.
- Diagnosticar queda de site sem olhar OOM. Antes de culpar o plugin de cache ou o tema, rode
dmesg -T | grep -i oom. - Prometer tempo real. A documentação do cPanel descreve varredura iniciada pelo usuário. Qualquer promessa além disso é sua, não da ferramenta.
Se a conclusão do seu diagnóstico for que o servidor não comporta o daemon residente, desligar é a decisão certa, mesmo que o painel fique com uma opção a menos. Um site no ar sem botão de scanner serve mais ao cliente do que um botão bonito num servidor que cai à tarde.
Referências
- Documentação oficial (cpanel) — Configure ClamAV Scanner (WHM). Consultado em 2026-10-04.