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

Redis туториал для начинающих: от проверки службы до первого ключа

Redis на Ubuntu 24.04 уже установлен пакетом redis-server и слушает только 127.0.0.1:6379. Вы проверите службу, выполните первые команды в redis-cli, зададите лимит памяти и пароль, подключите PHP и Laravel и убедитесь, что всё работает.

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

01Проверьте, что Redis установлен и запущен

На сервере Ubuntu 24.04 Redis ставится пакетом redis-server, служба называется redis-server (алиас redis). Проверьте статус и ответ на ping. Если пакета нет, установите его одной командой sudo apt install redis-server.

bash
sudo systemctl status redis-server
redis-cli ping

02Выполните первые команды в redis-cli

redis-cli подключается к 127.0.0.1:6379 без пароля, пока в конфиге не задан requirepass. Запишите ключ, прочитайте его и посмотрите время жизни. Команда SET с EX задаёт TTL в секундах, TTL возвращает остаток, -1 значит, что срок не задан.

bash
redis-cli SET greeting "hello" EX 60
redis-cli GET greeting
redis-cli TTL greeting
redis-cli DEL greeting

03Посмотрите, как Redis хранит данные

Данные лежат в /var/lib/redis, снимок RDB пишется в /var/lib/redis/dump.rdb по правилу save 3600 1 300 100 60 10000, AOF выключен (appendonly no). Конфиг находится в /etc/redis/redis.conf, лог в /var/log/redis/redis-server.log. Лимита памяти по умолчанию нет: maxmemory 0 и политика noeviction.

bash
redis-cli INFO memory
redis-cli CONFIG GET maxmemory

04Задайте лимит памяти для кэша

Для кэша ставят maxmemory и политику allkeys-lru, иначе при исчерпании памяти запись получит OOM command not allowed when used memory > 'maxmemory'. Настройку можно применить на ходу через CONFIG SET, а CONFIG REWRITE запишет её в redis.conf. После правки файла нужен sudo systemctl restart redis-server: systemctl reload redis-server не работает, в unit-файле нет ExecReload.

bash
redis-cli CONFIG SET maxmemory 256mb
redis-cli CONFIG SET maxmemory-policy allkeys-lru
redis-cli CONFIG REWRITE
sudo systemctl restart redis-server

05Включите сохранение на диск и проверьте лог

Если снимок RDB не записался, запись отклоняется ошибкой MISCONF Redis is configured to save RDB snapshots, but it's currently unable to persist to disk. Причина видна в логе, место проверяют через df -h /var/lib/redis. В логе при старте бывает WARNING Memory overcommit must be enabled!: параметр vm.overcommit_memory = 1 пишут в файл в /etc/sysctl.d/ и применяют sudo sysctl --system.

bash
sudo tail -n 50 /var/log/redis/redis-server.log
df -h /var/lib/redis

06Задайте пароль и закройте порт

Пароль задают директивой requirepass в /etc/redis/redis.conf, после чего клиент без пароля получает NOAUTH Authentication required.. В redis-cli пароль передают ключом -a. Порт 6379 в интернет не открывают: если Redis слушает внешний адрес, доступ оставляют файрволом только своим серверам.

text
requirepass exampleStrongPassword

07Подключите расширение PHP

Расширение для PHP 8.3 есть в репозитории Ubuntu: пакет php8.3-redis (phpredis 5.3.7). После установки перезагрузите FPM и проверьте модуль в CLI. Если Laravel работает с REDIS_CLIENT=phpredis без расширения, он падает с Class "Redis" not found.

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

08Настройте Laravel

Laravel берёт REDIS_HOST=127.0.0.1, REDIS_PORT=6379 и REDIS_PASSWORD из .env. Клиент задаёт REDIS_CLIENT: для phpredis нужно расширение, predis ставится через Composer. Если пароль задан в Redis, пропишите его в REDIS_PASSWORD, иначе приложение получит NOAUTH Authentication required..

ini
REDIS_CLIENT=phpredis
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=exampleStrongPassword

Частые ошибки

  • После правки redis.conf выполняют sudo systemctl reload redis-server, но получают ошибку: в unit-файле нет ExecReload.

    Перезапускайте службу командой sudo systemctl restart redis-server. Часть настроек можно применить на ходу через redis-cli CONFIG SET и сохранить через CONFIG REWRITE.

  • Клиент подключается без пароля и получает NOAUTH Authentication required.

    Передайте пароль в redis-cli ключом -a или командой AUTH, а в приложении пропишите его в REDIS_PASSWORD в .env.

  • Redis отвечает OOM command not allowed when used memory > 'maxmemory', запись не проходит.

    Для кэша задайте maxmemory-policy allkeys-lru, для очередей поднимите maxmemory. Проверьте текущие значения через redis-cli CONFIG GET maxmemory.

  • Laravel падает с Class "Redis" not found при REDIS_CLIENT=phpredis.

    Установите sudo apt install php8.3-redis, выполните sudo systemctl reload php8.3-fpm или перейдите на клиент predis через Composer.

Deploykin

Как это делается в Deploykin

В Deploykin Redis ставится на сервер в один клик и настраивается формой: пароль, лимит памяти, политика вытеснения, AOF. Доступ для серверов кластера включается одним переключателем, bind и файрвол панель настроит сама.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Нужно ли открывать порт 6379 в файрволе?

Нет. По умолчанию Redis слушает bind 127.0.0.1 -::1 с protected-mode yes, и снаружи он недоступен. Если Redis слушает внешний адрес, доступ оставляют файрволом только своим серверам и задают пароль.

Как поменять настройку Redis без перезапуска?

Часть настроек меняется на ходу, например redis-cli CONFIG SET maxmemory 256mb. Команда redis-cli CONFIG REWRITE запишет изменения в redis.conf, чтобы они сохранились после перезапуска.

Где Redis хранит данные?

Снимки RDB лежат в /var/lib/redis/dump.rdb, каталог данных /var/lib/redis. AOF по умолчанию выключен (appendonly no), лог пишется в /var/log/redis/redis-server.log.

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

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