redis-cli: как подключиться к Redis и вводить команды
redis-cli — программа, через которую команды отправляют в Redis прямо с сервера. Она ставится вместе с Redis. Её можно запустить с одной командой и сразу получить ответ или открыть окно, где команды вводят по одной.
Содержание 12
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Проверьте, что Redis отвечает:
redis-cli ping. ОтветPONG— всё работает. - Если в ответ пришло
(error) NOAUTH Authentication required., на Redis стоит пароль. Введитеredis-cli --askpass ping: программа напечатаетPlease input password:, наберите пароль и нажмите Enter. Вместо символов будут звёздочки. - Откройте окно для команд:
redis-cliилиredis-cli --askpass. Строка ввода сменится на127.0.0.1:6379>. - Наберите команду, например
INFO memory, и нажмите Enter. - Выйти —
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_humanused_memory_human:1.02MКак войти с паролем
Если на Redis стоит пароль (как его поставить), есть три способа.
--askpass — redis-cli спросит пароль и не покажет его на экране:
redis-cli --askpassAUTH внутри окна — откройте 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 до 15 | redis-cli -n 1 DBSIZE |
-p | другой порт, по умолчанию 6379 | redis-cli -p 6380 ping |
-h | другой адрес, по умолчанию 127.0.0.1 | redis-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 --bigkeysredis-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) 911keys— сколько ключей во всех базах;mem— сколько памяти занято;clients— сколько подключений сейчас;requests— сколько команд выполнено с запуска, в скобках — за последнюю секунду;connections— сколько подключений было с запуска.
Остановить — Ctrl+C. Другой шаг — ключ -i: redis-cli --stat -i 5 печатает строку раз в 5 секунд.
--latency — как быстро Redis отвечает:
redis-cli --latencymin: 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.rdbredis-cli попросит Redis сделать снимок всех данных и сохранит его в указанный файл. Это готовая копия для восстановления — резервная копия Redis.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Could not connect to Redis at 127.0.0.1:6379: Connection refused | Redis не запущен или слушает другой порт | разбор |
(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 те же.
Источники
- Исходный код Redis 7.0.15: redis-cli.c — ключи и их значения по умолчанию, строка ввода с номером базы и сокетом, предупреждение о пароле, переменная REDISCLI_AUTH, команды, которые не попадают в историю, вывод --bigkeys, --stat и --latency.
- Документация Redis: Redis CLI — на английском: окно для команд, подсказки, история в .rediscli_history, повтор команд, --stat, --scan, --latency в миллисекундах, подключение заново после перезапуска Redis.
- Исходный код Redis 7.0.15: db.c — текст DB index is out of range.
- Исходный код Redis 7.0.15: server.c — тексты ошибок unknown command и WRONGTYPE.
- Исходный код Redis 7.0.15: acl.c — текст ошибки WRONGPASS.
- Файл redis.conf в Ubuntu 24.04 — 16 баз, адрес 127.0.0.1 и порт 6379.
- Пакет redis-tools в Ubuntu 24.04 — в пакете /usr/bin/redis-cli, его ставит пакет redis-server.
Сверено 5 ноября 2026 года.
Что почитать дальше
- Настройки Redisredis.conf, CONFIG SET и CONFIG REWRITE.
- Как установить Redis на Ubuntuустановка и подключение к сайту на PHP.
- Ошибки Redisразборы ошибок по тексту.