Поиск
Справочник

maxmemory в Redis: лимит памяти и что удалять при лимите

После установки у Redis нет лимита памяти: он занимает столько, сколько в нём данных. Настройка maxmemory задаёт потолок, а maxmemory-policy — что делать, когда Redis до него дошёл: удалять старые ключи или отвечать ошибкой на запись.

≈ 8 мин чтения
Содержание 9

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите, сколько памяти свободно на сервере: free -h. Нужен столбец available — как читать ответ.
  3. Посмотрите, сколько занимает Redis и какой у него лимит: redis-cli INFO memory | grep -E 'used_memory_human|maxmemory_human|maxmemory_policy'. Если на Redis стоит пароль, пишите redis-cli --askpass INFO memory и дальше так же.
  4. Откройте файл настроек: sudo nano /etc/redis/redis.conf.
  5. Найдите строку # maxmemory <bytes>: Ctrl+W, напечатайте maxmemory <bytes>, Enter. Под ней допишите две строки:
    maxmemory 256mb
    maxmemory-policy allkeys-lru

    Число 256 подберите под свой сервер — сколько поставить. allkeys-lru подходит, если Redis служит только кэшем — какую политику выбрать.

  6. Сохраните файл: Ctrl+O, Enter, затем Ctrl+X.
  7. Перезапустите Redis: sudo systemctl restart redis-server.
  8. Проверьте: снова выполните команду из шага 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:noeviction
  • used_memory_human — сколько памяти занято данными Redis сейчас.
  • maxmemory_human:0B — лимита нет. Так стоит после установки в Ubuntu: строка maxmemory в redis.conf закомментирована.
  • maxmemory_policy:noeviction — при лимите Redis ничего не удаляет и отвечает ошибкой на запись. Это значение по умолчанию.

Без лимита Redis будет занимать память, пока данные растут. Когда на сервере закончится свободная память, система остановит одну из программ, которые занимают больше всего памяти, — Redis или базу данных сайта: Out of memory: Killed process. Лимит не даёт до этого дойти.

Сколько памяти отдать

Лимит считают от свободной памяти сервера, а не от всей:

  1. Выполните free -h и посмотрите столбец available в строке Mem — столько можно занять, не трогая другие программы.
  2. Вычтите запас на рост сайта и базы данных.
  3. Если в Redis включено сохранение на диск, оставьте ещё запас: пока Redis пишет снимок, он может занять до двух раз больше памяти, если в это время идёт много записей. Снимки в Ubuntu включены — сохранение на диск.
  4. 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Политика
только кэш: страницы, запросы к базе, объектный кэш WordPressallkeys-lru — документация Redis советует её, если не знаете, что выбрать
кэш и данные, которые нельзя терять, в одном Redisvolatile-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:9120
  • evicted_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 mbFATAL 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.

Источники

Сверено 5 ноября 2026 года.

Если не хочется держать базу на своём сервере. Есть облачные базы данных: MySQL, PostgreSQL или Redis без своего VPS, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

Что почитать дальше