Installer et sécuriser Redis
Installez Redis depuis le dépôt officiel sur Debian ou Ubuntu : utilisateurs ACL, écoute locale, persistance RDB et AOF, limite mémoire, sauvegarde et restauration.
Sur cette page
Vos valeurs
Renseignez-les une fois, les commandes du guide se mettent à jour.
Ce guide vous explique comment installer Redis sur votre VPS ou serveur dédié depuis le dépôt officiel, le protéger avec des utilisateurs ACL, choisir la persistance adaptée, limiter sa mémoire et sauvegarder ses données.
Redis est conçu pour être utilisé par des clients de confiance. Il reste donc ici accessible uniquement en local, et chaque application s'y connecte avec un compte aux droits limités.
Commander un serveur
Redis garde ses données en mémoire : prévoyez une RAM suffisante pour vos données et pour les sauvegardes en arrière-plan. HostMyServers propose plusieurs offres :
Prérequis
- Un serveur sous Debian 12 ou 13, ou Ubuntu 22.04 ou 24.04
- Un accès SSH avec un utilisateur disposant de
sudo - Un système à jour (
sudo apt update && sudo apt upgrade)
Ports à ouvrir
Aucun. Redis écoute sur le port 6379 de 127.0.0.1 et ::1. Pour y accéder depuis votre poste, utilisez le tunnel SSH décrit plus loin, qui passe par votre port SSH déjà ouvert.
Installer Redis depuis le dépôt officiel
À la date de rédaction, le dépôt officiel propose Redis 8.10 pour Debian 12 et 13 ainsi qu'Ubuntu 22.04 et 24.04.
sudo apt install -y lsb-release curl gpg
curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
sudo chmod 644 /usr/share/keyrings/redis-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list
sudo apt update
sudo apt install -y redis
sudo systemctl enable --now redis-serverVérifier l'installation
redis-server --version
sudo systemctl status redis-server --no-pager
redis-cli ping
sudo ss -tlnp | grep 6379redis-cli ping doit répondre PONG. ss doit montrer une écoute sur 127.0.0.1:6379 et [::1]:6379 uniquement.
| Élément | Emplacement |
|---|---|
| Configuration du paquet | /etc/redis/redis.conf |
| Vos réglages (créé plus loin) | /etc/redis/local.conf |
| Utilisateurs (créé plus loin) | /etc/redis/users.acl |
| Données | /var/lib/redis/ |
| Journal | /var/log/redis/redis-server.log |
Créer les utilisateurs ACL
Par défaut, toute connexion locale peut exécuter toutes les commandes. Vous allez désactiver cet utilisateur default et créer trois comptes :
| Utilisateur | Droits |
|---|---|
admin |
Administration complète |
app |
Lecture et écriture sur les clés app:*, sans commandes dangereuses |
backup |
Déclenchement des sauvegardes uniquement, sans accès aux clés |
-
Générez les mots de passe et le fichier d'utilisateurs. Seules leurs empreintes SHA-256 y sont enregistrées :
TerminalADMIN_PASS="$(openssl rand -hex 32)" APP_PASS="$(openssl rand -hex 32)" BACKUP_PASS="$(openssl rand -hex 32)" sha() { printf '%s' "$1" | sha256sum | cut -d' ' -f1; } sudo install -o redis -g redis -m 640 /dev/null /etc/redis/users.acl sudo tee /etc/redis/users.acl > /dev/null <<EOF user default off user admin on #$(sha "$ADMIN_PASS") ~* &* +@all user app on #$(sha "$APP_PASS") ~app:* resetchannels &app:* -@all +@read +@write +@connection +@transaction -@dangerous user backup on #$(sha "$BACKUP_PASS") resetchannels -@all +ping +bgsave +lastsave EOF -
Conservez le mot de passe de sauvegarde pour le script, puis affichez les deux autres afin de les ranger dans votre gestionnaire de mots de passe :
Terminalprintf '%s' "$BACKUP_PASS" | sudo sh -c 'umask 077; cat > /root/.redis-backup-pass' printf 'admin: %s\napp: %s\n' "$ADMIN_PASS" "$APP_PASS" unset ADMIN_PASS APP_PASS BACKUP_PASS -
Créez votre fichier de réglages. Il reste séparé de
redis.conf, ce qui simplifie les mises à jour :Terminalsudo install -o redis -g redis -m 640 /dev/null /etc/redis/local.conf sudo nano /etc/redis/local.confConfigurationaclfile /etc/redis/users.acl maxmemory 512mb maxmemory-policy noevictionAdaptez
maxmemoryà votre serveur, comme expliqué dans la section sur la mémoire. -
Chargez ce fichier à la fin de la configuration, puis redémarrez :
Terminalecho 'include /etc/redis/local.conf' | sudo tee -a /etc/redis/redis.conf sudo systemctl restart redis-server -
Vérifiez le résultat :
Terminalredis-cli ping redis-cli --user admin --askpass ping redis-cli --user app --askpassLa première commande doit répondre
NOAUTH Authentication required.et la deuxièmePONGaprès la saisie du mot de passeadmin. Dans la session ouverte par la troisième, avec le mot de passeapp:TexteSET app:test ok GET app:test DEL app:test SET autre:test non FLUSHALLLes trois premières commandes doivent réussir. Les deux dernières doivent être refusées avec une erreur
NOPERM.
Dans votre application, indiquez l'utilisateur app, son mot de passe, et préfixez les clés par app:. Si elle a besoin d'autres commandes, ajustez sa ligne dans users.acl, puis rechargez le fichier depuis une session admin avec ACL LOAD.
Accéder à Redis depuis votre poste
Ouvrez un tunnel SSH et laissez cette commande active :
ssh -N -L 6380:127.0.0.1:6379 VOTRE_USER@VOTRE_IP_SERVEURDans un autre terminal, connectez-vous par le port local 6380 :
redis-cli -p 6380 --user admin --askpassSi une application distante ne peut vraiment pas passer par un tunnel ou un réseau privé, configurez TLS en conservant les ACL, et limitez le port à l'adresse de ce client dans le pare-feu.
Choisir la persistance
| Mode | Fonctionnement | Risque de perte | Usage conseillé |
|---|---|---|---|
| RDB | Instantanés réguliers dans dump.rdb |
Depuis le dernier instantané | Données que l'on peut recréer en partie |
| AOF | Journal des écritures, synchronisé chaque seconde par défaut | Environ une seconde | Données importantes |
| RDB + AOF | Les deux à la fois | Environ une seconde | Le meilleur choix pour des données à conserver |
| Aucune | Tout est perdu au redémarrage | Totale | Cache pur |
RDB est actif par défaut, avec les seuils 3600 1 300 100 60 10000 : un instantané après 1 heure si au moins 1 clé a changé, après 5 minutes pour 100 clés, après 1 minute pour 10 000 clés.
Activer AOF sans perdre de données
-
Ouvrez une session
admin:Terminalredis-cli --user admin --askpass -
Activez AOF et suivez sa création :
TexteCONFIG SET appendonly yes INFO persistenceRépétez
INFO persistencejusqu'à obteniraof_rewrite_in_progress:0,aof_rewrite_scheduled:0etaof_last_bgrewrite_status:ok. -
Ajoutez la ligne suivante à
/etc/redis/local.confpour conserver ce réglage :Configurationappendonly yes -
Redémarrez Redis, puis vérifiez avec
DBSIZEque le nombre de clés n'a pas changé :Terminalsudo systemctl restart redis-server
Utiliser Redis comme cache pur
Si toutes les données peuvent être reconstruites, ajoutez ces lignes à /etc/redis/local.conf et redémarrez :
save ""
appendonly no
maxmemory-policy allkeys-lruMaîtriser la mémoire
Redis n'a pas de limite mémoire par défaut sur un système 64 bits. Fixez toujours maxmemory, en laissant de la place au système, à vos autres services et aux tampons de Redis. Pendant une sauvegarde sur une instance très sollicitée en écriture, Redis peut consommer jusqu'à deux fois sa mémoire habituelle.
| Politique | Comportement à la limite | Usage |
|---|---|---|
noeviction |
Refuse les nouvelles écritures | Données à ne pas perdre |
allkeys-lru |
Supprime les clés les moins récemment utilisées | Cache général |
allkeys-lfu |
Supprime les clés les moins fréquemment utilisées | Cache avec clés très demandées |
volatile-lru |
Supprime parmi les clés ayant une expiration | Cache et données mêlés |
volatile-ttl |
Supprime les clés dont l'expiration est la plus proche | Expirations bien maîtrisées |
Activez le réglage noyau recommandé par Redis pour fiabiliser les sauvegardes en arrière-plan :
echo 'vm.overcommit_memory = 1' | sudo tee /etc/sysctl.d/90-redis.conf
sudo sysctl --systemPour surveiller l'utilisation depuis une session admin :
INFO memory
INFO stats
MEMORY DOCTORRegardez notamment used_memory_human, maxmemory_human, mem_fragmentation_ratio et evicted_keys.
Automatiser les sauvegardes
Le fichier RDB peut être copié pendant que Redis fonctionne : il n'est remplacé qu'une fois le nouvel instantané complet. Le script demande un instantané récent, attend sa fin, puis le copie.
-
Créez le script :
Terminalsudo nano /usr/local/sbin/redis-backup.shTerminal#!/bin/bash set -euo pipefail umask 077 DEST="/var/backups/redis" RETENTION_DAYS=7 export REDISCLI_AUTH="$(cat /root/.redis-backup-pass)" cli() { redis-cli --user backup "$@"; } mkdir -p "$DEST" before="$(cli LASTSAVE)" cli BGSAVE SCHEDULE > /dev/null now="$before" for _ in $(seq 1 1800); do sleep 1 now="$(cli LASTSAVE)" [ "$now" -gt "$before" ] && break done if [ "$now" -le "$before" ]; then echo "BGSAVE did not finish in time" >&2 exit 1 fi cp /var/lib/redis/dump.rdb "$DEST/dump-$(date +%F_%H%M%S).rdb" find "$DEST" -name 'dump-*.rdb' -mtime +"$RETENTION_DAYS" -delete -
Créez le service :
Terminalsudo chmod 700 /usr/local/sbin/redis-backup.sh sudo nano /etc/systemd/system/redis-backup.serviceConfiguration[Unit] Description=Redis backup After=redis-server.service [Service] Type=oneshot ExecStart=/usr/local/sbin/redis-backup.sh -
Créez le minuteur :
Terminalsudo nano /etc/systemd/system/redis-backup.timerConfiguration[Unit] Description=Daily Redis backup [Timer] OnCalendar=*-*-* 02:45:00 RandomizedDelaySec=10min Persistent=true [Install] WantedBy=timers.target -
Activez-le et lancez une première sauvegarde :
Terminalsudo systemctl daemon-reload sudo systemctl enable --now redis-backup.timer sudo systemctl start redis-backup.service sudo ls -lh /var/backups/redis
Tester la restauration
Ce test charge la dernière sauvegarde dans une instance temporaire, joignable uniquement par un socket local. Votre instance de production n'est pas modifiée.
LATEST="$(sudo sh -c 'ls -1t /var/backups/redis/dump-*.rdb | head -n 1')"
sudo install -d -o redis -g redis -m 750 /var/lib/redis-restore-test
sudo install -o redis -g redis -m 640 "$LATEST" /var/lib/redis-restore-test/dump.rdb
sudo -u redis redis-server --port 0 --unixsocket /var/lib/redis-restore-test/redis.sock --unixsocketperm 700 --dir /var/lib/redis-restore-test --dbfilename dump.rdb --appendonly no --save "" --daemonize yes --logfile /var/lib/redis-restore-test/redis.log
sleep 2
sudo -u redis redis-cli -s /var/lib/redis-restore-test/redis.sock DBSIZEComparez ce nombre avec celui de l'instance de production et lisez quelques clés importantes avec GET. Arrêtez ensuite l'instance de test et supprimez ses fichiers :
sudo -u redis redis-cli -s /var/lib/redis-restore-test/redis.sock SHUTDOWN NOSAVE
sudo rm -rf /var/lib/redis-restore-testSi vos données utilisent les modules JSON, Search, TimeSeries ou Bloom, ajoutez à la commande de démarrage les options --loadmodule correspondantes, avec les chemins indiqués dans /etc/redis/redis.conf.
Restaurer après un incident
Quand AOF est actif, Redis charge ses données depuis AOF et ignore dump.rdb. La procédure désactive donc AOF le temps de la restauration.
-
Arrêtez les applications et Redis, puis mettez de côté les fichiers actuels :
Terminalsudo systemctl stop redis-server sudo mkdir -p /var/backups/redis/before-restore sudo sh -c 'mv /var/lib/redis/dump.rdb /var/lib/redis/appendonlydir /var/backups/redis/before-restore/ 2>/dev/null || true' -
Copiez la sauvegarde choisie, en adaptant son nom :
Terminalsudo install -o redis -g redis -m 660 /var/backups/redis/dump-2026-11-18_024500.rdb /var/lib/redis/dump.rdb -
Si vous utilisez AOF, remplacez
appendonly yesparappendonly nodans/etc/redis/local.conf, puis démarrez Redis :Terminalsudo systemctl start redis-server -
Vérifiez vos données avec
DBSIZEdans une sessionadmin. Si vous utilisez AOF, réactivez-le à chaud avecCONFIG SET appendonly yes, attendez la fin de sa création comme expliqué dans la section sur la persistance, puis remettezappendonly yesdanslocal.conf.
Mettre à jour Redis
Sauvegardez d'abord vos données, puis mettez à jour le paquet :
sudo systemctl start redis-backup.service
sudo apt update
sudo apt install --only-upgrade redis redis-server redis-tools
redis-server --version
sudo systemctl status redis-server --no-pagerSi apt signale que /etc/redis/redis.conf a changé, comparez les versions avant de décider. Si vous adoptez la nouvelle version, ajoutez de nouveau la ligne include /etc/redis/local.conf à la fin du fichier. Lisez aussi les notes de version avant de changer de version majeure.
En cas de problème
NOAUTH Authentication required.
Le client ne s'est pas authentifié, ce qui est attendu puisque default est désactivé. Indiquez un utilisateur avec --user et --askpass, ou configurez ces valeurs dans votre application.
WRONGPASS invalid username-password pair or user is disabled.
Le nom d'utilisateur ou le mot de passe est faux. Si vous avez perdu un mot de passe, générez-en un nouveau, remplacez son empreinte dans /etc/redis/users.acl, puis redémarrez Redis ou exécutez ACL LOAD.
NOPERM
L'utilisateur n'a pas accès à cette commande ou à cette clé. Depuis une session admin, ACL LOG indique ce qui a été refusé. Élargissez seulement ce qui est nécessaire.
OOM command not allowed when used memory > 'maxmemory'
La limite mémoire est atteinte avec une politique qui ne libère pas de clés. Augmentez maxmemory si le serveur le permet, supprimez des données inutiles, ou choisissez allkeys-lru si Redis sert de cache.
MISCONF Redis is configured to save RDB snapshots
Le dernier instantané a échoué, et Redis refuse les écritures pour vous alerter. Vérifiez l'espace disque, les droits et le journal :
df -h /var/lib/redis
sudo ls -ld /var/lib/redis
sudo tail -n 50 /var/log/redis/redis-server.logNotre guide Vérifier l'espace disque peut vous aider à libérer de la place.
WARNING Memory overcommit must be enabled!
Appliquez le réglage vm.overcommit_memory = 1 décrit dans la section sur la mémoire.
Redis ne démarre plus
Une erreur dans users.acl ou local.conf empêche le démarrage. Consultez le journal :
sudo journalctl -u redis-server -n 50 --no-pager
sudo tail -n 50 /var/log/redis/redis-server.logVérifiez aussi que users.acl existe et que l'utilisateur redis peut le lire. Ne définissez pas d'utilisateur dans redis.conf lorsque aclfile est utilisé : Redis refuse de mélanger les deux méthodes.
Could not connect to Redis at 127.0.0.1:6379: Connection refused
Redis est arrêté ou écoute ailleurs. Contrôlez sudo systemctl status redis-server et sudo ss -tlnp | grep redis.