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

Как настроить Redis на Ubuntu 24.04 и работать с ним через redis-cli

Redis на Ubuntu 24.04 ставится пакетом redis-server и сразу слушает только localhost на порту 6379. Подключение и проверка идут через redis-cli: команда redis-cli ping должна вернуть PONG. Пароль, лимит памяти и сохранение на диск задаются в /etc/redis/redis.conf, после правки нужен перезапуск службы.

Руководство Redis 3 мин чтения

01Установите redis-server

Пакет redis-server из репозитория Ubuntu 24.04 ставит Redis 7.0, службу redis-server и клиент redis-cli. После установки служба запускается сама и слушает bind 127.0.0.1 -::1 на порту 6379. Пароль по умолчанию не задан, строка # requirepass foobared в конфиге закомментирована.

bash
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, служба не запущена или слушает другой порт.

bash
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 не сработает.

text
requirepass YourStrongPassword

04Перезапустите службу и подключитесь с паролем

Перезапуск применяет новый пароль. Клиент без пароля получит NOAUTH Authentication required., поэтому в redis-cli пароль передают ключом -a или командой AUTH. Проверка: redis-cli -a YourStrongPassword ping возвращает PONG.

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

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

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

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

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

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