Installation pas à pas
Windows
Téléchargez et exécutez le fichier d'installation .msi. Le programme installe le client et crée un raccourci de démarrage automatique configuré avec élévation UAC.
# Si vous préférez installer via winget (prochainement disponible)
winget install ClamAVClient
macOS
Montez le fichier .dmg téléchargé, puis glissez l'icône de ClamAVClient dans votre dossier Applications. Au premier démarrage, l'application configurera un service launchd pour la mise à jour des signatures.
Linux (Debian / Ubuntu / Linux Mint)
Installez le fichier .deb avec dpkg puis corrigez les éventuelles dépendances manquantes avec apt.
sudo dpkg -i clamavclient.deb
sudo apt-get install -f
Linux (Fedora / RHEL / Rocky Linux)
sudo rpm -i clamavclient.rpm
Linux AppImage (Toutes distributions)
chmod +x ClamAvClient.AppImage
./ClamAvClient.AppImage
Configuration des Privilèges
Pour analyser l'intégralité du système de fichiers et surveiller en temps réel les écritures, l'application requiert des droits élevés selon la plateforme.
Windows
L'installateur MSI déclenche automatiquement la boîte de dialogue UAC (Contrôle de compte d'utilisateur). Il suffit de cliquer sur Oui. Aucune commande supplémentaire n'est nécessaire.
Linux — méthode recommandée (interface graphique)
Utilisez pkexec pour déclencher une boîte de dialogue graphique de demande de mot de passe :
pkexec clamavclient
Si pkexec n'est pas disponible, vous pouvez lancer l'application directement avec sudo depuis un terminal :
sudo clamavclient
# ou, si installé via AppImage :
sudo ./ClamAvClient.AppImage
Linux — cas particulier Wayland (GNOME / Fedora)
Sur Wayland, sudo seul peut bloquer l'affichage graphique. Transmettez la variable d'affichage :
# Wayland
sudo --preserve-env=WAYLAND_DISPLAY,XDG_RUNTIME_DIR clamavclient
# X11 (fallback)
sudo DISPLAY=$DISPLAY clamavclient
Linux — scan sans ouvrir l'interface (terminal pur)
Si vous n'avez pas d'environnement graphique, vous pouvez utiliser directement le moteur ClamAV :
# Scan rapide du dossier personnel
sudo clamscan --recursive --infected ~/
# Scan complet du système (peut prendre plusieurs heures)
sudo clamscan --recursive --infected /
# Avec le daemon clamd (plus rapide)
sudo clamdscan --multiscan /home
macOS
Montez le .dmg et glissez l'application dans /Applications. Au premier lancement, macOS demandera une autorisation via la boîte de dialogue système. Pour les scans système complets :
sudo /Applications/ClamAvClient.app/Contents/MacOS/ClamAvClient
Sur macOS, accordez aussi l'Accès complet au disque dans Réglages Système → Confidentialité et sécurité → Accès complet au disque.
Note Mode standard (sans élévation)
L'application fonctionne aussi sans droits root en mode utilisateur standard. Dans ce cas :
- Scan de votre dossier personnel (
~) : disponible
- Protection temps réel sur vos téléchargements : disponible
- Scan des dossiers système (
/etc, /usr, /bin...) : accès refusé sur certains fichiers (comptés dans les erreurs)
- Scan complet du système : résultats partiels sans droits root
Compiler le projet
ClamAVClient est écrit en Rust (backend Tauri) et en Javascript Vanilla (frontend). Pour le compiler localement, vous devez installer Node.js, Rust (via rustup), et le moteur ClamAV local.
1. Cloner le dépôt de code
git clone https://github.com/AnARCHIS12/ClamAVClient.git
cd ClamAVClient
2. Installer les dépendances NPM
npm install
3. Préparer le runtime ClamAV embarqué
Cette étape télécharge ou copie les fichiers binaires requis par ClamAV sur votre système d'exploitation actuel pour les incorporer au bundle de l'application desktop.
npm run prepare:clamav
4. Lancer le serveur de développement élevé
# Lance l'application avec les privilèges sudo/administrateur requis
npm run dev:elevated
5. Compiler l'application finale pour votre OS
npm run build:desktop
Fonctionnalités et variables avancées
Option Daemon (clamd)
Par défaut, l'application charge le moteur de scan en mémoire à chaque analyse, ce qui est économe en RAM mais peut être lent à démarrer. En activant l'option clamd dans les configurations, l'application se connecte au démon résident système (souvent configuré sur le port 3310).
Structure des Logs d'analyse
Chaque scan consigne son rapport au format standardisé JSON dans le dossier de données de l'application :
- Windows :
%APPDATA%/ClamAVClient/logs/
- Linux :
~/.config/clamavclient/logs/
- macOS :
~/Library/Application Support/ClamAVClient/logs/