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

Redis команды: пошаговое руководство с проверкой

Redis уже установлен на сервере, и вы хотите освоить основные команды для работы с ним. В этом руководстве вы проверите, что служба запущена, научитесь подключаться через redis-cli, выполнять базовые команды, настраивать память и пароль, а в конце проверите, что всё работает.

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

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

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

bash
sudo systemctl status redis-server
redis-cli ping

02Подключитесь к Redis через redis-cli

Запустите интерактивный клиент командой redis-cli. По умолчанию он подключается к 127.0.0.1:6379. Для выхода введите quit или нажмите Ctrl+D. Если задан пароль, используйте redis-cli -a ваш_пароль или выполните AUTH ваш_пароль после подключения.

bash
redis-cli
127.0.0.1:6379> ping
PONG
127.0.0.1:6379> quit

03Выполните основные команды Redis

Проверьте работу хранилища: запишите ключ mykey со значением hello, прочитайте его и удалите. Команда SET создаёт или перезаписывает ключ, GET возвращает значение, DEL удаляет ключ и возвращает количество удалённых ключей. Для просмотра всех ключей используйте KEYS * (осторожно на больших базах).

bash
redis-cli SET mykey "hello"
redis-cli GET mykey
redis-cli DEL mykey
redis-cli KEYS "*"

04Настройте лимит памяти и политику вытеснения

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

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

05Задайте пароль для подключения

Если Redis доступен не только с localhost, установите пароль директивой requirepass в /etc/redis/redis.conf. Раскомментируйте строку # requirepass foobared и замените foobared на свой пароль. После изменения перезапустите службу. Теперь клиент без пароля получит ошибку NOAUTH Authentication required..

bash
sudo nano /etc/redis/redis.conf
# найдите строку # requirepass foobared и измените её на:
requirepass ваш_сложный_пароль
sudo systemctl restart redis-server
redis-cli -a ваш_сложный_пароль ping

06Проверьте, что всё работает

Выполните несколько проверок: служба активна, redis-cli ping возвращает PONG, команды SET и GET работают, лимит памяти установлен. Если вы задали пароль, проверьте подключение с ним и без него (должна быть ошибка NOAUTH).

bash
sudo systemctl status redis-server
redis-cli ping
redis-cli SET test "ok"
redis-cli GET test
redis-cli CONFIG GET maxmemory
redis-cli -a ваш_сложный_пароль ping

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

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

    Перезапускайте службу командой sudo systemctl restart redis-server.

  • При подключении к Redis без пароля, когда задан requirepass, появляется ошибка NOAUTH Authentication required.

    Передайте пароль в redis-cli ключом -a или выполните команду AUTH ваш_пароль после подключения.

  • После установки расширения php8.3-redis PHP всё равно выдаёт Class "Redis" not found.

    Перезагрузите PHP-FPM командой sudo systemctl reload php8.3-fpm и проверьте наличие расширения: php -m | grep redis.

  • При исчерпании памяти и политике noeviction запись отклоняется с ошибкой OOM command not allowed when used memory > 'maxmemory'.

    Для кэша установите политику allkeys-lru командой redis-cli CONFIG SET maxmemory-policy allkeys-lru или увеличьте maxmemory.

Deploykin

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

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

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

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

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

Выполните redis-cli для интерактивного режима или redis-cli -a пароль при наличии пароля. По умолчанию клиент подключается к 127.0.0.1:6379.

Какая команда проверяет, что Redis работает?

redis-cli ping возвращает PONG, если сервер доступен. Также можно проверить статус службы: sudo systemctl status redis-server.

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

Используйте redis-cli CONFIG SET параметр значение, например CONFIG SET maxmemory 256mb. Чтобы сохранить изменение в файл, выполните CONFIG REWRITE.

Почему после настройки пароля клиент выдаёт ошибку NOAUTH?

В конфигурации задан requirepass, а клиент подключается без пароля. Передайте пароль ключом -a или командой AUTH.

Ещё по теме

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

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