Настройки Redis: где redis.conf и как применить изменения
В Ubuntu все настройки Redis лежат в одном файле — /etc/redis/redis.conf. После правки файла Redis перезапускают. Многие настройки можно поменять и на ходу, командой CONFIG SET, но такое изменение живёт до перезапуска: чтобы оно осталось, его записывают в файл.
Содержание 11
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Откройте файл настроек:
sudo nano /etc/redis/redis.conf. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Найдите нужную строку: нажмите Ctrl+W, напечатайте имя настройки, например
maxmemory, и нажмите Enter. Строка, которая начинается со знака#, не действует: допишите под ней свою строку без#. - Сохраните файл: Ctrl+O, Enter, затем Ctrl+X.
- Перезапустите Redis:
sudo systemctl restart redis-server. - Проверьте, что Redis отвечает:
redis-cli ping. ОтветPONG— всё работает. Если на Redis стоит пароль, введитеredis-cli --askpass pingи наберите пароль. - Проверьте значение:
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_fileconfig_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 mbRedis не поймёт и не запустится. - Буква без 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 256mbOKНовое значение действует сразу, со следующей команды. Но оно живёт только до перезапуска 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 maxmemory1) "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 REWRITEOKRedis переписывает файл, с которым запущен, — в Ubuntu это /etc/redis/redis.conf:
- комментарии и порядок строк остаются;
- настройка, которая уже есть в файле, переписывается на своём месте;
- новая настройка дописывается в конец файла, под строкой
# Generated by CONFIG REWRITE; - если значение совпадает с тем, что Redis берёт по умолчанию, новую строку он не добавляет;
- права на файл остаются 640.
В Ubuntu служба Redis может писать в папку /etc/redis — это разрешено в её настройках systemd, поэтому CONFIG REWRITE работает сразу после установки.
Главные настройки
| Настройка | Что задаёт | В Ubuntu | Подробно |
|---|---|---|---|
bind, protected-mode | кто может подключиться | 127.0.0.1 -::1, yes | bind и protected-mode |
port | номер порта | 6379 | bind и protected-mode |
requirepass | пароль | не задан | пароль и ACL |
maxmemory | лимит памяти | не задан, 0 | maxmemory |
maxmemory-policy | что удалять при лимите | noeviction | maxmemory |
save | когда делать снимок на диск | 3600 1 300 100 60 10000 | сохранение на диск |
appendonly | журнал всех записей AOF | no | сохранение на диск |
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 config | dir и 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.
Источники
- Файл redis.conf в Ubuntu 24.04 — действующие строки файла, буквы размера памяти, правило последней строки, подсказка save.
- Скрипт установки пакета redis-server в Ubuntu 24.04 — права 640 на redis.conf и права на папку /etc/redis.
- Описание службы redis-server в Ubuntu 24.04 — запуск с /etc/redis/redis.conf и запись в папку /etc/redis.
- Исходный код Redis 7.0.15: config.c — какие настройки нельзя менять на ходу, откат всех значений при ошибке в одной из настроек, тексты ошибок CONFIG SET и CONFIG REWRITE, права 640 после перезаписи, строка Generated by CONFIG REWRITE.
- Исходный код Redis 7.0.15: server.c — строка config_file в ответе INFO server, снимок на диск перед остановкой.
- Документация Redis: CONFIG SET — на английском: изменение на ходу действует со следующей команды.
- Документация Redis: CONFIG GET — на английском: несколько имён и шаблоны со звёздочкой.
- Документация Redis: CONFIG REWRITE — на английском: что сохраняется при перезаписи файла.
- Пакет redis-server в Ubuntu 24.04 — ставит Redis 7.0.15.
- Пакет redis-server в Ubuntu 26.04 — ставит Redis 8.0.5.
Сверено 5 ноября 2026 года.
Что почитать дальше
- Как установить Redis на Ubuntuустановка, проверка и подключение к сайту на PHP.
- redis-cliкак подключиться к Redis и вводить команды.
- Ошибки Redisразборы ошибок по тексту.
- Настройки PostgreSQLто же для PostgreSQL.