// бесплатный инструмент

Конструктор строк подключения Redis

Создавайте URI подключения Redis или Valkey, строку конфигурации StackExchange.Redis или команду redis-cli в одной форме или вставьте готовую, чтобы увидеть, что делает каждый параметр и передаётся ли пароль по сети в открытом виде. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.

Открыть это подключение в SQLly

Открывает редактор подключений SQLly с заполненными полями.

Приватность на уровне архитектуры. Конструктор и декодер — обычный JavaScript, работающий в этой вкладке. Страница никуда не отправляет то, что вы вводите, ничего не хранит (даже в вашем браузере) и продолжает работать офлайн после загрузки. Ссылка «Открыть в SQLly» ведёт из вашего браузера прямо в приложение на вашем компьютере.

Форматы строк подключения Redis

Почти каждый клиент Redis принимает URI: redis://[[user]:password@]host[:port][/db], или rediss:// для TLS. Клиент .NET StackExchange.Redis является исключением: он использует строку конфигурации с разделителями-запятыми, такую как host:6380,password=...,ssl=true.

redis:// — это обычный текст, в том числе пароль AUTH. Управляемым сервисам (Azure Cache for Redis, ElastiCache с шифрованием в транзите, Upstash) нужен rediss://.

URI с TLS redis-py, node-redis, ioredis, go-redis, Lettuce, Jedis, SQLly

rediss://:[email protected]/0

URI с пользователем ACL (Redis 6+) то же самое

rediss://app_user:[email protected]:6380/0

StackExchange.Redis .NET

cache.example.com:6380,password=your_password,ssl=true,abortConnect=false

redis-cli командная строка

redis-cli -h cache.example.com -p 6380 --tls --askpass

Заполнители, такие как your_password — это лишь примеры: соберите свою строку в форме выше. Подробнее о подключении SQLly к Redis: SQLly для Redis.

Части URI Redis

redis и rediss — это предварительные схемы URI из реестра IANA. Специальные символы в имени пользователя и пароле кодируйте в percent-кодировке. Пароль без имени пользователя (redis://:pw@host) входит как default пользователь.

Ключевое словоСинонимыПо умолчаниюЧто оно делает
scheme - redis redis:// обычный TCP, rediss:// TLS. Клиенты Valkey принимают то же самое; некоторые также поддерживают valkey://.
user - default Имя пользователя ACL (Redis 6+).
password - - Пароль AUTH.
host:port - localhost:6379 Адрес сервера.
/db ?db= 0 Индекс базы данных, по умолчанию от 0 до 15.

Параметры конфигурации StackExchange.Redis

Формат: host:port[,host2:port2],option=value,.... Имена опций регистронезависимы. Пароль, содержащий запятую, не может быть записан в строке; установите ConfigurationOptions.Password в коде.

Ключевое словоСинонимыПо умолчаниюЧто оно делает
password - - Пароль AUTH.
user - - Имя пользователя ACL.
ssl - ложь Используйте TLS. С ssl=true и без порта используется порт по умолчанию 6380.
sslHost - - Имя хоста, с которым должен совпадать сертификат.
abortConnect - true (false для Azure Cache for Redis) false продолжает повторять попытки в фоне вместо того, чтобы упасть с ошибкой прямо в Connect.
connectTimeout - 5000 Миллисекунды.
syncTimeout - 5000 Миллисекунды для синхронных операций.
asyncTimeout - syncTimeout Миллисекунды для асинхронных операций.
connectRetry - 3 Попытки соединения.
defaultDatabase - - Индекс базы данных.
name - - Имя клиента (CLIENT SETNAME).
allowAdmin - ложь Разрешить команды администрирования, такие как FLUSHALL, CONFIG и другие.
keepAlive - -1 (60 с) Секунды между keepalive-пингами.
serviceName - - Имя мастера Sentinel.

флаги подключения redis-cli

redis-cli также принимает -u redis://....

Ключевое словоСинонимыПо умолчаниюЧто оно делает
-h - 127.0.0.1 Хост.
-p - 6379 Порт.
--user - - Пользователь ACL (с паролем).
-a / --pass - - Пароль в командной строке; виден в истории оболочки и списке процессов. Предпочтительнее --askpass или REDISCLI_AUTH переменная окружения.
-n - 0 Индекс базы данных.
--tls - - Использовать TLS; добавить --cacert для частного центра сертификации.

Распространённые ошибки подключения к Redis

NOAUTH Authentication required.

Почему: Сервер имеет пароль (requirepass или пользователи ACL), и клиент отправил команду без аутентификации, обычно потому, что пароль отсутствует в URI.

Исправлено: Добавьте пароль: redis://:password@host:6379, или redis://user:password@host для пользователя ACL.

WRONGPASS invalid username-password pair or user is disabled.

Почему: Redis 6+ отклонил учётные данные. Часто пароль передавался как имя пользователя: некоторые клиенты читают redis://secret@host от имени пользователя secret без пароля.

Исправлено: Пишите redis://:secret@host (обратите внимание на двоеточие) или укажите и пользователя, и пароль.

It was not possible to connect to the redis server(s).

Почему: StackExchange.Redis не смог подключиться: неверный хост или порт, требуется TLS, но ssl=true отсутствует (или наоборот), или срабатывает брандмауэр. С abortConnect=true (по умолчанию) она сразу выдаёт ошибку.

Исправлено: Проверить ssl и порт (для TLS-эндпоинтов это часто 6380), и задайте abortConnect=false так что мультиплексор продолжает повторять попытки.

DENIED Redis is running in protected mode because protected mode is enabled

Почему: Redis без пароля и без явного адреса привязки отказывает в соединениях с других машин.

Исправлено: Установите пароль (или пользователей ACL) и bind адрес на сервере, а не отключение защищённого режима.

FAQ по строке подключения Redis

Каков формат строки подключения Redis?

redis://[[user]:password@]host[:port][/db], или rediss:// для TLS. Например rediss://:[email protected]:6380/0. StackExchange.Redis использует host:port,password=...,ssl=true вместо этого.

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

6379. Многие управляемые сервисы держат TLS на порту 6380, и StackExchange.Redis ожидает порт 6380, когда ssl=true и порт не указан.

Как указать имя пользователя в URI Redis?

Redis 6 добавил пользователей ACL: redis://user:password@host:6379. Если указан только пароль, запишите redis://:password@host; сервер авторизует вас как default пользователь.

Эти строки работают с Valkey?

Да. Valkey совместим с Redis на уровне протокола, поэтому работают те же URI, строки конфигурации и флаги redis-cli (или valkey-cli). SQLly также читает valkey:// и valkeys://.

// вообще без строк подключения

Подключитесь один раз. А потом просто пишите SQL.

SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для Redis и других баз данных.