Настройка Redis на Ubuntu 24.04: пошаговое руководство
Redis на Ubuntu 24.04 ставится пакетом redis-server и по умолчанию слушает только 127.0.0.1 на порту 6379 без пароля. Настройка сводится к правке /etc/redis/redis.conf, перезапуску службы и проверке через redis-cli.
01Проверьте, что Redis установлен
На сервере с уже установленным Redis служба redis-server должна быть активна. Одна команда покажет её состояние и последние строки журнала. Если пакета нет, установите его: sudo apt install redis-server.
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 означает, что служба не запущена или слушает другой порт.
redis-cli ping
03Откройте конфигурационный файл
Основные параметры задаются в /etc/redis/redis.conf. Файл принадлежит пользователю redis и имеет права 640, поэтому редактируйте его через sudo. Перед правкой сделайте копию: sudo cp /etc/redis/redis.conf /etc/redis/redis.conf.bak.
sudo nano /etc/redis/redis.conf
04Задайте пароль
Найдите закомментированную строку # requirepass foobared и замените её на свой пароль. После этого клиент без пароля получит NOAUTH Authentication required., а в redis-cli пароль передают ключом -a или командой AUTH. Пароль также прописывают в REDIS_PASSWORD в .env приложения.
requirepass ваш_пароль
05Ограничьте потребление памяти
По умолчанию maxmemory 0, лимита нет, а политика вытеснения noeviction. Когда память исчерпана, запись получает OOM command not allowed when used memory > 'maxmemory'. Для кэша задайте лимит и политику allkeys-lru в конфиге или на ходу через CONFIG SET.
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.
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.
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.
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 Как установить 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 команды: пошаговое руководство с проверкой Пошаговое руководство по работе с Redis на Ubuntu 24.04: проверка службы, основные команды redis-cli, настройка памяти, пароля и проверка результата.
- Руководство · Redis Как работает Redis на Ubuntu 24.04: пошаговая настройка Разбираем, как работает Redis на Ubuntu 24.04: проверка службы, память, сохранение на диск, TTL, Streams и Cluster. Пошаговая настройка с командами и проверкой.
Redis на своём сервере: установка и настройка: все материалы темы