Redis не запускается: причины и исправление ошибок
Сначала проверьте, работает ли служба redis-server и что она пишет в /var/log/redis/redis-server.log. Большинство ошибок подключения связаны с остановленной службой, неверным портом или паролем, а ошибки записи с памятью и правами на /var/lib/redis.
01Служба redis-server остановлена или упала при старте
Клиент печатает Could not connect to Redis at 127.0.0.1:6379: Connection refused, когда на порту 6379 никто не слушает. Проверьте состояние службы и последние строки лога: там видна причина падения, например синтаксическая ошибка в redis.conf или занятый порт. Если конфиг исправлен, перезапустите службу. В unit-файле redis-server нет ExecReload, поэтому systemctl reload redis-server не сработает, нужен именно restart.
sudo systemctl status redis-server
sudo tail -n 50 /var/log/redis/redis-server.log
sudo systemctl restart redis-server
redis-cli ping
02Redis слушает другой адрес или порт
Служба работает, но клиент по-прежнему получает Connection refused. По умолчанию в /etc/redis/redis.conf задано bind 127.0.0.1 -::1 и порт 6379, поэтому подключение с другого адреса не проходит. Сверьте bind и port в конфиге с тем адресом, который указывает приложение.
grep -E '^(bind|port)' /etc/redis/redis.conf
ss -lntp | grep 6379
03Не записывается снимок RDB: MISCONF
Запись отклоняется с MISCONF Redis is configured to save RDB snapshots, but it's currently unable to persist to disk. Redis сохраняет снимок в /var/lib/redis/dump.rdb по правилу save 3600 1 300 100 60 10000, и если запись не удалась, команды записи блокируются. Проверьте свободное место и права пользователя redis на каталог данных. Точную причину показывает лог.
df -h /var/lib/redis
sudo ls -ld /var/lib/redis
sudo tail -n 50 /var/log/redis/redis-server.log
04Исчерпана память: OOM command not allowed
Ошибка OOM command not allowed when used memory > 'maxmemory' означает, что задан maxmemory, он выбран, а политика noeviction запрещает вытеснять ключи. По умолчанию лимита нет (maxmemory 0), поэтому ошибка появляется после ручной настройки. Для кэша поставьте maxmemory-policy allkeys-lru, для очередей поднимите maxmemory. На ходу значения меняют через CONFIG SET, а CONFIG REWRITE записывает их в redis.conf.
redis-cli INFO memory
redis-cli CONFIG GET maxmemory
redis-cli CONFIG SET maxmemory 256mb
redis-cli CONFIG REWRITE
05Клиент подключается без пароля: NOAUTH
Ответ NOAUTH Authentication required. значит, что в redis.conf задан requirepass, а клиент не передал пароль. В redis-cli пароль передают ключом -a, в приложении его прописывают в REDIS_PASSWORD в .env.
grep -E '^requirepass' /etc/redis/redis.conf
redis-cli -a 'пароль' ping
06Protected mode блокирует внешнее подключение: DENIED
Сообщение DENIED Redis is running in protected mode because protected mode is enabled and no password is set for the default user приходит, когда подключение идёт не с локального адреса, а пароль не задан. Задайте requirepass и откройте порт 6379 файрволом только для своих серверов. Отключать protected-mode без пароля нельзя: Redis останется открытым для всех.
grep -E '^(bind|protected-mode|requirepass)' /etc/redis/redis.conf
sudo systemctl restart redis-server
07В PHP нет расширения redis: Class "Redis" not found
Laravel с REDIS_CLIENT=phpredis требует расширение PHP, иначе падает с Class "Redis" not found. В Ubuntu 24.04 расширение ставится пакетом php8.3-redis, после установки перезагрузите PHP-FPM. Для CLI проверьте список модулей.
sudo apt install php8.3-redis
sudo systemctl reload php8.3-fpm
php -m | grep redis
08Как убедиться, что ошибка ушла
Проверьте, что служба активна, отвечает на ping и клиент приложения подключается с теми же хостом, портом и паролем. После правки redis.conf службу перезапускают, потому что reload не поддерживается.
sudo systemctl status redis-server
redis-cli ping
redis-cli INFO memory | grep maxmemory
sudo tail -n 20 /var/log/redis/redis-server.log
Что не помогает
-
Перезагрузка конфига через
sudo systemctl reload redis-serverпосле правкиredis.conf.В unit-файле нет
ExecReload, поэтому изменения не применятся. Используйтеsudo systemctl restart redis-server. -
Отключение
protected-modeбез пароля, чтобы пустить внешние подключения.Задайте
requirepassи ограничьте порт 6379 файрволом. Открытый Redis без пароля доступен любому. -
Правка
maxmemoryбез смены политикиnoeviction.Для кэша задайте
maxmemory-policy allkeys-lru, иначе запись продолжит падать с ошибкой OOM. -
Удаление
dump.rdbили смена прав на/var/lib/redisнаугад при MISCONF.Сначала посмотрите лог и
df -h /var/lib/redis: чаще виноваты место на диске или владелец каталогаredis.
Deploykin
Как это делается в Deploykin
В Deploykin мониторинг проверяет Redis каждые 5 минут и присылает оповещение, если служба перешла в failed. Пароль, лимит памяти и политика вытеснения меняются формой, без правки redis.conf.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Почему systemctl reload redis-server не применяет новый конфиг?
В unit-файле redis-server нет ExecReload, поэтому reload не перечитывает /etc/redis/redis.conf. После правки нужен sudo systemctl restart redis-server.
Как проверить, что Redis слушает и отвечает?
Выполните redis-cli ping: рабочий сервер отвечает PONG. Порт и адрес показывает ss -lntp | grep 6379.
Где смотреть причину падения Redis?
В /var/log/redis/redis-server.log. Последние строки выводят командой sudo tail -n 50 /var/log/redis/redis-server.log.
Что делать с ошибкой OOM command not allowed?
Посмотрите redis-cli INFO memory и redis-cli CONFIG GET maxmemory. Для кэша поставьте maxmemory-policy allkeys-lru, для очередей поднимите maxmemory.
Как подключиться к Redis с паролем из консоли?
Передайте пароль ключом -a: redis-cli -a 'пароль' ping. В приложении пароль задают в REDIS_PASSWORD в .env.
Ещё по теме
- Руководство · Redis Как установить Redis на сервер Ubuntu 24.04 Пошаговая установка Redis на Ubuntu 24.04: apt, проверка службы, настройка памяти и пароля, PHP-расширение, проверка redis-cli ping и разбор частых ошибок.
- Руководство · Redis Как настроить Redis на Ubuntu 24.04 и работать с ним через redis-cli Установите Redis на Ubuntu 24.04, подключитесь через redis-cli, задайте пароль и лимит памяти, проверьте работу командами ping, INFO и CONFIG GET.
- Руководство · Redis Как настроить PHP Redis на сервере Ubuntu 24.04 Установите Redis и расширение php8.3-redis на Ubuntu 24.04, настройте кэш и пароль, подключитесь из PHP и Laravel. Команды, конфиги и проверка работы.
- Руководство · Redis Redis база данных: настройка на сервере Ubuntu 24.04 Пошаговая настройка Redis на Ubuntu 24.04: проверка службы, пароль, лимит памяти, сохранение на диск, PHP-расширение и проверка работы командами.
- Руководство · Redis Настройка Redis на Ubuntu 24.04: пошаговое руководство Пошаговая настройка Redis на Ubuntu 24.04: проверка службы, правка redis.conf, пароль, лимит памяти, сохранение на диск и проверка через redis-cli.
- Руководство · Redis Redis команды: пошаговое руководство с проверкой Пошаговое руководство по работе с Redis на Ubuntu 24.04: проверка службы, основные команды redis-cli, настройка памяти, пароля и проверка результата.
Redis на своём сервере: установка и настройка: все материалы темы