Redis через сокет: как подключить сайт без порта 6379
Если сайт и Redis на одном сервере, подключаться можно не через порт 6379, а через файл-сокет. До такого файла не достать по сети, а доступ к нему решают права в системе: кто в группе redis, тот и подключится. В Ubuntu сокет после установки выключен — здесь как его включить, дать доступ сайту и проверить.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите, включён ли сокет:
sudo grep -n 'unixsocket' /etc/redis/redis.conf - Ответ после установки в Ubuntu — обе строки со знаком
#, то есть выключены:155:# unixsocket /run/redis/redis-server.sock 156:# unixsocketperm 700Номера строк у вас могут отличаться.
- Если строки без
#— сокет уже включён. Проверьте, что он есть:ls -l /run/redis/. Строка сredis-server.sock, которая начинается с буквыs, — это и есть сокет. - Чтобы включить сокет, сделайте шаги из раздела как включить сокет.
Сокет или порт 6379
| Порт 6379 | Сокет /run/redis/redis-server.sock | |
|---|---|---|
| Кто может подключиться | все, кто дойдёт до адреса из bind | только программы на этом сервере, у которых есть права на файл |
| Как закрыть от чужих | bind, пароль, фаервол | права на файл: группа redis |
| Сайт на другом сервере | может подключиться | не может |
| В Ubuntu после установки | включён, только 127.0.0.1 и ::1 | выключен |
Документация Redis пишет, что на Linux через сокет можно получить около 50 % больше пропускной способности, чем через 127.0.0.1. Если сайт и Redis на одном сервере, сокет — самый закрытый вариант. Если на разных — сокет не подойдёт, нужен порт: как пустить второй сервер.
Как включить сокет
- Откройте файл:
sudo nano /etc/redis/redis.conf— как работать в nano. - Найдите строку: Ctrl+W, напечатайте
unixsocket, Enter. - Уберите
#в начале обеих строк и замените 700 на 770:unixsocket /run/redis/redis-server.sock unixsocketperm 770 - Сохраните: Ctrl+O, Enter, Ctrl+X.
- Перезапустите Redis:
sudo systemctl restart redis-server. - Проверьте:
ls -l /run/redis/ redis-cli -s /run/redis/redis-server.sock PINGВ списке файлов строка вида
srwxrwx--- 1 redis redis 0 … redis-server.sock, а redis-cli отвечаетPONG. Если на Redis стоит пароль, добавьте--askpass:redis-cli -s /run/redis/redis-server.sock --askpass PING.
Через CONFIG SET сокет не включить: строки unixsocket и unixsocketperm Redis читает только при запуске. Поэтому правка файла и перезапуск.
Порт 6379 после этого тоже работает: сайт, который подключается к 127.0.0.1, продолжит работать. Как выключить порт — ниже.
Failed opening Unix socket. А папка /tmp у Redis в Ubuntu своя, отдельная: сокет в ней сайт не найдёт.Что значит unixsocketperm
Число в unixsocketperm — права на файл сокета, как в команде chmod: первая цифра — владелец redis, вторая — группа redis, третья — все остальные.
| Значение | Кто может подключиться |
|---|---|
700 | только сам Redis и root. Сайту доступа нет |
770 | Redis, root и все пользователи из группы redis |
777 | любой пользователь на сервере. Так не делайте |
Подключиться к сокету может только тот, у кого есть права на запись в файл. Поэтому сайту нужно две вещи: 770 в unixsocketperm и его пользователь в группе redis.
Папку /run/redis создаёт systemd при запуске Redis и удаляет при остановке, вместе с сокетом. После перезапуска Redis создаёт сокет заново с теми же правами.
Как дать доступ сайту
- Узнайте, от какого пользователя работает сайт. Для сайтов на PHP в Ubuntu это пользователь www-data. Проверить:
ps -eo user,comm | grep php-fpmВ первом столбце —
rootу главного процесса иwww-dataу остальных. Нужен второй. - Добавьте этого пользователя в группу redis:
sudo usermod -aG redis www-data - Перезапустите PHP, чтобы он увидел новую группу: в Ubuntu 24.04 —
sudo systemctl restart php8.3-fpm, в Ubuntu 26.04 —sudo systemctl restart php8.5-fpm. - Проверьте от имени сайта:
sudo -u www-data redis-cli -s /run/redis/redis-server.sock PINGОтвет
PONG— доступ есть. Если на Redis стоит пароль, вместо PONG будет(error) NOAUTH Authentication required.— это тоже значит, что доступ к сокету есть: добавьте--askpassи повторите.
Пароль на Redis с сокетом тоже стоит оставить: права на файл закрывают Redis от других пользователей сервера, а пароль — от программ, которые работают под тем же www-data. Как поставить — пароль в Redis.
Как подключить сайт через сокет
| Что на сайте | Что написать |
|---|---|
| WordPress с плагином Redis Object Cache | в wp-config.php: define( 'WP_REDIS_SCHEME', 'unix' ); и define( 'WP_REDIS_PATH', '/run/redis/redis-server.sock' ); |
| PHP с расширением phpredis | $redis->connect('/run/redis/redis-server.sock'); — вместо адреса путь к сокету, порт не нужен |
| другая программа | в настройках подключения к Redis — путь /run/redis/redis-server.sock вместо адреса и порта |
В wp-config.php строки дописывают выше строки с надписью That's all, stop editing!. После правки откройте сайт. Если вместо сайта страница Error establishing a Redis connection — разбор.
Как выключить порт 6379
Когда сайт уже работает через сокет, порт можно выключить совсем. Тогда к Redis не подключиться по сети даже с самого сервера через 127.0.0.1.
- Проверьте, что все сайты и программы на сервере подключаются через сокет. Те, что подключаются к 127.0.0.1, после выключения порта перестанут работать.
- Откройте
sudo nano /etc/redis/redis.conf, найдите строкуport 6379и замените на:port 0 - Сохраните и перезапустите:
sudo systemctl restart redis-server. - Проверьте:
sudo ss -tlnp | grep 6379— пустой ответ, порт закрыт.redis-cli -s /run/redis/redis-server.sock PING—PONG.
С port 0 redis-cli без -s не подключится: каждый раз пишите redis-cli -s /run/redis/redis-server.sock. Вернуть порт — port 6379 и перезапуск.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Redis не запускается, в журнале Failed opening Unix socket | сокет в папке, куда Redis не может писать, или опечатка в пути | верните unixsocket /run/redis/redis-server.sock |
Could not connect to Redis at /run/redis/redis-server.sock: и пояснение системы, что файла нет | сокет не включён или Redis не запущен | проверьте строки в redis.conf и sudo systemctl status redis-server |
| то же, но система пишет, что нет прав | пользователь не в группе redis или в unixsocketperm 700 | шаги из раздела как дать доступ сайту |
| от себя redis-cli подключается, а сайт — нет | PHP не перезапущен после usermod | sudo systemctl restart php8.3-fpm |
(error) NOAUTH Authentication required. | на Redis стоит пароль | добавьте пароль в настройки сайта — разбор |
Could not connect to Redis at 127.0.0.1:6379: Connection refused после port 0 | порт выключен, а программа подключается к 127.0.0.1 | переведите её на сокет или верните port 6379 |
Журнал запуска: sudo journalctl -u redis-server -n 20 --no-pager и sudo tail -n 20 /var/log/redis/redis-server.log. После успешного запуска в журнале строка The server is now ready to accept connections at /run/redis/redis-server.sock.
Все разборы — в разделе Ошибки Redis. Всё сверено с Redis 7.0.15 — эта версия ставится из пакетов Ubuntu 24.04. В Ubuntu 26.04 ставится Redis 8.0.5.
Источники
- Файл redis.conf в Ubuntu 24.04 — строки
# unixsocket /run/redis/redis-server.sockи# unixsocketperm 700, port 0. - Как в Ubuntu собирается служба redis-server: debian/bin/generate-systemd-service-files — User=redis, Group=redis, RuntimeDirectory=redis с правами 2755, UMask=007, ProtectSystem=strict, PrivateTmp=true, ReadWritePaths.
- Исходный код Redis 7.0.15: config.c — unixsocket и unixsocketperm не меняются через CONFIG SET.
- Исходный код Redis 7.0.15: server.c — строки журнала Failed opening Unix socket и The server is now ready to accept connections at.
- Исходный код Redis 7.0.15: redis-cli.c — ключ -s, текст Could not connect to Redis at.
- Документация Redis: Redis benchmark — на английском: сокет на Linux даёт около 50 % больше пропускной способности, чем 127.0.0.1.
- Redis Object Cache 3.0.0: README — константы WP_REDIS_SCHEME и WP_REDIS_PATH.
- phpredis: README — connect с путём к сокету.
Сверено 5 ноября 2026 года.
Что почитать дальше
- bind и protected-mode в Redisкто может подключиться по порту.
- Пароль в Redis и пользователи ACLкак поставить пароль.
- Права на файлы сайтапользователь www-data и группы.