maxmemory в Redis: лимит памяти и что удалять при лимите
После установки у Redis нет лимита памяти: он занимает столько, сколько в нём данных. Настройка maxmemory задаёт потолок, а maxmemory-policy — что делать, когда Redis до него дошёл: удалять старые ключи или отвечать ошибкой на запись.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите, сколько памяти свободно на сервере:
free -h. Нужен столбец available — как читать ответ. - Посмотрите, сколько занимает Redis и какой у него лимит:
redis-cli INFO memory | grep -E 'used_memory_human|maxmemory_human|maxmemory_policy'. Если на Redis стоит пароль, пишитеredis-cli --askpass INFO memoryи дальше так же. - Откройте файл настроек:
sudo nano /etc/redis/redis.conf. - Найдите строку
# maxmemory <bytes>: Ctrl+W, напечатайтеmaxmemory <bytes>, Enter. Под ней допишите две строки:maxmemory 256mb maxmemory-policy allkeys-lruЧисло 256 подберите под свой сервер — сколько поставить. allkeys-lru подходит, если Redis служит только кэшем — какую политику выбрать.
- Сохраните файл: Ctrl+O, Enter, затем Ctrl+X.
- Перезапустите Redis:
sudo systemctl restart redis-server. - Проверьте: снова выполните команду из шага 3. В строке
maxmemory_humanдолжно быть256.00M.
Без перезапуска то же делают так: redis-cli CONFIG SET maxmemory 256mb maxmemory-policy allkeys-lru, затем redis-cli CONFIG REWRITE, чтобы записать в файл. Как это работает — настройки Redis.
Что сейчас
redis-cli INFO memory | grep -E 'used_memory_human|maxmemory_human|maxmemory_policy'used_memory_human:1.02M
maxmemory_human:0B
maxmemory_policy:noevictionused_memory_human— сколько памяти занято данными Redis сейчас.maxmemory_human:0B— лимита нет. Так стоит после установки в Ubuntu: строкаmaxmemoryв redis.conf закомментирована.maxmemory_policy:noeviction— при лимите Redis ничего не удаляет и отвечает ошибкой на запись. Это значение по умолчанию.
Без лимита Redis будет занимать память, пока данные растут. Когда на сервере закончится свободная память, система остановит одну из программ, которые занимают больше всего памяти, — Redis или базу данных сайта: Out of memory: Killed process. Лимит не даёт до этого дойти.
Сколько памяти отдать
Лимит считают от свободной памяти сервера, а не от всей:
- Выполните
free -hи посмотрите столбец available в строке Mem — столько можно занять, не трогая другие программы. - Вычтите запас на рост сайта и базы данных.
- Если в Redis включено сохранение на диск, оставьте ещё запас: пока Redis пишет снимок, он может занять до двух раз больше памяти, если в это время идёт много записей. Снимки в Ubuntu включены — сохранение на диск.
- Redis тратит память и сверх данных: на подключения и служебные таблицы. Документация Redis советует: если свободно 10 ГБ, ставьте 8 или 9.
Сколько на деле занимает ваш кэш, видно по used_memory_human после дня работы сайта.
Размер пишут числом с буквами без пробела: 256mb, 1gb. Лимит меньше 1 МБ Redis примет, но напишет предупреждение в журнал: так бывает при опечатке вроде maxmemory 256 — это 256 байт.
Политики вытеснения
Что делает Redis, когда занятая память дошла до maxmemory, задаёт maxmemory-policy:
| Политика | Что удаляет |
|---|---|
noeviction | ничего: на запись отвечает ошибкой OOM, чтение работает. Стоит по умолчанию |
allkeys-lru | любые ключи, к которым дольше всех не обращались |
allkeys-lfu | любые ключи, к которым обращались реже других |
allkeys-random | любые ключи наугад |
volatile-lru | только ключи с временем жизни, к которым дольше всех не обращались |
volatile-lfu | только ключи с временем жизни, к которым обращались реже других |
volatile-random | только ключи с временем жизни, наугад |
volatile-ttl | только ключи с временем жизни — те, которым осталось жить меньше всего |
Время жизни — срок, после которого Redis сам удаляет ключ. Его задают командой EXPIRE или при записи ключа — время жизни ключей.
volatile-… удаляют только ключи с временем жизни. Если таких ключей не осталось, Redis ведёт себя как при noeviction и отвечает на запись ошибкой.Redis выбирает ключ для удаления не из всех, а из небольшой выборки — по умолчанию 5 ключей, настройка maxmemory-samples. Поэтому удаляется не строго самый старый ключ, а один из старых. Для кэша разницы нет.
Какую политику выбрать
Удалённый ключ кэша сайт пересоздаст при следующем запросе. Удалённая сессия — это посетитель, которого выкинуло из аккаунта. Удалённая задача из очереди — задача, которая не выполнится. От этого и выбор:
| Что лежит в Redis | Политика |
|---|---|
| только кэш: страницы, запросы к базе, объектный кэш WordPress | allkeys-lru — документация Redis советует её, если не знаете, что выбрать |
| кэш и данные, которые нельзя терять, в одном Redis | volatile-lru: кэшу задайте время жизни, а важным ключам нет — тогда удаляется только кэш. Есть ли у ключа время жизни, покажет redis-cli TTL имя_ключа: ответ -1 — нет |
| очереди задач или данные, которые нельзя терять | noeviction и запас памяти: пусть лучше запись получит ошибку, чем данные пропадут молча |
Для кэша и важных данных документация Redis советует два отдельных Redis — каждому свою политику. В Ubuntu для этого есть шаблон службы redis-server@: второй Redis со своим файлом /etc/redis/redis-имя.conf.
Политику можно поменять на ходу: redis-cli CONFIG SET maxmemory-policy allkeys-lru.
Как проверить, что ключи удаляются
redis-cli INFO stats | grep -E 'evicted_keys|keyspace_hits|keyspace_misses'evicted_keys:3841
keyspace_hits:182044
keyspace_misses:9120evicted_keys— сколько ключей Redis удалил из-за лимита с момента запуска. Растёт — значит, лимит достигнут и политика работает.keyspace_hitsиkeyspace_misses— сколько раз сайт нашёл ключ в Redis и сколько раз нет.
Если evicted_keys растёт быстро, а промахов становится больше, кэшу тесно: поднимите maxmemory, если на сервере есть свободная память.
Сколько памяти занимает каждый тип данных и что такое фрагментация — память Redis: INFO memory.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
OOM command not allowed when used memory > 'maxmemory'. | лимит достигнут, а политика noeviction или у volatile-… нечего удалять | поднимите maxmemory или смените политику — разбор |
в журнале WARNING: You specified a maxmemory value that is less than 1MB | в maxmemory нет букв: maxmemory 256 — это 256 байт | допишите буквы: 256mb |
(error) ERR CONFIG SET failed (possibly related to argument 'maxmemory') - argument must be a memory value | размер написан не так | пишите без пробела: 256mb |
| Redis не запускается после правки | ошибка в строке, например maxmemory 256 mb | FATAL CONFIG FILE ERROR |
used_memory_human меньше лимита, а Redis всё равно занимает больше | память после удаления ключей не сразу возвращается системе | фрагментация памяти |
в журнале системы Out of memory: Killed process … (redis-server) | на сервере кончилась память, лимита не было или он слишком большой | задайте или уменьшите maxmemory — разбор |
Все разборы — в разделе Ошибки Redis. Всё сверено с Redis 7.0.15 — эта версия ставится из пакетов Ubuntu 24.04. В Ubuntu 26.04 ставится Redis 8.0.5.
Источники
- Документация Redis: Key eviction — на английском: maxmemory 0 — без лимита, восемь политик, volatile-политики без подходящих ключей ведут себя как noeviction, совет выбрать allkeys-lru, выборка maxmemory-samples.
- Документация Redis: Redis administration — на английском: лимит с запасом — 8 или 9 ГБ из 10, до двух раз больше памяти во время снимка.
- Файл redis.conf в Ubuntu 24.04 — строки maxmemory и maxmemory-policy закомментированы, политика по умолчанию noeviction, maxmemory-samples 5.
- Исходный код Redis 7.0.15: server.c — строки used_memory_human, maxmemory_human, maxmemory_policy, evicted_keys, keyspace_hits в ответе INFO, текст ошибки OOM, предупреждение о лимите меньше 1 МБ.
- Исходный код Redis 7.0.15: config.c — maxmemory и maxmemory-policy меняются на ходу, текст ошибки argument must be a memory value.
- Описание службы redis-server в Ubuntu 24.04 — шаблон службы redis-server@ с файлом /etc/redis/redis-имя.conf.
Сверено 5 ноября 2026 года.
Что почитать дальше
- Настройки Redisredis.conf, CONFIG SET и CONFIG REWRITE.
- Команда freeсколько памяти свободно на сервере.
- Ошибка OOM command not allowedчто делать, когда лимит достигнут.