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