ClamAV : tester la connexion à clamd (PING et VERSION)
Comment vérifier que le démon clamd répond sur son socket UNIX ou son port TCP, et aligner les applications clientes sur ce point d'accès.
Les applications qui analysent des fichiers avec ClamAV envoient ces fichiers au démon clamd. Lorsque le client journalise Connection to clamd failed suivi de Connection to clamd re-established, le démon ne répond pas sur le point d'accès utilisé par le client. Les vérifications ci-dessous permettent de confirmer le point d'accès exposé par clamd et s'il répond.
1. Vérifier le démon
systemctl list-units '*clam*'
systemctl status clamd.service
journalctl -u clamd.service -b --no-pager
Dans le journal, rechercher les redémarrages, les arrêts pour manque de mémoire (OOM) ou les erreurs de segmentation.
2. Vérifier le point d'accès dans clamd.conf
grep -E '^(LocalSocket|TCPSocket|TCPAddr)' /etc/clamav/clamd.conf
| Paramètre | Exemple | Usage |
|---|---|---|
LocalSocket |
/run/clamav/clamd.ctl |
Socket UNIX, clients locaux uniquement |
TCPSocket |
3310 |
Port TCP |
TCPAddr |
127.0.0.1 |
Adresse sur laquelle le port TCP écoute |
Pour un socket UNIX, l'utilisateur de l'application cliente doit pouvoir y accéder :
ls -l /run/clamav/clamd.ctl
Si nécessaire, définir LocalSocketGroup (par exemple le groupe du serveur web) et LocalSocketMode dans clamd.conf. La source utilisait le mode 666, qui permet à tout utilisateur local de se connecter ; le restreindre au groupe du serveur web si possible.
Redémarrer après toute modification :
sudo systemctl restart clamd.service
3. Envoyer PING et VERSION
Par TCP :
echo PING | nc -w 2 127.0.0.1 3310
echo VERSION | nc -w 2 127.0.0.1 3310
Par le socket UNIX, avec ncat (paquet nmap) ou socat :
printf "PING\n" | ncat -U /run/clamav/clamd.ctl
printf "VERSION\n" | ncat -U /run/clamav/clamd.ctl
printf "PING\n" | socat - UNIX-CONNECT:/run/clamav/clamd.ctl
printf "VERSION\n" | socat - UNIX-CONNECT:/run/clamav/clamd.ctl
Le nc de GNU ne supporte pas -U. Le netcat OpenBSD le supporte et constitue une alternative à ncat ou socat.
Résultats attendus : PING renvoie PONG, et VERSION renvoie la chaîne de version de clamd.
4. Analyser un fichier depuis la ligne de commande
clamdscan --fdpass /chemin/vers/fichier
clamscan /chemin/vers/fichier
clamscanfonctionne maisclamdscanéchoue : le problème vient du point d'accès ou de ses droits.- Les deux échouent : c'est l'installation de ClamAV ou ses bases de signatures qui pose problème.
Remarques
- L'application cliente doit utiliser le même point d'accès que
clamd: le même chemin de socket UNIX, ou la même adresse IP et le même port.