Redis туториал для начинающих: от проверки службы до первого ключа
Redis на Ubuntu 24.04 уже установлен пакетом redis-server и слушает только 127.0.0.1:6379. Вы проверите службу, выполните первые команды в redis-cli, зададите лимит памяти и пароль, подключите PHP и Laravel и убедитесь, что всё работает.
01Проверьте, что Redis установлен и запущен
На сервере Ubuntu 24.04 Redis ставится пакетом redis-server, служба называется redis-server (алиас redis). Проверьте статус и ответ на ping. Если пакета нет, установите его одной командой sudo apt install redis-server.
sudo systemctl status redis-server
redis-cli ping
02Выполните первые команды в redis-cli
redis-cli подключается к 127.0.0.1:6379 без пароля, пока в конфиге не задан requirepass. Запишите ключ, прочитайте его и посмотрите время жизни. Команда SET с EX задаёт TTL в секундах, TTL возвращает остаток, -1 значит, что срок не задан.
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.
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.
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.
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 слушает внешний адрес, доступ оставляют файрволом только своим серверам.
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.
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..
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 Как установить Redis на сервер Ubuntu 24.04 Пошаговая установка Redis на Ubuntu 24.04: apt, проверка службы, настройка памяти и пароля, PHP-расширение, проверка redis-cli ping и разбор частых ошибок.
- Руководство · Redis Как настроить Redis на Ubuntu 24.04 и работать с ним через redis-cli Установите Redis на Ubuntu 24.04, подключитесь через redis-cli, задайте пароль и лимит памяти, проверьте работу командами ping, INFO и CONFIG GET.
- Руководство · 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 на своём сервере: установка и настройка: все материалы темы