LLI Wiki — My Digital Knowledge Base

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

Remarques

Mastodon LLIMastodon SocialFosstodon