К содержимому

Redis не запускается: причины и исправление ошибок

Сначала проверьте, работает ли служба redis-server и что она пишет в /var/log/redis/redis-server.log. Большинство ошибок подключения связаны с остановленной службой, неверным портом или паролем, а ошибки записи с памятью и правами на /var/lib/redis.

Ошибка Redis 3 мин чтения

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.

bash
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 в конфиге с тем адресом, который указывает приложение.

bash
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 на каталог данных. Точную причину показывает лог.

bash
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.

bash
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.

bash
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 останется открытым для всех.

bash
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 проверьте список модулей.

bash
sudo apt install php8.3-redis
sudo systemctl reload php8.3-fpm
php -m | grep redis

08Как убедиться, что ошибка ушла

Проверьте, что служба активна, отвечает на ping и клиент приложения подключается с теми же хостом, портом и паролем. После правки redis.conf службу перезапускают, потому что reload не поддерживается.

bash
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 на своём сервере: установка и настройка: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.