Redis: ERR max number of clients reached
К Redis подключено столько клиентов, сколько разрешает настройка maxclients, — по умолчанию 10 000, и новые подключения он закрывает. Для небольшого сайта такое число говорит об утечке: приложение открывает подключения и не закрывает их.
Содержание 10
Как выглядит ошибка
(error) ERR max number of clients reachedОтветы Redis в программе redis-cli начинаются с (error). Приложение на PHP или Python показывает тот же текст без этой приставки, внутри своего сообщения об ошибке. Тексты сверены с исходным кодом Redis 7.0.15 — эта версия ставится из пакетов Ubuntu 24.04 — и Redis 8.0.5 из пакетов Ubuntu 26.04.
Redis отправляет этот ответ сразу после подключения и тут же закрывает соединение. Отказы он считает в строке rejected_connections — о ней ниже.
Почему подключений так много
Подключение занимает место в списке клиентов Redis, пока его не закроет приложение или сам Redis. В Ubuntu Redis молчащие подключения не закрывает: в redis.conf стоит timeout 0. Если приложение открывает новое подключение и не закрывает старое, они копятся, пока не дойдут до лимита.
Шаг 1. Освободите подключения
Пока лимит занят, redis-cli тоже не подключится. Перезапустите приложение, которое работает с Redis: когда процесс останавливается, его подключения закрываются. Для сайта на PHP в Ubuntu 24.04:
sudo systemctl restart php8.3-fpmВ Ubuntu 26.04 служба называется php8.5-fpm.
Для своего приложения — его службу, например sudo systemctl restart myapp. Если не знаете, какое приложение виновато, перезапустите Redis — он закроет все подключения:
sudo systemctl restart redis-serversudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.
Шаг 2. Посмотрите, кто держит подключения
Команды ниже набираются внутри redis-cli. Запустите его командой redis-cli, а если на Redis стоит пароль — redis-cli --askpass: программа спросит пароль и не покажет его на экране. Строка ввода станет 127.0.0.1:6379>. Выйти — команда exit.
INFO clientsСтрока connected_clients — сколько подключено сейчас, maxclients — лимит. Команда INFO stats покажет строку rejected_connections — сколько подключений Redis отклонил с момента запуска. Теперь список подключений:
CLIENT LISTОдна строка — одно подключение. Поле addr — адрес и порт клиента, age — сколько секунд подключение открыто, idle — сколько секунд оно молчит, cmd — последняя команда. Сотни строк с одним адресом и большим idle — подключения, которые приложение открыло и бросило.
Адрес 127.0.0.1 значит, что приложение на этом же сервере. Какой процесс держит подключения, покажет команда в терминале сервера — выйдите из redis-cli командой exit:
sudo ss -tnp | grep :6379Смотрите строки, где адрес с :6379 стоит во второй колонке адресов: в конце такой строки в скобках имя процесса клиента, например php-fpm или node.
Шаг 3. Закрывайте молчащие подключения
Снова откройте redis-cli и выполните:
CONFIG SET timeout 300Redis начнёт закрывать подключения, которые молчат дольше 300 секунд. Подключения подписки SUBSCRIBE и те, что ждут данных в BLPOP и похожих командах, timeout не трогает. Команда действует до перезапуска Redis. Чтобы настройка сохранилась, впишите её в файл. Файл настроек открывается так: sudo nano /etc/redis/redis.conf — как работать в nano. Найти строку в nano — Ctrl+W, сохранить — Ctrl+O и Enter, выйти — Ctrl+X.
Найдите строку timeout 0 и замените на:
timeout 300Сохраните файл. Перезапускать Redis не нужно — значение уже действует. Если приложение после этого начнёт жаловаться на закрытое соединение, увеличьте число, например до 3600.
Шаг 4. Найдите причину в приложении
Тайм-аут убирает последствия. Причину ищите в приложении, которое держит больше всех подключений:
- подключение к Redis создаётся в цикле или на каждый запрос и не закрывается;
- у приложения много процессов, и каждый держит свой пул подключений большого размера.
Если подключений правда нужно больше
Если приложение работает правильно, а подключений нужно больше 10 000, поднимите лимит. Файл настроек открывается так: sudo nano /etc/redis/redis.conf — как работать в nano. Найти строку в nano — Ctrl+W, сохранить — Ctrl+O и Enter, выйти — Ctrl+X.
Найдите строку # maxclients 10000 и ниже допишите:
maxclients 20000Сохраните файл и перезапустите Redis:
sudo systemctl restart redis-serverСлужба redis-server в Ubuntu может открыть до 65 535 файлов, а Redis нужно на 32 больше, чем maxclients. Если лимит выше, Redis при запуске сам уменьшит его и напишет в журнал … maxclients has been reduced to ….
Как проверить
В redis-cli через час после исправления снова выполните INFO clients. Число connected_clients должно быть заметно меньше maxclients и не расти без конца.
Источники
- Исходный код Redis 7.0.15: networking.c — ответ max number of clients reached и поля в выводе CLIENT LIST.
- Исходный код Redis 7.0.15: timeout.c — какие подключения Redis закрывает по настройке timeout.
- Исходный код Redis 7.0.15: server.c — тексты ответов с ошибками и строки журнала при запуске.
- Документация Redis: Redis client handling — лимит maxclients и тайм-аут молчащих подключений.
- Документация Redis: CLIENT LIST — что значат поля addr, age, idle и cmd.
- Файл redis.conf в Ubuntu 24.04 — значения по умолчанию: bind, protected-mode, порт, журнал, папка с данными.
- Файл службы redis-server в Ubuntu 24.04 — строки Type=notify, Restart=always и LimitNOFILE=65535.
Сверено 22 октября 2026 года.
Что почитать дальше
- Как установить Redis на Ubuntu.
- Could not connect to Redis: Connection refused.
- Процессы в Linux: ps, top и kill.
- Все ошибки Redisтаблица по тексту сообщения.
- Настройки Redisгде redis.conf и как применить изменения.
- redis-cliкак подключиться к Redis и вводить команды.