Ensinando meu blog a farejar os próprios uploads: ClamAV no WordPress (e provando que ele late de verdade)

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski
A pasta uploads de um WordPress deveria guardar suas fotos de férias
e um PDF de vez em quando. Ela definitivamente não deveria guardar uma web
shell em PHP — mas esse “deveria” está carregando muito peso aí. O
diretório de uploads é o lugar mais comum onde um WordPress comprometido acaba
executando código do atacante, porque ele é gravável, acessível pela web, e todo
mundo esquece dele. Então dei um nariz ao meu: um antivírus que fareja a pasta
de uploads toda noite e me manda um e-mail no momento em que sente algum cheiro. 👃
E como um detector de fumaça que você nunca testou é só bijuteria de teto,
também fiz ele disparar de propósito. Mais sobre isso no final.
🎯 O design (propositalmente chato)
- 🌙 Sob demanda, toda noite. Nada de daemon on-access em tempo real — isso é pesado para um VPS modesto, e eu sou basicamente a única pessoa que faz upload de alguma coisa. Uma varredura por noite é o equilíbrio certo: no pior caso, o malware fica algumas horas até o e-mail da manhã, não semanas.
- 🔇 Silencioso, a menos que encontre algo. A mesma filosofia de todo o resto nesta máquina (rkhunter, Monit): um scan limpo não manda nada. Um e-mail do scanner, portanto, sempre significa “olhe isto agora”, nunca “tudo bem, como sempre”.
- 🔎 Só detecção. Ele reporta, não apaga nem coloca em quarentena. Num blog pessoal, prefiro olhar um achado com meus próprios olhos do que ter um faxineiro automático comendo em silêncio um arquivo falso positivo.
- 🧩 Gerenciado pelo Ansible (role
blog_clamav), então é reproduzível e versionado, não um script floco de neve que eu vou esquecer como montei.
📦 Como é instalado e configurado
No AlmaLinux 9, tudo se resume a ClamAV mais o atualizador de assinaturas:
dnf install clamav clamav-update
O freshclam.conf do pacote vem com uma linha de placeholder que
impede que ele rode — a pegadinha clássica da primeira vez. Remova-a,
baixe o banco de assinaturas uma vez e ative as atualizações automáticas:
# kill the "Example" line or freshclam refuses to start
sed -i '/^Example/d' /etc/freshclam.conf
freshclam # first full signature download
systemctl enable --now clamav-freshclam # keep signatures fresh automatically
O scan em si é um pequeno script em
/usr/local/sbin/wordpress-clamav-scan.sh. Ele escaneia só o diretório
de uploads, se comporta bem com o resto da máquina, pula arquivos absurdamente
grandes (malware não está escondido num vídeo de 300 MB) e — a parte
importante — só manda e-mail quando acha algo:
#!/bin/bash
SCAN_LOG="/var/log/clamav/wordpress-scan.log"
UPLOADS_DIR="/srv/wordpress-www/wp-content/uploads"
nice -n 19 ionice -c3 clamscan --recursive --infected --no-summary \
--max-filesize=200M --max-scansize=200M \
"$UPLOADS_DIR" > "$SCAN_LOG" 2>&1
RC=$?
# clamscan exit code 1 = something was found -> mail it, otherwise stay silent
if [ "$RC" -eq 1 ]; then
mail -s "[$(hostname -f)] ClamAV: infected file(s) found in WordPress uploads" \
me@example.com < "$SCAN_LOG"
fi
exit 0
Uma entrada no cron roda o script toda noite às 02:45. O e-mail sai pelo mesmo
relay msmtp que o resto dos meus alertas usa (rkhunter, Monit), então há
um caminho de e-mail para manter funcionando, não três.
45 2 * * * /usr/local/sbin/wordpress-clamav-scan.sh
🧪 Fazendo ele latir: o teste EICAR
Aqui vem a parte divertida. Você não baixa malware de verdade para testar um antivírus — você usa o EICAR, uma string de teste de 68 bytes, padrão da indústria, que todo scanner do planeta é obrigado a sinalizar, e que é completamente inofensiva (não é malware executável, é uma string ASCII imprimível feita só para disparar a detecção). Coloque-a no caminho do scan, rode o script de verdade, veja a corrente inteira disparar e depois apague:
# drop the harmless EICAR test file into uploads
printf 'X5O!P%%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*\n' \
> /srv/wordpress-www/wp-content/uploads/eicar-test.txt
# run the actual nightly script by hand
/usr/local/sbin/wordpress-clamav-scan.sh
# clean up immediately
rm -f /srv/wordpress-www/wp-content/uploads/eicar-test.txt
O ClamAV a encontrou na hora — Eicar-Signature FOUND —
o script bateu no exit code 1, disparou o e-mail, e instantes depois isto caiu na
minha caixa de entrada:
From: homelab@apt-upgrade.me
Subject: [www.apt-upgrade.me] ClamAV: infected file(s) found in WordPress uploads
/srv/wordpress-www/wp-content/uploads/eicar-test.txt: Eicar-Signature FOUND
E, para ser minucioso, conferi o log do próprio relay de e-mail, que confirmou a entrega em vez de eu só presumir:
host=smtp.strato.de tls=on auth=on ... recipients=you@example.com
smtpstatus=250 ... 'OK queued' exitcode=EX_OK
Detecção ✔️, caminho de e-mail do script real ✔️, entrega na minha caixa de entrada de verdade ✔️. Essa é a diferença entre “configurei um scanner” e “tenho um scanner que funciona” — o segundo você já viu pegar alguma coisa. 🎯 (Arquivo de teste apagado logo depois, uploads limpos de novo. Isso foi um simulado, não uma invasão.)
⚠️ Limitações honestas
- É um scan noturno, não em tempo real. Um upload malicioso é pego na próxima execução das 02:45, não no instante em que chega.
- Ele escaneia os uploads, a pasta de maior risco — não o disco inteiro. Outra ferramenta para a camada do sistema operacional (aqui esse é o trabalho do rkhunter).
- Detecção, não remoção. O e-mail é o produto inteiro; a limpeza é uma decisão humana.
Nada disso me incomoda num blog pessoal em que eu sou o principal autor de uploads. A ideia não é um EDR à prova de balas — é que, se a pasta de uploads algum dia ganhar um arquivo PHP que não deveria ter, eu fico sabendo até o café da manhã em vez de descobrir por outra pessoa. Isso, mais o rkhunter vigiando o sistema e o Monit vigiando os serviços, são três tripwires baratos e independentes que terminam todos no mesmo lugar: minha caixa de entrada. 🛡️ Como sempre, tudo — a role do ClamAV, o script de scan, a entrada do cron, a config de e-mail — é público e versionado no meu repositório Ansible: github.com/aptupgrademe/www_k3s. Pegue emprestado, quebre, me diga o que deixei passar. 🧑💻
📚 Mais nesta série: protegendo este blog
- WP2Shell, uma imagem Docker sem patch e a noite em que o Claude corrigiu minha config do nginx sem ninguém pedir 🐚
- wp2shell, um Chrome falso e uma botnet de sobretudo: o que meus próprios access logs entregaram
- 🥷 Passei uma noite tentando invadir meu próprio blog. Ele me baniu. Duas vezes
- Quem vigia os vigilantes? Um watchdog Monit depois que o fail2ban morreu em silêncio por dois dias
