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

Пароль в Redis и отдельные пользователи ACL

После установки Redis пускает без пароля любую программу, которая подключилась к нему на сервере. Пароль ставят одной строкой requirepass в redis.conf. Если нужно, чтобы сайт не мог стереть все данные или поменять настройки, создают для него отдельного пользователя ACL.

≈ 8 мин чтения
Содержание 11

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Получите надёжный пароль: redis-cli ACL GENPASS. Redis ответит строкой из 64 букв и цифр в кавычках. Скопируйте её без кавычек.
  3. Откройте файл настроек: sudo nano /etc/redis/redis.conf.
  4. Найдите строку # requirepass foobared: Ctrl+W, напечатайте requirepass foobared, Enter. Под ней допишите строку со своим паролем:
    requirepass вставьте_сюда_пароль
  5. Сохраните файл: Ctrl+O, Enter, затем Ctrl+X.
  6. Перезапустите Redis: sudo systemctl restart redis-server.
  7. Проверьте, что без пароля Redis не пускает: redis-cli PING. Ответ должен быть (error) NOAUTH Authentication required.
  8. Проверьте вход с паролем: redis-cli --askpass PING. Redis спросит Please input password: — вставьте пароль и нажмите Enter. При вводе пароль не виден. Ответ PONG — всё работает.
  9. Впишите пароль в настройки подключения к 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 LIST
1) "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, иначе соседний сайт прочитает пароль из чужих файлов.

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

  1. Получите новый пароль: redis-cli --askpass ACL GENPASS.
  2. Задайте его: redis-cli --askpass CONFIG SET requirepass новый_пароль. Здесь --askpass спрашивает старый пароль.
  3. Запишите в файл: redis-cli --askpass CONFIG REWRITE — теперь вводите новый пароль. Ответ OK.
  4. Впишите новый пароль в настройки сайта.

Команда из шага 2 останется в истории команд Linux вместе с паролем. Чтобы этого не было, выполните шаги 2 и 3 в окне redis-cli: наберите redis-cli --askpass, Enter, и команды вводите после приглашения 127.0.0.1:6379>. redis-cli не записывает в свою историю команды с паролями — история команд.

Отдельные пользователи: ACL

Пользователю default можно всё: менять настройки, останавливать Redis, стирать все базы. Сайту это не нужно. Отдельный пользователь с урезанными правами защищает от ошибки в плагине и от того, кто получил пароль сайта.

Создайте пользователя для сайта. Команды вводите в окне redis-cli, чтобы пароль не попал в историю:

  1. redis-cli --askpass и пароль пользователя default.
  2. Получите пароль для сайта: ACL GENPASS.
  3. Создайте пользователя:
    ACL SETUSER site on >пароль_для_сайта ~* &* +@all -@admin -flushall

    Ответ OK.

  4. Сохраните пользователя в файл: CONFIG REWRITE. Без этого шага пользователь пропадёт при перезапуске Redis.
  5. Выйдите: exit.
  6. Проверьте вход: redis-cli --user site --askpass ACL WHOAMI. Ответ "site".
  7. Впишите в настройки сайта имя пользователя 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 LOG

Redis держит в памяти последние 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.

Источники

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

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

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