Установка и защита Redis
Установите Redis из официального репозитория на Debian или Ubuntu: пользователи ACL, локальное прослушивание, персистентность RDB и AOF, лимит памяти, резервное копирование и восстановление.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство объясняет, как установить 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 6379redis-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 |
Только запуск резервного копирования, без доступа к ключам |
-
Сгенерируйте пароли и файл пользователей. В нём сохраняются только их хеши 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 -
Сохраните пароль резервного копирования для скрипта, затем выведите два других, чтобы занести их в ваш менеджер паролей:
Терминал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 -
Создайте файл с вашими параметрами. Он остаётся отдельно от
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под ваш сервер, как объясняется в разделе о памяти. -
Подключите этот файл в конце конфигурации, затем перезапустите службу:
Терминалecho 'include /etc/redis/local.conf' | sudo tee -a /etc/redis/redis.conf sudo systemctl restart redis-server -
Проверьте результат:
Терминал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 без потери данных
-
Откройте сеанс
admin:Терминалredis-cli --user admin --askpass -
Включите AOF и отслеживайте его создание:
ТекстCONFIG SET appendonly yes INFO persistenceПовторяйте
INFO persistence, пока не получитеaof_rewrite_in_progress:0,aof_rewrite_scheduled:0иaof_last_bgrewrite_status:ok. -
Добавьте следующую строку в
/etc/redis/local.conf, чтобы сохранить этот параметр:Конфигурацияappendonly yes -
Перезапустите 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: он заменяется только после завершения нового снимка. Скрипт запрашивает свежий снимок, дожидается его завершения, затем копирует его.
-
Создайте скрипт:
Терминал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 -
Создайте службу:
Терминал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 -
Создайте таймер:
Терминал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 -
Включите его и запустите первую резервную копию:
Терминал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.
-
Остановите приложения и 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' -
Скопируйте выбранную резервную копию, изменив её имя:
Терминалsudo install -o redis -g redis -m 660 /var/backups/redis/dump-2026-11-18_024500.rdb /var/lib/redis/dump.rdb -
Если вы используете AOF, замените в
/etc/redis/local.confappendonly yesнаappendonly no, затем запустите Redis:Терминалsudo systemctl start redis-server -
Проверьте ваши данные командой
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.