RU

Linux и сеть

Установка и защита Redis

Установите Redis из официального репозитория на Debian или Ubuntu: пользователи ACL, локальное прослушивание, персистентность RDB и AOF, лимит памяти, резервное копирование и восстановление.

9 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Это руководство объясняет, как установить Redis на ваш VPS или выделенный сервер из официального репозитория, защитить его с помощью пользователей ACL, выбрать подходящий режим персистентности, ограничить потребление памяти и сохранять его данные.

Redis рассчитан на работу с доверенными клиентами. Поэтому здесь он доступен только локально, а каждое приложение подключается к нему с учётной записью с ограниченными правами.

Заказать сервер

Redis хранит данные в памяти: предусмотрите достаточно оперативной памяти для ваших данных и для фоновых резервных копий. HostMyServers предлагает несколько тарифов:

Предварительные требования

  • Сервер под управлением Debian 12 или 13 либо Ubuntu 22.04 или 24.04
  • Доступ по SSH с пользователем, у которого есть sudo
  • Обновлённая система (sudo apt update && sudo apt upgrade)

Порты, которые нужно открыть

Никакие. Redis слушает порт 6379 на 127.0.0.1 и ::1. Для доступа с вашего компьютера используйте SSH-туннель, описанный ниже: он проходит через уже открытый порт SSH.

Установка Redis из официального репозитория

На момент написания официальный репозиторий предлагает Redis 8.10 для Debian 12 и 13, а также Ubuntu 22.04 и 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-server

Проверка установки

Терминал
redis-server --version
sudo systemctl status redis-server --no-pager
redis-cli ping
sudo ss -tlnp | grep 6379

redis-cli ping должен ответить PONG. ss должен показать прослушивание только на 127.0.0.1:6379 и [::1]:6379.

Элемент Расположение
Конфигурация пакета /etc/redis/redis.conf
Ваши параметры (создаётся ниже) /etc/redis/local.conf
Пользователи (создаётся ниже) /etc/redis/users.acl
Данные /var/lib/redis/
Журнал /var/log/redis/redis-server.log

Создание пользователей ACL

По умолчанию любое локальное подключение может выполнять все команды. Вы отключите этого пользователя default и создадите три учётные записи:

Пользователь Права
admin Полное администрирование
app Чтение и запись ключей app:*, без опасных команд
backup Только запуск резервного копирования, без доступа к ключам
  1. Сгенерируйте пароли и файл пользователей. В нём сохраняются только их хеши SHA-256:

    Терминал
    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. Сохраните пароль резервного копирования для скрипта, затем выведите два других, чтобы занести их в ваш менеджер паролей:

    Терминал
    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. Создайте файл с вашими параметрами. Он остаётся отдельно от redis.conf, что упрощает обновления:

    Терминал
    sudo install -o redis -g redis -m 640 /dev/null /etc/redis/local.conf
    sudo nano /etc/redis/local.conf
    Конфигурация
    aclfile /etc/redis/users.acl
    maxmemory 512mb
    maxmemory-policy noeviction

    Подберите maxmemory под ваш сервер, как объясняется в разделе о памяти.

  4. Подключите этот файл в конце конфигурации, затем перезапустите службу:

    Терминал
    echo 'include /etc/redis/local.conf' | sudo tee -a /etc/redis/redis.conf
    sudo systemctl restart redis-server
  5. Проверьте результат:

    Терминал
    redis-cli ping
    redis-cli --user admin --askpass ping
    redis-cli --user app --askpass

    Первая команда должна ответить NOAUTH Authentication required., а вторая — PONG после ввода пароля admin. В сеансе, открытом третьей командой, с паролем app:

    Текст
    SET app:test ok
    GET app:test
    DEL app:test
    SET autre:test non
    FLUSHALL

    Первые три команды должны выполниться успешно. Две последние должны быть отклонены с ошибкой NOPERM.

В вашем приложении укажите пользователя app, его пароль и добавляйте к ключам префикс app:. Если ему нужны другие команды, измените его строку в users.acl, затем перезагрузите файл из сеанса admin командой ACL LOAD.

Доступ к Redis с вашего компьютера

Откройте SSH-туннель и не закрывайте эту команду:

Терминал
ssh -N -L 6380:127.0.0.1:6379 ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРА

В другом терминале подключитесь через локальный порт 6380:

Терминал
redis-cli -p 6380 --user admin --askpass

Если удалённое приложение действительно не может работать через туннель или частную сеть, настройте TLS, сохранив ACL, и ограничьте порт в брандмауэре адресом этого клиента.

Выбор режима персистентности

Режим Принцип работы Риск потери данных Рекомендуемое применение
RDB Регулярные снимки в dump.rdb С момента последнего снимка Данные, которые можно частично воссоздать
AOF Журнал записей, по умолчанию синхронизируется каждую секунду Около одной секунды Важные данные
RDB + AOF Оба режима одновременно Около одной секунды Лучший выбор для данных, которые нужно сохранить
Нет Всё теряется при перезапуске Полная Чистый кэш

RDB включён по умолчанию с порогами 3600 1 300 100 60 10000: снимок через 1 час, если изменился хотя бы 1 ключ, через 5 минут при 100 ключах, через 1 минуту при 10 000 ключей.

Включение AOF без потери данных

  1. Откройте сеанс admin:

    Терминал
    redis-cli --user admin --askpass
  2. Включите AOF и отслеживайте его создание:

    Текст
    CONFIG SET appendonly yes
    INFO persistence

    Повторяйте INFO persistence, пока не получите aof_rewrite_in_progress:0, aof_rewrite_scheduled:0 и aof_last_bgrewrite_status:ok.

  3. Добавьте следующую строку в /etc/redis/local.conf, чтобы сохранить этот параметр:

    Конфигурация
    appendonly yes
  4. Перезапустите Redis, затем убедитесь с помощью DBSIZE, что количество ключей не изменилось:

    Терминал
    sudo systemctl restart redis-server

Использование Redis как чистого кэша

Если все данные можно восстановить, добавьте эти строки в /etc/redis/local.conf и перезапустите службу:

Конфигурация
save ""
appendonly no
maxmemory-policy allkeys-lru

Контроль памяти

По умолчанию в 64-разрядной системе у Redis нет лимита памяти. Всегда задавайте maxmemory, оставляя место для системы, ваших других служб и буферов Redis. Во время резервного копирования на экземпляре с интенсивной записью Redis может потреблять до двух раз больше обычного объёма памяти.

Политика Поведение при достижении лимита Применение
noeviction Отклоняет новые записи Данные, которые нельзя терять
allkeys-lru Удаляет наименее недавно использованные ключи Универсальный кэш
allkeys-lfu Удаляет наименее часто используемые ключи Кэш с очень востребованными ключами
volatile-lru Удаляет среди ключей со сроком действия Кэш и данные вперемешку
volatile-ttl Удаляет ключи, срок действия которых истекает раньше всего Хорошо контролируемые сроки действия

Включите рекомендованный Redis параметр ядра, чтобы повысить надёжность фонового резервного копирования:

Терминал
echo 'vm.overcommit_memory = 1' | sudo tee /etc/sysctl.d/90-redis.conf
sudo sysctl --system

Для мониторинга использования из сеанса admin:

Текст
INFO memory
INFO stats
MEMORY DOCTOR

Обратите внимание прежде всего на used_memory_human, maxmemory_human, mem_fragmentation_ratio и evicted_keys.

Автоматизация резервного копирования

Файл RDB можно копировать во время работы Redis: он заменяется только после завершения нового снимка. Скрипт запрашивает свежий снимок, дожидается его завершения, затем копирует его.

  1. Создайте скрипт:

    Терминал
    sudo nano /usr/local/sbin/redis-backup.sh
    Терминал
    #!/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. Создайте службу:

    Терминал
    sudo chmod 700 /usr/local/sbin/redis-backup.sh
    sudo nano /etc/systemd/system/redis-backup.service
    Конфигурация
    [Unit]
    Description=Redis backup
    After=redis-server.service
    
    [Service]
    Type=oneshot
    ExecStart=/usr/local/sbin/redis-backup.sh
  3. Создайте таймер:

    Терминал
    sudo nano /etc/systemd/system/redis-backup.timer
    Конфигурация
    [Unit]
    Description=Daily Redis backup
    
    [Timer]
    OnCalendar=*-*-* 02:45:00
    RandomizedDelaySec=10min
    Persistent=true
    
    [Install]
    WantedBy=timers.target
  4. Включите его и запустите первую резервную копию:

    Терминал
    sudo systemctl daemon-reload
    sudo systemctl enable --now redis-backup.timer
    sudo systemctl start redis-backup.service
    sudo ls -lh /var/backups/redis

Проверка восстановления

Этот тест загружает последнюю резервную копию во временный экземпляр, доступный только через локальный сокет. Ваш рабочий экземпляр не изменяется.

Терминал
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

Сравните это число с числом в рабочем экземпляре и прочитайте несколько важных ключей командой GET. Затем остановите тестовый экземпляр и удалите его файлы:

Терминал
sudo -u redis redis-cli -s /var/lib/redis-restore-test/redis.sock SHUTDOWN NOSAVE
sudo rm -rf /var/lib/redis-restore-test

Если ваши данные используют модули JSON, Search, TimeSeries или Bloom, добавьте в команду запуска соответствующие параметры --loadmodule с путями, указанными в /etc/redis/redis.conf.

Восстановление после сбоя

Когда AOF включён, Redis загружает данные из AOF и игнорирует dump.rdb. Поэтому на время восстановления процедура отключает AOF.

  1. Остановите приложения и Redis, затем уберите в сторону текущие файлы:

    Терминал
    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. Скопируйте выбранную резервную копию, изменив её имя:

    Терминал
    sudo install -o redis -g redis -m 660 /var/backups/redis/dump-2026-11-18_024500.rdb /var/lib/redis/dump.rdb
  3. Если вы используете AOF, замените в /etc/redis/local.conf appendonly yes на appendonly no, затем запустите Redis:

    Терминал
    sudo systemctl start redis-server
  4. Проверьте ваши данные командой DBSIZE в сеансе admin. Если вы используете AOF, снова включите его на лету командой CONFIG SET appendonly yes, дождитесь завершения его создания, как описано в разделе о персистентности, затем верните appendonly yes в local.conf.

Обновление Redis

Сначала сохраните ваши данные, затем обновите пакет:

Терминал
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

Если apt сообщает, что /etc/redis/redis.conf изменился, сравните версии, прежде чем принимать решение. Если вы принимаете новую версию, снова добавьте строку include /etc/redis/local.conf в конец файла. Перед переходом на новую основную версию прочитайте также примечания к выпуску.

Если что-то пошло не так

NOAUTH Authentication required.

Клиент не прошёл аутентификацию, и это ожидаемо, так как default отключён. Укажите пользователя через --user и --askpass либо задайте эти значения в вашем приложении.

WRONGPASS invalid username-password pair or user is disabled.

Имя пользователя или пароль неверны. Если вы потеряли пароль, сгенерируйте новый, замените его хеш в /etc/redis/users.acl, затем перезапустите Redis или выполните ACL LOAD.

NOPERM

У пользователя нет доступа к этой команде или этому ключу. В сеансе admin команда ACL LOG покажет, что было отклонено. Расширяйте права только в необходимой мере.

OOM command not allowed when used memory > 'maxmemory'

Лимит памяти достигнут при политике, которая не освобождает ключи. Увеличьте maxmemory, если сервер позволяет, удалите ненужные данные или выберите allkeys-lru, если Redis используется как кэш.

MISCONF Redis is configured to save RDB snapshots

Последний снимок не удался, и Redis отклоняет записи, чтобы предупредить вас. Проверьте свободное место на диске, права и журнал:

Терминал
df -h /var/lib/redis
sudo ls -ld /var/lib/redis
sudo tail -n 50 /var/log/redis/redis-server.log

Наше руководство Проверка свободного места на диске поможет освободить место.

WARNING Memory overcommit must be enabled!

Примените параметр vm.overcommit_memory = 1, описанный в разделе о памяти.

Redis больше не запускается

Ошибка в users.acl или local.conf не даёт службе запуститься. Посмотрите журнал:

Терминал
sudo journalctl -u redis-server -n 50 --no-pager
sudo tail -n 50 /var/log/redis/redis-server.log

Проверьте также, что users.acl существует и что пользователь redis может его читать. Не определяйте пользователей в redis.conf, когда используется aclfile: Redis не позволяет смешивать два способа.

Could not connect to Redis at 127.0.0.1:6379: Connection refused

Redis остановлен или слушает по другому адресу. Проверьте sudo systemctl status redis-server и sudo ss -tlnp | grep redis.

Ссылки