Redis: Could not connect to Redis at 127.0.0.1:6379: Connection refused
По адресу и порту, куда идёт подключение, никто не ждёт подключений: служба Redis остановлена, упала при запуске или слушает другой адрес. Начните с проверки службы.
Содержание 8
Как выглядит ошибка
Could not connect to Redis at 127.0.0.1:6379: Connection refusedТак отвечает redis-cli. Если запустить его без команды, строка ввода станет not connected>. Приложения на PHP, Python и Node.js пишут ту же причину — Connection refused — в своём сообщении об ошибке. Тексты сверены с исходным кодом Redis 7.0.15 — эта версия ставится из пакетов Ubuntu 24.04 — и Redis 8.0.5 из пакетов Ubuntu 26.04.
Плагин Redis Object Cache для WordPress вместо сайта показывает страницу:
Error establishing a Redis connectionПодробности — текст ошибки и подсказки — плагин выводит только в админке и при включённом WP_DEBUG.
Шаг 1. Проверьте, запущен ли Redis
Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
sudo systemctl status redis-serversudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. Смотрите на строку Active:
| Строка Active | Что это значит |
|---|---|
active (running) | Redis работает — переходите к шагу 3 |
inactive (dead) | служба остановлена — запустите её |
failed | Redis упал при запуске — причина в журнале, шаг 2 |
activating (auto-restart) | Redis падает и запускается снова — шаг 2 |
Запустить остановленную службу:
sudo systemctl start redis-serverЕсли systemctl ответил, что службы redis-server нет, Redis на сервере не установлен — как его установить.
Шаг 2. Если Redis не запускается, прочитайте журнал
Журнал Redis в Ubuntu — файл /var/log/redis/redis-server.log. Папка закрыта для посторонних, поэтому читать журнал нужно через sudo. Последние строки:
sudo tail -n 30 /var/log/redis/redis-server.logОшибки в файле настроек Redis пишет не в свой журнал, а в журнал службы:
sudo journalctl -u redis-server -n 30 --no-pager| Что в журнале | Где разобрано |
|---|---|
FATAL CONFIG FILE ERROR | ошибка в redis.conf |
Address already in use | порт 6379 занят другой программой |
Start request repeated too quickly | служба упала несколько раз подряд |
Short read or OOM loading DB | Redis не смог загрузить данные с диска |
Шаг 3. Проверьте адрес и порт
Посмотрите, на каких адресах Redis ждёт подключений:
sudo ss -ltnp | grep redisВ ответе должен быть адрес 127.0.0.1:6379, а если на сервере включён IPv6, ещё и [::1]:6379. Такие адреса задают строки bind и port в redis.conf:
sudo grep -n -E "^(bind|port)" /etc/redis/redis.confВ Ubuntu по умолчанию там bind 127.0.0.1 -::1 и port 6379: Redis принимает подключения только с самого сервера. Отсюда три случая, когда Redis работает, а подключиться нельзя:
- Приложение подключается к внешнему IP-адресу сервера, а Redis слушает только 127.0.0.1. Укажите в приложении адрес 127.0.0.1.
- В redis.conf изменён порт. Укажите в приложении тот же порт, что в строке port.
- Приложение работает в контейнере Docker. Адрес 127.0.0.1 внутри контейнера — это сам контейнер, а не сервер, поэтому Redis там не найдётся.
Где приложения хранят адрес Redis:
| Приложение | Где адрес и порт |
|---|---|
| WordPress с плагином Redis Object Cache | файл wp-config.php, константы WP_REDIS_HOST и WP_REDIS_PORT; если их нет — 127.0.0.1 и 6379 |
| Laravel | файл .env, переменные REDIS_HOST и REDIS_PORT; если их нет — 127.0.0.1 и 6379 |
В Laravel, если настройки закэшированы командой php artisan config:cache, после правки .env выполните эту команду ещё раз — иначе приложение не увидит изменений.
Если приложение работает на другом сервере, не открывайте Redis в интернет без пароля и фаервола — кто может подключиться к Redis.
Если сайт на WordPress лежит, а Redis быстро не поднять
Плагин Redis Object Cache можно выключить, не заходя в админку. Откройте wp-config.php в папке сайта и допишите строку выше строки с надписью That's all, stop editing!:
define( 'WP_REDIS_DISABLED', true );Сайт заработает без кэша Redis. Когда Redis снова запустится, удалите эту строку.
Как проверить
redis-cli pingОтвет PONG значит, что Redis принимает подключения. Ответ (error) NOAUTH Authentication required. значит то же самое, просто на Redis стоит пароль — как подключиться с паролем. Затем откройте сайт или перезапустите приложение.
Источники
- Исходный код Redis 7.0.15: redis-cli.c — текст Could not connect to Redis, ключ --askpass и предупреждение о пароле в команде.
- Файл redis.conf в Ubuntu 24.04 — значения по умолчанию: bind, protected-mode, порт, журнал, папка с данными.
- Файл службы redis-server в Ubuntu 24.04 — строка запуска, пользователь redis, папки, куда служба может писать.
- Redis Object Cache 3.0.0: README — константы WP_REDIS_HOST, WP_REDIS_PORT, WP_REDIS_PASSWORD и WP_REDIS_DISABLED.
- Redis Object Cache 3.0.0: object-cache.php — страница Error establishing a Redis connection.
- Laravel 12: config/database.php — переменные REDIS_HOST, REDIS_PORT, REDIS_USERNAME и REDIS_PASSWORD.
Сверено 22 октября 2026 года.
Что почитать дальше
- Как установить Redis на Ubuntu.
- NOAUTH Authentication required.
- Address already in use при запуске Redis.
- Все ошибки Redisтаблица по тексту сообщения.
- bind и protected-mode в Redisкто может подключиться к Redis.
- Redis через сокеткак подключить сайт без порта 6379.
- Журнал Redisгде лежит и как найти в нём ошибку.