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

Redis база данных: настройка на сервере Ubuntu 24.04

Redis это хранилище данных в памяти с сохранением на диск, которое используют для кэша, очередей и сессий. На Ubuntu 24.04 оно ставится пакетом redis-server и по умолчанию доступно только с localhost.

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

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

На сервере уже должен быть Redis. Убедитесь, что служба активна и отвечает на запросы. Если пакета нет, установите его командой sudo apt install redis-server и вернитесь к проверке.

bash
redis-cli ping
sudo systemctl status redis-server

02Задайте пароль и проверьте доступ

По умолчанию в /etc/redis/redis.conf строка # requirepass foobared закомментирована, и Redis принимает команды без пароля. Раскомментируйте директиву и укажите свой пароль. После правки перезапустите службу: systemctl reload redis-server не работает, в unit-файле нет ExecReload.

text
requirepass ваш_пароль

03Перезапустите Redis и проверьте аутентификацию

Перезапуск применяет новый пароль. Клиент без пароля получит ошибку NOAUTH Authentication required., а с ключом -a должен ответить PONG.

bash
sudo systemctl restart redis-server
redis-cli ping
redis-cli -a ваш_пароль ping

04Ограничьте потребление памяти

По умолчанию maxmemory 0, и Redis может занять всю доступную память. Для кэша задайте лимит и политику вытеснения allkeys-lru. Команда CONFIG SET меняет настройку на ходу, CONFIG REWRITE записывает её в redis.conf.

bash
redis-cli -a ваш_пароль CONFIG SET maxmemory 256mb
redis-cli -a ваш_пароль CONFIG SET maxmemory-policy allkeys-lru
redis-cli -a ваш_пароль CONFIG REWRITE

05Проверьте сохранение на диск

Redis сохраняет снимки RDB в /var/lib/redis/dump.rdb по правилу save 3600 1 300 100 60 10000. Если снимок не записался, запись отклоняется ошибкой MISCONF. Убедитесь, что в логе нет ошибок сохранения и на разделе есть место.

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

06Установите расширение PHP для Redis

Для работы с Redis из PHP 8.3 нужен пакет php8.3-redis. После установки перезагрузите FPM, чтобы расширение подхватилось в пулах. Проверка для CLI: php -m | grep redis.

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

07Проверьте работу Redis

Убедитесь, что служба активна, пароль принимается, лимит памяти применён и расширение PHP видно. Команда INFO memory покажет текущее потребление и настройки.

bash
sudo systemctl status redis-server
redis-cli -a ваш_пароль ping
redis-cli -a ваш_пароль CONFIG GET maxmemory
redis-cli -a ваш_пароль INFO memory
php -m | grep redis

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

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

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

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

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

  • Redis перестаёт принимать запись с ошибкой MISCONF Redis is configured to save RDB snapshots, but it's currently unable to persist to disk.

    Проверьте место командой df -h /var/lib/redis и права пользователя redis на каталог. Причина также видна в /var/log/redis/redis-server.log.

  • Laravel падает с Class "Redis" not found, хотя Redis установлен.

    Установите расширение sudo apt install php8.3-redis и перезагрузите FPM командой sudo systemctl reload php8.3-fpm. Либо переключите REDIS_CLIENT на predis и поставьте его через Composer.

Deploykin

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

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

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

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

Чем Redis отличается от обычной базы данных?

Redis хранит данные в оперативной памяти и сохраняет снимки на диск, поэтому работает быстрее дисковых СУБД. Он подходит для кэша, очередей и сессий, но не заменяет реляционную базу для сложных запросов.

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

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

Что делать при ошибке OOM command not allowed when used memory > 'maxmemory'?

Память исчерпана, а политика noeviction запрещает вытеснение ключей. Для кэша задайте maxmemory-policy allkeys-lru, для очередей увеличьте maxmemory.

Чем заменить Redis?

Совместимый форк Valkey использует те же команды и протокол, поэтому клиенты и расширения PHP работают с ним без изменений. Для кэша также применяют Memcached, но он не поддерживает сохранение на диск и структуры данных Redis.

Ещё по теме

Redis на своём сервере: установка и настройка: все материалы темы

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