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

Настройки Redis: где redis.conf и как применить изменения

В Ubuntu все настройки Redis лежат в одном файле — /etc/redis/redis.conf. После правки файла Redis перезапускают. Многие настройки можно поменять и на ходу, командой CONFIG SET, но такое изменение живёт до перезапуска: чтобы оно осталось, его записывают в файл.

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

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Откройте файл настроек: sudo nano /etc/redis/redis.conf. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.
  3. Найдите нужную строку: нажмите Ctrl+W, напечатайте имя настройки, например maxmemory, и нажмите Enter. Строка, которая начинается со знака #, не действует: допишите под ней свою строку без #.
  4. Сохраните файл: Ctrl+O, Enter, затем Ctrl+X.
  5. Перезапустите Redis: sudo systemctl restart redis-server.
  6. Проверьте, что Redis отвечает: redis-cli ping. Ответ PONG — всё работает. Если на Redis стоит пароль, введите redis-cli --askpass ping и наберите пароль.
  7. Проверьте значение: redis-cli CONFIG GET maxmemory. Вместо maxmemory — имя своей настройки.

Если после перезапуска redis-cli ping отвечает Could not connect to Redis at 127.0.0.1:6379: Connection refused, Redis не запустился. Причину покажет sudo journalctl -u redis-server -n 20 --no-pager. Если там FATAL CONFIG FILE ERROR, в файле ошибка: Redis называет номер строки и её текст — что делать. Верните строку как было и снова перезапустите Redis.

Где какие файлы

ЧтоГде лежит
файл настроек/etc/redis/redis.conf
журнал Redis/var/log/redis/redis-server.log — как читать
снимок данных на диске/var/lib/redis/dump.rdb — сохранение на диск
службаredis-server, команды sudo systemctl restart redis-server и sudo systemctl status redis-server

Так устроено в Ubuntu 24.04: там ставится Redis 7.0.15. В Ubuntu 26.04 ставится Redis 8.0.5, файлы лежат там же. Как поставить Redis — Как установить Redis на Ubuntu.

С каким файлом запущен Redis, покажет команда:

redis-cli INFO server | grep config_file
config_file:/etc/redis/redis.conf

У файла права 640, владелец — пользователь redis: другие пользователи сервера его не прочитают. Поэтому открывать его нужно через sudo.

Как устроен файл

# строка со знаком решётки не действует
bind 127.0.0.1 -::1
port 6379
# maxmemory <bytes>
maxmemory 256mb
maxmemory-policy allkeys-lru
  • Одна строка — одна настройка: имя, пробел и значение. Знака = нет.
  • Строку со знаком # в начале Redis не читает. В файле из пакета больше двух тысяч строк, и в основном это такие подсказки с описанием настроек на английском.
  • Если одна настройка записана несколько раз, действует последняя строка.
  • Размер памяти пишут числом с буквами: 256mb — 256 мегабайт, 1gb — 1 гигабайт, 512kb — 512 килобайт. Большие или маленькие буквы — всё равно. Пробела между числом и буквами нет: 256 mb Redis не поймёт и не запустится.
  • Буква без b считается по-другому: 1m — ровно миллион байт, 1mb — 1 048 576 байт. Пишите с b, как в примерах на этой странице.
  • Включить или выключить настройку — слова yes и no.

Строку include /путь/к/файлу.conf пакет не ставит: все настройки — в одном redis.conf.

Перезапуск или CONFIG SET

Правка в redis.conf начинает действовать только после перезапуска Redis. При перезапуске Redis записывает данные на диск, останавливается и загружает их обратно. Пока он не запустился, сайт не может к нему подключиться. Если данных в Redis много, это занимает заметное время: пока идёт загрузка, Redis отвечает LOADING. Что Redis сохраняет и где — сохранение на диск.

Без перезапуска настройку меняют командой CONFIG SET:

redis-cli CONFIG SET maxmemory 256mb
OK

Новое значение действует сразу, со следующей команды. Но оно живёт только до перезапуска Redis: в файле осталось старое. Чтобы изменение сохранилось, сделайте одно из двух:

  • впишите то же значение в redis.conf руками;
  • выполните redis-cli CONFIG REWRITE — Redis сам запишет в файл действующие значения, подробнее ниже.

Одной командой можно поменять несколько настроек сразу: redis-cli CONFIG SET maxmemory 256mb maxmemory-policy allkeys-lru. Если хотя бы одно значение не подходит, Redis не меняет ни одного.

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

Эти настройки CONFIG SET не меняет — только строка в redis.conf и перезапуск:

НастройкаЧто задаёт
databasesсколько баз внутри Redis, в Ubuntu — 16 (базы и ключи)
unixsocket, unixsocketpermподключение через файл-сокет (Unix-сокет)
logfileкуда писать журнал
daemonize, supervisedкак Redis работает со службой systemd — не меняйте
aclfileфайл с пользователями Redis

Ещё две настройки — dir (папка с данными) и dbfilename (имя файла снимка) — Redis не даёт менять командой: это защита от того, кто получит доступ к Redis и попробует записать файл в чужую папку. Их тоже меняют только в redis.conf.

Остальные настройки со страниц этого раздела меняются и на ходу: maxmemory, maxmemory-policy, requirepass, bind, port, protected-mode, save, appendonly, loglevel, maxclients, timeout, slowlog-log-slower-than.

Команды CONFIG SET port, CONFIG SET bind и CONFIG SET requirepass действуют сразу: новые подключения со старым портом, адресом или паролем Redis перестанет пускать в ту же секунду. Решите заранее, как поменяете настройки сайта, и сделайте это сразу после команды.

Как посмотреть действующее значение

redis-cli CONFIG GET maxmemory
1) "maxmemory"
2) "268435456"

Первая строка — имя, вторая — значение. Размер памяти Redis показывает в байтах: 268435456 — это 256 МБ. Значение 0 у maxmemory значит «без лимита».

Несколько настроек сразу — через пробел: redis-cli CONFIG GET maxmemory maxmemory-policy. По началу имени со звёздочкой: redis-cli CONFIG GET 'maxmemory*'. Все настройки: redis-cli CONFIG GET '*' — список длинный, удобнее искать по имени.

CONFIG GET показывает то, что действует сейчас. Если вы поправили redis.conf и не перезапустили Redis, команда покажет старое значение.

Как записать изменения в файл

redis-cli CONFIG REWRITE
OK

Redis переписывает файл, с которым запущен, — в Ubuntu это /etc/redis/redis.conf:

  • комментарии и порядок строк остаются;
  • настройка, которая уже есть в файле, переписывается на своём месте;
  • новая настройка дописывается в конец файла, под строкой # Generated by CONFIG REWRITE;
  • если значение совпадает с тем, что Redis берёт по умолчанию, новую строку он не добавляет;
  • права на файл остаются 640.
CONFIG REWRITE записывает значения, которые действуют прямо сейчас. Если вы поправили redis.conf руками и ещё не перезапустили Redis, эта правка заменится действующим значением. Сначала перезапустите Redis или повторите ту же правку через CONFIG SET.

В Ubuntu служба Redis может писать в папку /etc/redis — это разрешено в её настройках systemd, поэтому CONFIG REWRITE работает сразу после установки.

Главные настройки

НастройкаЧто задаётВ UbuntuПодробно
bind, protected-modeкто может подключиться127.0.0.1 -::1, yesbind и protected-mode
portномер порта6379bind и protected-mode
requirepassпарольне заданпароль и ACL
maxmemoryлимит памятине задан, 0maxmemory
maxmemory-policyчто удалять при лимитеnoevictionmaxmemory
saveкогда делать снимок на диск3600 1 300 100 60 10000сохранение на диск
appendonlyжурнал всех записей AOFnoсохранение на диск
databasesсколько баз16базы и ключи
maxclientsсколько подключений10000ошибка max number of clients
timeoutчерез сколько секунд закрыть подключение, по которому нет команд0 — не закрывать—
loglevel, logfileчто и куда писать в журналnotice, /var/log/redis/redis-server.logжурнал Redis
slowlog-log-slower-thanкакие команды считать медленными10000 — 10 мсSLOWLOG
unixsocketфайл-сокет вместо портавыключенUnix-сокет

Строк save в redis.conf Ubuntu нет, есть только подсказка # save 3600 1 300 100 60 10000: Redis берёт это расписание по умолчанию.

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

Что видитеПричинаЧто делать
(error) ERR Unknown option or number of arguments for CONFIG SET - 'maxmemori'опечатка в имени настройкипроверьте имя: redis-cli CONFIG GET 'maxmem*'
(error) ERR CONFIG SET failed (possibly related to argument 'databases') - can't set immutable configэту настройку нельзя менять на ходувпишите её в redis.conf и перезапустите Redis
(error) ERR CONFIG SET failed (possibly related to argument 'dir') - can't set protected configdir и dbfilename защищены от изменения командойменяйте в redis.conf
(error) ERR CONFIG SET failed (possibly related to argument 'maxmemory-policy') - argument(s) must be one of the following: volatile-lru, …такого значения нетвозьмите одно из перечисленных
(error) ERR CONFIG SET failed (possibly related to argument 'maxmemory') - argument must be a memory valueразмер написан не такпишите без пробела: 256mb
(error) NOAUTH Authentication required.на Redis стоит парольподключитесь с --askpass — разбор
(error) ERR Rewriting config file: …Redis не смог записать redis.confпосмотрите права на папку: ls -ld /etc/redis — должно быть drwxrws--- и владелец redis
Redis не запускается после правкиошибка в файлеsudo journalctl -u redis-server -n 20 --no-pager и FATAL CONFIG FILE ERROR

Все разборы — в разделе Ошибки Redis. Всё сверено с Redis 7.0.15 — эта версия ставится из пакетов Ubuntu 24.04.

Источники

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

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

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