Пароль в Redis и отдельные пользователи ACL
После установки Redis пускает без пароля любую программу, которая подключилась к нему на сервере. Пароль ставят одной строкой requirepass в redis.conf. Если нужно, чтобы сайт не мог стереть все данные или поменять настройки, создают для него отдельного пользователя ACL.
Содержание 11
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Получите надёжный пароль:
redis-cli ACL GENPASS. Redis ответит строкой из 64 букв и цифр в кавычках. Скопируйте её без кавычек. - Откройте файл настроек:
sudo nano /etc/redis/redis.conf. - Найдите строку
# requirepass foobared: Ctrl+W, напечатайтеrequirepass foobared, Enter. Под ней допишите строку со своим паролем:requirepass вставьте_сюда_пароль - Сохраните файл: Ctrl+O, Enter, затем Ctrl+X.
- Перезапустите Redis:
sudo systemctl restart redis-server. - Проверьте, что без пароля Redis не пускает:
redis-cli PING. Ответ должен быть(error) NOAUTH Authentication required. - Проверьте вход с паролем:
redis-cli --askpass PING. Redis спроситPlease input password:— вставьте пароль и нажмите Enter. При вводе пароль не виден. ОтветPONG— всё работает. - Впишите пароль в настройки подключения к Redis на сайте, иначе сайт перестанет получать данные из кэша.
Пароль из ACL GENPASS состоит только из цифр и букв a–f, поэтому его не нужно брать в кавычки ни в redis.conf, ни в настройках сайта.
Зачем пароль, если Redis слушает только сервер
В Ubuntu Redis принимает подключения только с самого сервера — строка bind 127.0.0.1 -::1 (подробнее). Но без пароля к нему подключится любая программа на сервере: чужой сайт, если их несколько, или взломанный плагин. Она прочитает сессии посетителей и сможет стереть все данные одной командой. Пароль закрывает эту дверь.
Как устроен пароль в Redis
С Redis 6 доступ устроен через пользователей. После установки есть один пользователь — default, и у него нет пароля. Строка requirepass задаёт пароль именно ему.
Посмотреть пользователей:
redis-cli --askpass ACL LIST1) "user default on #2d9c75273d72b32df726fb545c8a4edc719f0a95a6fd993950b10c474ad9c927 ~* &* +@all"on— пользователь включён.#2d9c75…— не сам пароль, а его отпечаток SHA256. Сам пароль Redis в ответах не показывает.~*— доступ ко всем ключам,&*— ко всем каналам,+@all— ко всем командам.
До того как поставить пароль, на месте отпечатка стоит nopass: любой вход принимается.
Под каким пользователем вы вошли, покажет ACL WHOAMI — ответ "default".
Где лежит пароль
Пароль из строки requirepass лежит в /etc/redis/redis.conf открытым текстом. Читать этот файл могут только root и пользователь redis: права 640. Проверить: ls -l /etc/redis/redis.conf, в начале строки должно быть -rw-r-----.
Пароль, вписанный в настройки сайта, лежит в файлах сайта. Если сайтов на сервере несколько, у каждого из них должен быть свой пользователь Linux, иначе соседний сайт прочитает пароль из чужих файлов.
Как сменить пароль без перезапуска
- Получите новый пароль:
redis-cli --askpass ACL GENPASS. - Задайте его:
redis-cli --askpass CONFIG SET requirepass новый_пароль. Здесь--askpassспрашивает старый пароль. - Запишите в файл:
redis-cli --askpass CONFIG REWRITE— теперь вводите новый пароль. ОтветOK. - Впишите новый пароль в настройки сайта.
Команда из шага 2 останется в истории команд Linux вместе с паролем. Чтобы этого не было, выполните шаги 2 и 3 в окне redis-cli: наберите redis-cli --askpass, Enter, и команды вводите после приглашения 127.0.0.1:6379>. redis-cli не записывает в свою историю команды с паролями — история команд.
Отдельные пользователи: ACL
Пользователю default можно всё: менять настройки, останавливать Redis, стирать все базы. Сайту это не нужно. Отдельный пользователь с урезанными правами защищает от ошибки в плагине и от того, кто получил пароль сайта.
Создайте пользователя для сайта. Команды вводите в окне redis-cli, чтобы пароль не попал в историю:
redis-cli --askpassи пароль пользователя default.- Получите пароль для сайта:
ACL GENPASS. - Создайте пользователя:
ACL SETUSER site on >пароль_для_сайта ~* &* +@all -@admin -flushallОтвет
OK. - Сохраните пользователя в файл:
CONFIG REWRITE. Без этого шага пользователь пропадёт при перезапуске Redis. - Выйдите:
exit. - Проверьте вход:
redis-cli --user site --askpass ACL WHOAMI. Ответ"site". - Впишите в настройки сайта имя пользователя
siteи его пароль.
Что значат правила в команде:
| Правило | Что делает |
|---|---|
on | пользователь включён: под ним можно войти |
>пароль | добавляет пароль. Знак > пишется вплотную к паролю |
~* | все ключи |
&* | все каналы сообщений |
+@all | все команды… |
-@admin | …кроме управления: CONFIG, ACL SETUSER, ACL LIST, SHUTDOWN, MONITOR, DEBUG |
-flushall | и кроме FLUSHALL — стереть все базы сразу |
Команда FLUSHDB — очистить одну базу — у сайта остаётся. Если её тоже нужно запретить, допишите в конец команды -flushdb.
Проверьте, что запрет работает:
redis-cli --user site --askpass CONFIG GET maxmemory(error) NOPERM this user has no permissions to run the 'config|get' commandЕсли сайт умеет подключаться к Redis только с паролем, без имени пользователя, он входит как default. Тогда отдельный пользователь ему не поможет — оставьте сайту пароль из requirepass.
Где Redis хранит пользователей
После CONFIG REWRITE в конце /etc/redis/redis.conf появляются строки вида:
user default on #2d9c75… ~* &* +@all
user site on #9f86d0… ~* &* +@all -@admin -flushallПароли в этих строках — отпечатки, а не сами пароли. Менять пользователей лучше командой ACL SETUSER и потом CONFIG REWRITE, а не правкой этих строк руками.
Пользователей можно держать и в отдельном файле — настройка aclfile. В Ubuntu она выключена. Оба способа сразу не работают: если в redis.conf есть строки user и включён aclfile, Redis не запустится.
Кто пробовал войти с неверным паролем
redis-cli --askpass ACL LOGRedis держит в памяти последние 128 отказов: неверный пароль и запрещённые команды. В каждой записи:
count— сколько раз повторился отказ;reason—auth— неверный пароль,command— запрещённая команда;object— какая команда;username— под каким пользователем;age-seconds— сколько секунд назад;client-info— откуда подключались.
Очистить список: ACL LOG RESET. Сколько записей хранить, задаёт настройка acllog-max-len.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
(error) NOAUTH Authentication required. | на Redis стоит пароль, а его не передали | redis-cli --askpass, на сайте — пароль в настройках. Разбор |
(error) WRONGPASS invalid username-password pair or user is disabled. | неверный пароль, неверное имя или пользователь выключен | сверьте пароль с redis.conf — разбор |
(error) NOPERM this user has no permissions to run the '…' command | у пользователя нет права на эту команду | войдите как default или добавьте право: ACL SETUSER site +команда |
ERR Error in ACL SETUSER modifier '…': Unknown command or category name in ACL | опечатка в названии команды или категории | сверьте написание: +@all, -@admin |
| пользователь пропал после перезапуска | не выполнили CONFIG REWRITE | создайте его снова и выполните CONFIG REWRITE |
| сайт перестал работать после смены пароля | в настройках сайта старый пароль | впишите новый пароль в настройки сайта |
Все разборы — в разделе Ошибки Redis. Всё сверено с Redis 7.0.15 — эта версия ставится из пакетов Ubuntu 24.04. В Ubuntu 26.04 ставится Redis 8.0.5.
Источники
- Документация Redis: ACL — на английском: пользователь default, requirepass задаёт его пароль, правила on, >пароль, ~, &, +@all, отпечатки SHA256, ACL GENPASS, файл aclfile.
- Документация Redis: ACL WHOAMI — на английском.
- Файл redis.conf в Ubuntu 24.04 — строки requirepass и aclfile закомментированы, acllog-max-len 128, строки user и aclfile вместе не работают.
- Исходный код Redis 7.0.15: acl.c — поля ответа ACL LOG, текст ошибки ACL SETUSER.
- Исходный код Redis 7.0.15: server.c — тексты ошибок NOAUTH и NOPERM, команды с флагом ADMIN попадают в категорию @admin.
- Исходный код Redis 7.0.15: config.c — CONFIG REWRITE записывает пользователей строками user, requirepass меняется на ходу.
- Описания команд Redis 7.0.15 — флаги команд: CONFIG, ACL SETUSER, SHUTDOWN, MONITOR, DEBUG — ADMIN; FLUSHALL и FLUSHDB — без него.
Сверено 5 ноября 2026 года.
Что почитать дальше
- Как установить Redis на Ubuntuустановка и первые настройки.
- Настройки Redisredis.conf, CONFIG SET и CONFIG REWRITE.
- redis-cliкак войти с паролем и под другим пользователем.