Конструктор строк подключения Redis
Создавайте URI подключения Redis или Valkey, строку конфигурации StackExchange.Redis или команду redis-cli в одной форме или вставьте готовую, чтобы увидеть, что делает каждый параметр и передаётся ли пароль по сети в открытом виде. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.
Открыть это подключение в SQLly
Открывает редактор подключений 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 Server
- Строки подключения к PostgreSQL
- Строки подключения к MySQL
- Строки подключения к MariaDB
- Строки подключения к SQLite
- Строки подключения к Oracle
- Строки подключения ClickHouse
- Строки подключения DuckDB
- Строки подключения libSQL
- Все движки и форматы
- Форматировщик SQL
- Все бесплатные инструменты
Подключитесь один раз. А потом просто пишите SQL.
SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для Redis и других баз данных.