Поиск
Справочник

redis-cli: как подключиться к Redis и вводить команды

redis-cli — программа, через которую команды отправляют в Redis прямо с сервера. Она ставится вместе с Redis. Её можно запустить с одной командой и сразу получить ответ или открыть окно, где команды вводят по одной.

≈ 9 мин чтения
Содержание 12

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Проверьте, что Redis отвечает: redis-cli ping. Ответ PONG — всё работает.
  3. Если в ответ пришло (error) NOAUTH Authentication required., на Redis стоит пароль. Введите redis-cli --askpass ping: программа напечатает Please input password:, наберите пароль и нажмите Enter. Вместо символов будут звёздочки.
  4. Откройте окно для команд: redis-cli или redis-cli --askpass. Строка ввода сменится на 127.0.0.1:6379>.
  5. Наберите команду, например INFO memory, и нажмите Enter.
  6. Выйти — quit и Enter.

Если в ответ на redis-cli ping пришло Could not connect to Redis at 127.0.0.1:6379: Connection refused, Redis не запущен — что делать. Если Redis не установлен — Как установить Redis на Ubuntu.

Одна команда или окно для команд

Одну команду пишут сразу после redis-cli и получают ответ:

redis-cli GET site:visits
"1520"

Без команды redis-cli открывает окно, где команды вводят по одной:

127.0.0.1:6379> SET test hello
OK
127.0.0.1:6379> GET test
"hello"
127.0.0.1:6379> DEL test
(integer) 1
127.0.0.1:6379> quit
  • Регистр команд не важен: get и GET — одно и то же. Имена ключей — важен: Test и test — разные ключи.
  • Клавиши вверх и вниз листают прошлые команды, Tab дописывает имя команды.
  • help SET — подсказка по команде: какие у неё части и с какой версии она есть.
  • Если Redis перезапустили, redis-cli сам подключится заново на следующей команде. Пока Redis не отвечает, строка ввода — not connected>.

Как читать ответы:

ОтветЧто значит
OKкоманда выполнена
"hello"значение ключа или текст
(integer) 1число: сколько ключей удалено, сколько секунд осталось и так далее
(nil)такого ключа нет
(empty array)пустой список, например ни одного ключа не нашлось
1) "maxmemory" 2) "0"список: каждая строка с номером
(error) ERR …ошибка, первое слово после (error) — её тип (все ошибки Redis)

Когда ответ redis-cli уходит в другую программу через |, он печатается без кавычек и номеров. Поэтому работает так:

redis-cli INFO memory | grep used_memory_human
used_memory_human:1.02M

Как войти с паролем

Если на Redis стоит пароль (как его поставить), есть три способа.

--askpass — redis-cli спросит пароль и не покажет его на экране:

redis-cli --askpass

AUTH внутри окна — откройте redis-cli и первой командой наберите AUTH ваш-пароль. Ответ OK — вы вошли. Эту команду redis-cli не записывает в историю.

-a — пароль прямо в команде: redis-cli -a ваш-пароль ping. redis-cli предупредит:

Warning: Using a password with '-a' or '-u' option on the command line interface may not be safe.

Пароль в команде сохранится в истории bash — файле ~/.bash_history, и пока команда работает, его видно в списке программ на сервере. Для работы руками берите --askpass.

Если вы завели в Redis отдельного пользователя (ACL), укажите его имя: redis-cli --user имя --askpass.

Для скриптов есть переменная окружения REDISCLI_AUTH: redis-cli берёт пароль из неё, и он не попадает в список программ. Если заданы и -a, и REDISCLI_AUTH, действует -a. С --askpass оба способа не действуют: redis-cli спросит пароль сам.

Номер базы, порт и сокет

КлючЧто делаетПример
-nномер базы внутри Redis, от 0 до 15redis-cli -n 1 DBSIZE
-pдругой порт, по умолчанию 6379redis-cli -p 6380 ping
-hдругой адрес, по умолчанию 127.0.0.1redis-cli -h 10.0.0.5 ping
-sподключение через файл-сокет вместо адреса и портаredis-cli -s /run/redis/redis-server.sock ping

Если база не нулевая, её номер виден в строке ввода: 127.0.0.1:6379[1]>. Внутри окна базу меняют командой SELECT 1. Зачем базы и как в них разобраться — базы и ключи Redis.

Через сокет строка ввода выглядит так: redis /run/redis/redis-server.sock>. Как включить сокет — Unix-сокет Redis.

Ключ -h нужен, только если Redis стоит на другом сервере и разрешает подключения снаружи. В Ubuntu Redis слушает только 127.0.0.1 — кто может подключиться.

Как найти ключи

redis-cli --scan --pattern 'sess:*'

redis-cli выведет все ключи, которые начинаются с sess:, по одному в строке. Звёздочка — любые символы. Сколько их:

redis-cli --scan --pattern 'sess:*' | wc -l

--scan перебирает ключи небольшими порциями, и Redis в это время отвечает сайту. Команда KEYS * делает то же одним разом и на большой базе останавливает Redis, пока не закончит. На рабочем сервере берите --scan. Подробно о поиске и удалении ключей — базы и ключи Redis.

Какие ключи самые большие

redis-cli --bigkeys

redis-cli пройдёт по всем ключам и в конце напечатает итог:

-------- summary -------

Sampled 1520 keys in the keyspace!
Total key length in bytes is 38914 (avg len 25.60)

Biggest string found 'cache:page:/catalog/' has 524301 bytes
Biggest   hash found 'user:1042' has 18 fields

1508 strings with 2201740 bytes (99.21% of keys, avg size 1460.04)
12 hashs with 96 fields (00.79% of keys, avg size 8.00)
  • Biggest string found … has 524301 bytes — самая длинная строка, около 512 КБ.
  • Для списков, наборов и хешей --bigkeys считает элементы, а не байты. Сколько ключ занимает в памяти, покажет --memkeys — вывод такой же, но везде в байтах.
  • Обе проверки идут порциями и не останавливают Redis.

Куда уходит память целиком — память Redis.

Наблюдение за Redis

--stat — каждую секунду новая строка:

redis-cli --stat
------- data ------ --------------------- load -------------------- - child -
keys       mem      clients blocked requests            connections
1520       1.85M    4       0       38201 (+12)         911
  • keys — сколько ключей во всех базах;
  • mem — сколько памяти занято;
  • clients — сколько подключений сейчас;
  • requests — сколько команд выполнено с запуска, в скобках — за последнюю секунду;
  • connections — сколько подключений было с запуска.

Остановить — Ctrl+C. Другой шаг — ключ -i: redis-cli --stat -i 5 печатает строку раз в 5 секунд.

--latency — как быстро Redis отвечает:

redis-cli --latency
min: 0, max: 2, avg: 0.11 (1854 samples)

Числа — в миллисекундах: меньше 1 мс в среднем — нормально. Строка обновляется, пока не нажмёте Ctrl+C. --latency-history пишет новую строку каждые 15 секунд — удобно оставить на время и посмотреть, когда ответы замедляются. Какие команды тормозят — SLOWLOG.

Повтор команды — ключи -r (сколько раз) и -i (пауза в секундах):

redis-cli -r 10 -i 1 INFO memory | grep used_memory_human

Команда выведет занятую память 10 раз, раз в секунду.

История команд

Команды из окна redis-cli сохраняются в файле ~/.rediscli_history в домашней папке пользователя: после перезапуска redis-cli их снова можно листать стрелками.

В историю не попадают команды с паролями: AUTH, ACL SETUSER, CONFIG SET requirepass. Если пароль всё же оказался в истории — например, вы набрали его в команде redis-cli -a — удалите строку из ~/.bash_history.

Сохранить снимок данных к себе

redis-cli --rdb /home/ubuntu/redis-kopiya.rdb

redis-cli попросит Redis сделать снимок всех данных и сохранит его в указанный файл. Это готовая копия для восстановления — резервная копия Redis.

Ошибки и как их исправить

Что видитеПричинаЧто делать
Could not connect to Redis at 127.0.0.1:6379: Connection refusedRedis не запущен или слушает другой портразбор
(error) NOAUTH Authentication required.на Redis стоит парольвойдите с --askpass — разбор
AUTH failed: WRONGPASS invalid username-password pair or user is disabled.неверный пароль или имя пользователяразбор
(error) ERR DB index is out of rangeномер базы больше 15в Ubuntu базы с 0 по 15 — базы и ключи
(error) ERR unknown command 'GTE', with args beginning with: 'test' опечатка в имени командыпроверьте подсказкой help GET
(error) WRONGTYPE Operation against a key holding the wrong kind of valueкоманда для другого типа ключаузнайте тип: TYPE имя-ключа
система отвечает, что программы redis-cli нетRedis не установленsudo apt install redis-tools или установка Redis

Все разборы — в разделе Ошибки Redis. Всё сверено с Redis 7.0.15 — эта версия ставится из пакетов Ubuntu 24.04. В Ubuntu 26.04 ставится Redis 8.0.5, ключи redis-cli те же.

Источники

Сверено 5 ноября 2026 года.

Если не хочется держать базу на своём сервере. Есть облачные базы данных: MySQL, PostgreSQL или Redis без своего VPS, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Когда это выгоднее своего сервера, а когда нет, — в статье Сервер для базы данных.

Что почитать дальше