Squidclient

Fiche express
Domaine	Client CLI de requêtage direct du cache Squid
Paquet Debian/Ubuntu	squidclient
Paquet RHEL/CentOS	squid (fournit squidclient)
Voir aussi	Squid · SquidGuard · Sarg

squidclient est l'outil en ligne de commande fourni avec Squid pour dialoguer directement avec le cache : envoyer une requête HTTP brute au proxy, purger une entrée du cache, ou interroger le gestionnaire de cache (cache manager) pour en obtenir l'état interne (mémoire, objets stockés, statistiques de service…).

Installation

apt-get install squidclient   # Debian/Ubuntu
yum install squid             # RHEL/CentOS — squidclient est inclus dans le paquet squid

Requêtes de base

squidclient http://www.exemple.org
squidclient -m GET https://www.exemple.org

Purger une entrée du cache

La méthode PURGE nécessite une ACL dédiée côté squid.conf, généralement restreinte à localhost ou à des hôtes d'administration explicites :

acl PURGE method PURGE
acl localhost src 127.0.0.1
http_access allow PURGE localhost
http_access deny PURGE

squidclient -m PURGE https://www.exemple.org

Cache manager (mgr:*)

L'ensemble des rapports internes du cache manager est accessible via des URLs de la forme mgr:<rapport> :

Commande	Contenu
squidclient mgr:menu	liste de tous les rapports disponibles
squidclient mgr:info	informations générales sur l'instance Squid
squidclient mgr:server_list	liste des serveurs/pairs de cache configurés
squidclient mgr:mem	utilisation mémoire détaillée
squidclient mgr:counters	compteurs cumulés (requêtes, hits, erreurs…)
squidclient mgr:idns	état du sous-système de résolution DNS interne
squidclient mgr:histograms	histogrammes de performance
squidclient mgr:5min	moyennes glissantes sur 5 minutes
squidclient mgr:60min	moyennes glissantes sur 60 minutes
squidclient mgr:utilization	taux d'utilisation du cache
squidclient mgr:diskd	état des processus d'I/O disque asynchrones (aufs/diskd)
squidclient mgr:store_digest	résumé du contenu du cache (utile en hiérarchie de caches)
squidclient mgr:refresh	statistiques de la politique de rafraîchissement des objets
squidclient mgr:vm_objects	objets actuellement en mémoire
squidclient mgr:objects	liste complète des objets en cache — à utiliser avec précaution sur un cache très chargé : la sortie peut être volumineuse et son exécution intensive

Interroger un pair de cache distant plutôt que l'instance locale :

squidclient -h peer.exemple.local mgr:store_digest

Fixer un port et un timeout explicites (utile si Squid n'écoute pas sur le port par défaut) :

squidclient -p 8080 -t 1 -h localhost mgr:info

Interface Web (cachemgr.cgi)

Les mêmes rapports sont accessibles via un script CGI si un serveur HTTP est configuré pour le servir :

http://serveur/cgi-bin/cachemgr.cgi

Documentation officielle du cache manager : wiki.squid-cache.org : Cache Manager.

Voir aussi

• Squid — le service interrogé par squidclient
• SquidGuard
• Sarg — reporting périodique, à distinguer des statistiques en direct de squidclient