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

Настройка Redis на Ubuntu 24.04: пошаговое руководство

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

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

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

На сервере с уже установленным Redis служба redis-server должна быть активна. Одна команда покажет её состояние и последние строки журнала. Если пакета нет, установите его: sudo apt install redis-server.

bash
sudo systemctl status redis-server

02Проверьте ответ Redis

Убедитесь, что сервер отвечает на запросы. Команда redis-cli ping возвращает PONG, если служба работает и порт 6379 доступен локально. Ответ Could not connect to Redis at 127.0.0.1:6379: Connection refused означает, что служба не запущена или слушает другой порт.

bash
redis-cli ping

03Откройте конфигурационный файл

Основные параметры задаются в /etc/redis/redis.conf. Файл принадлежит пользователю redis и имеет права 640, поэтому редактируйте его через sudo. Перед правкой сделайте копию: sudo cp /etc/redis/redis.conf /etc/redis/redis.conf.bak.

bash
sudo nano /etc/redis/redis.conf

04Задайте пароль

Найдите закомментированную строку # requirepass foobared и замените её на свой пароль. После этого клиент без пароля получит NOAUTH Authentication required., а в redis-cli пароль передают ключом -a или командой AUTH. Пароль также прописывают в REDIS_PASSWORD в .env приложения.

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

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

По умолчанию maxmemory 0, лимита нет, а политика вытеснения noeviction. Когда память исчерпана, запись получает OOM command not allowed when used memory > 'maxmemory'. Для кэша задайте лимит и политику allkeys-lru в конфиге или на ходу через CONFIG SET.

text
maxmemory 256mb
maxmemory-policy allkeys-lru

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.

text
save 3600 1 300 100 60 10000
appendonly no

07Перезапустите службу

В unit-файле redis-server нет ExecReload, поэтому systemctl reload redis-server не работает. После правки redis.conf нужен перезапуск. Часть параметров можно менять на ходу, например redis-cli CONFIG SET maxmemory 256mb, а redis-cli CONFIG REWRITE записывает их в redis.conf.

bash
sudo systemctl restart redis-server

08Проверьте настройки и работу

Убедитесь, что служба поднялась и параметры применились. redis-cli INFO memory покажет использование памяти, redis-cli CONFIG GET maxmemory вернёт действующий лимит. Если в логе при старте есть WARNING Memory overcommit must be enabled!, добавьте vm.overcommit_memory = 1 в файл в /etc/sysctl.d/ и примените sudo sysctl --system.

bash
sudo systemctl status redis-server
redis-cli INFO memory
redis-cli CONFIG GET maxmemory
sudo tail -n 50 /var/log/redis/redis-server.log

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

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

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

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

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

  • Redis слушает внешний адрес без пароля, и подключение с другого адреса получает DENIED Redis is running in protected mode because protected mode is enabled and no password is set for the default user.

    Задайте requirepass и оставьте доступ только своим серверам через файрвол. protected-mode no без пароля оставляет 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.

Deploykin

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

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

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

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

Какая версия Redis ставится на Ubuntu 24.04?

Пакет redis-server в репозитории Ubuntu 24.04 содержит Redis 7.0. Версию показывает redis-cli INFO server в строке redis_version.

Как проверить, что Redis работает?

Выполните redis-cli ping: ответ PONG означает, что служба запущена и отвечает на порту 6379. Состояние службы показывает sudo systemctl status redis-server.

Почему после правки конфига ничего не изменилось?

Redis читает /etc/redis/redis.conf при старте, а systemctl reload redis-server не работает из-за отсутствия ExecReload. Выполните sudo systemctl restart redis-server.

Как подключиться к Redis с паролем?

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

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

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

Ещё по теме

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

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