FR

Linux et réseau

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.

10 min de lecture, mis à jour le 18 novembre 2026

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.

Terminal
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-server

Vérifier l'installation

Terminal
redis-server --version
sudo systemctl status redis-server --no-pager
redis-cli ping
sudo ss -tlnp | grep 6379

redis-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
  1. Générez les mots de passe et le fichier d'utilisateurs. Seules leurs empreintes SHA-256 y sont enregistrées :

    Terminal
    ADMIN_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
  2. 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 :

    Terminal
    printf '%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
  3. Créez votre fichier de réglages. Il reste séparé de redis.conf, ce qui simplifie les mises à jour :

    Terminal
    sudo install -o redis -g redis -m 640 /dev/null /etc/redis/local.conf
    sudo nano /etc/redis/local.conf
    Configuration
    aclfile /etc/redis/users.acl
    maxmemory 512mb
    maxmemory-policy noeviction

    Adaptez maxmemory à votre serveur, comme expliqué dans la section sur la mémoire.

  4. Chargez ce fichier à la fin de la configuration, puis redémarrez :

    Terminal
    echo 'include /etc/redis/local.conf' | sudo tee -a /etc/redis/redis.conf
    sudo systemctl restart redis-server
  5. Vérifiez le résultat :

    Terminal
    redis-cli ping
    redis-cli --user admin --askpass ping
    redis-cli --user app --askpass

    La première commande doit répondre NOAUTH Authentication required. et la deuxième PONG après la saisie du mot de passe admin. Dans la session ouverte par la troisième, avec le mot de passe app :

    Texte
    SET app:test ok
    GET app:test
    DEL app:test
    SET autre:test non
    FLUSHALL

    Les 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 :

Terminal
ssh -N -L 6380:127.0.0.1:6379 VOTRE_USER@VOTRE_IP_SERVEUR

Dans un autre terminal, connectez-vous par le port local 6380 :

Terminal
redis-cli -p 6380 --user admin --askpass

Si 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

  1. Ouvrez une session admin :

    Terminal
    redis-cli --user admin --askpass
  2. Activez AOF et suivez sa création :

    Texte
    CONFIG SET appendonly yes
    INFO persistence

    Répétez INFO persistence jusqu'à obtenir aof_rewrite_in_progress:0, aof_rewrite_scheduled:0 et aof_last_bgrewrite_status:ok.

  3. Ajoutez la ligne suivante à /etc/redis/local.conf pour conserver ce réglage :

    Configuration
    appendonly yes
  4. Redémarrez Redis, puis vérifiez avec DBSIZE que le nombre de clés n'a pas changé :

    Terminal
    sudo 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 :

Configuration
save ""
appendonly no
maxmemory-policy allkeys-lru

Maî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 :

Terminal
echo 'vm.overcommit_memory = 1' | sudo tee /etc/sysctl.d/90-redis.conf
sudo sysctl --system

Pour surveiller l'utilisation depuis une session admin :

Texte
INFO memory
INFO stats
MEMORY DOCTOR

Regardez 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.

  1. Créez le script :

    Terminal
    sudo nano /usr/local/sbin/redis-backup.sh
    Terminal
    #!/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
  2. Créez le service :

    Terminal
    sudo chmod 700 /usr/local/sbin/redis-backup.sh
    sudo nano /etc/systemd/system/redis-backup.service
    Configuration
    [Unit]
    Description=Redis backup
    After=redis-server.service
    
    [Service]
    Type=oneshot
    ExecStart=/usr/local/sbin/redis-backup.sh
  3. Créez le minuteur :

    Terminal
    sudo nano /etc/systemd/system/redis-backup.timer
    Configuration
    [Unit]
    Description=Daily Redis backup
    
    [Timer]
    OnCalendar=*-*-* 02:45:00
    RandomizedDelaySec=10min
    Persistent=true
    
    [Install]
    WantedBy=timers.target
  4. Activez-le et lancez une première sauvegarde :

    Terminal
    sudo 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.

Terminal
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 DBSIZE

Comparez 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 :

Terminal
sudo -u redis redis-cli -s /var/lib/redis-restore-test/redis.sock SHUTDOWN NOSAVE
sudo rm -rf /var/lib/redis-restore-test

Si 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.

  1. Arrêtez les applications et Redis, puis mettez de côté les fichiers actuels :

    Terminal
    sudo 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'
  2. Copiez la sauvegarde choisie, en adaptant son nom :

    Terminal
    sudo install -o redis -g redis -m 660 /var/backups/redis/dump-2026-11-18_024500.rdb /var/lib/redis/dump.rdb
  3. Si vous utilisez AOF, remplacez appendonly yes par appendonly no dans /etc/redis/local.conf, puis démarrez Redis :

    Terminal
    sudo systemctl start redis-server
  4. Vérifiez vos données avec DBSIZE dans une session admin. Si vous utilisez AOF, réactivez-le à chaud avec CONFIG SET appendonly yes, attendez la fin de sa création comme expliqué dans la section sur la persistance, puis remettez appendonly yes dans local.conf.

Mettre à jour Redis

Sauvegardez d'abord vos données, puis mettez à jour le paquet :

Terminal
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-pager

Si 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 :

Terminal
df -h /var/lib/redis
sudo ls -ld /var/lib/redis
sudo tail -n 50 /var/log/redis/redis-server.log

Notre 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 :

Terminal
sudo journalctl -u redis-server -n 50 --no-pager
sudo tail -n 50 /var/log/redis/redis-server.log

Vé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.

Références