Constructor de cadenas de conexión de Redis
Construye un URI de conexión Redis o Valkey, una cadena de configuración de StackExchange.Redis o un comando redis-cli a partir de un formulario, o pega uno para ver qué hace cada opción y si la contraseña viaja por la red en texto plano. Todo se ejecuta en tu navegador: nada de lo que escribas se envía a ningún lugar.
Abrir esta conexión en SQLly
Abre el editor de conexiones de SQLly con los datos ya rellenados.
Abrir esta conexión en SQLly
Privado por diseño. El constructor y el decodificador son JavaScript puro que se ejecuta en esta pestaña. La página no envía ninguna solicitud con lo que escribes, no almacena nada (ni siquiera en tu navegador) y sigue funcionando sin conexión una vez cargada. El enlace Abrir en SQLly va directamente desde tu navegador a la aplicación en tu computadora.
Formatos de cadena de conexión de Redis
Casi todos los clientes de Redis aceptan un URI: redis://[[user]:password@]host[:port][/db], o rediss:// para TLS. El cliente .NET StackExchange.Redis es la excepción: utiliza una cadena de configuración separada por comas como host:6380,password=...,ssl=true.
redis:// es texto plano, incluida la contraseña AUTH. Los servicios administrados (Azure Cache for Redis, ElastiCache con cifrado en tránsito, Upstash) quieren rediss://.
URI con TLS redis-py, node-redis, ioredis, go-redis, Lettuce, Jedis, SQLly
rediss://:[email protected]/0
URI con un usuario ACL (Redis 6+) igual
rediss://app_user:[email protected]:6380/0
StackExchange.Redis .NET
cache.example.com:6380,password=your_password,ssl=true,abortConnect=false
redis-cli línea de comandos
redis-cli -h cache.example.com -p 6380 --tls --askpass
Los marcadores de posición como your_password son eso mismo: construye tu propia cadena con el formulario de arriba. Más sobre cómo conectar SQLly a Redis: SQLly para Redis.
Partes del URI de Redis
redis y rediss son esquemas de URI provisionales de la IANA. Codifica con porcentaje los caracteres especiales del usuario y de la contraseña. Una contraseña sin usuario (redis://:pw@host) inicia sesión como el default usuario.
| Palabra clave | Sinónimos | Predeterminado | Lo que hace |
|---|---|---|---|
scheme |
- | redis | redis:// TCP sin cifrar, rediss:// TLS. Los clientes Valkey aceptan lo mismo; algunos también aceptan valkey://. |
user |
- | default | Nombre de usuario ACL (Redis 6+). |
password |
- | - | Contraseña de AUTH. |
host:port |
- | localhost:6379 | Dirección del servidor. |
/db |
?db= | 0 | Índice de la base de datos, de 0 a 15 por defecto. |
Opciones de configuración de StackExchange.Redis
Formato: host:port[,host2:port2],option=value,.... Los nombres de las opciones no distinguen mayúsculas de minúsculas. Una contraseña con coma no puede escribirse en la cadena; establécela ConfigurationOptions.Password en código.
| Palabra clave | Sinónimos | Predeterminado | Lo que hace |
|---|---|---|---|
password |
- | - | Contraseña de AUTH. |
user |
- | - | Nombre de usuario ACL. |
ssl |
- | falso | Usa TLS. Con ssl=true y sin puerto, el puerto predeterminado es 6380. |
sslHost |
- | - | Nombre de host con el que debe coincidir el certificado. |
abortConnect |
- | true (false para Azure Cache for Redis) | false sigue reintentando en segundo plano en lugar de lanzar el error al conectar. |
connectTimeout |
- | 5000 | Milisegundos. |
syncTimeout |
- | 5000 | Milisegundos para operaciones síncronas. |
asyncTimeout |
- | syncTimeout | Milisegundos para operaciones asíncronas. |
connectRetry |
- | 3 | Intentos de conexión. |
defaultDatabase |
- | - | Índice de base de datos. |
name |
- | - | Nombre del cliente (CLIENT SETNAME). |
allowAdmin |
- | falso | Permitir FLUSHALL, CONFIG y otros comandos de administración. |
keepAlive |
- | -1 (60 s) | Segundos entre pings de mantenimiento. |
serviceName |
- | - | Nombre del maestro Sentinel. |
Opciones de conexión de redis-cli
redis-cli también acepta -u redis://....
| Palabra clave | Sinónimos | Predeterminado | Lo que hace |
|---|---|---|---|
-h |
- | 127.0.0.1 | Host. |
-p |
- | 6379 | Puerto. |
--user |
- | - | Usuario ACL (con contraseña). |
-a / --pass |
- | - | Contraseña en la línea de comandos; es visible en el historial del shell y en la lista de procesos. Prefiere --askpass o la REDISCLI_AUTH variable de entorno. |
-n |
- | 0 | Índice de base de datos. |
--tls |
- | - | Usa TLS; añade --cacert para una CA privada. |
Errores comunes de conexión a Redis
NOAUTH Authentication required.
Por qué: El servidor tiene una contraseña (requirepass o usuarios ACL) y el cliente envió un comando sin autenticarse, normalmente porque falta la contraseña en la URI.
Solución: Añadir la contraseña: redis://:password@host:6379, o redis://user:password@host para un usuario ACL.
WRONGPASS invalid username-password pair or user is disabled.
Por qué: Redis 6+ rechazó las credenciales. A menudo la contraseña se había indicado como nombre de usuario: algunos clientes leen redis://secret@host como usuario secret sin contraseña.
Solución: Escribir redis://:secret@host (fíjate en los dos puntos) o proporciona tanto el usuario como la contraseña.
It was not possible to connect to the redis server(s).
Por qué: StackExchange.Redis no pudo conectarse: host o puerto incorrecto, se requiere TLS pero ssl=true faltante (o al revés), o un firewall. Con abortConnect=true (el predeterminado) lanza el error de inmediato.
Solución: Comprobar ssl y el puerto (los endpoints TLS suelen ser 6380), y configurar abortConnect=false para que el multiplexor siga reintentando.
DENIED Redis is running in protected mode because protected mode is enabled
Por qué: Un Redis sin contraseña y sin dirección de enlace explícita rechaza conexiones desde otras máquinas.
Solución: Establece una contraseña (o usuarios ACL) y una bind dirección en el servidor en lugar de desactivar el modo protegido.
Preguntas frecuentes sobre la cadena de conexión de Redis
¿Cuál es el formato de la cadena de conexión de Redis?
redis://[[user]:password@]host[:port][/db], o rediss:// para TLS. Por ejemplo rediss://:[email protected]:6380/0. StackExchange.Redis usa host:port,password=...,ssl=true en su lugar.
¿Cuál es el puerto predeterminado de Redis?
6379. Muchos servicios gestionados ofrecen TLS en el 6380, y StackExchange.Redis asume 6380 cuando ssl=true y no se indica ningún puerto.
¿Cómo incluyo un nombre de usuario en un URI de Redis?
Redis 6 añadió usuarios ACL: redis://user:password@host:6379. Con solo una contraseña, escribe redis://:password@host; el servidor te conecta como el default usuario.
¿Funcionan estas cadenas con Valkey?
Sí. Valkey es compatible con el protocolo de Redis, por lo que funcionan los mismos URI, las cadenas de configuración y los flags de redis-cli (o valkey-cli). SQLly también lee valkey:// y valkeys://.
Otros motores
- Cadenas de conexión de SQL Server
- Cadenas de conexión de PostgreSQL
- Cadenas de conexión de MySQL
- Cadenas de conexión de MariaDB
- Cadenas de conexión de SQLite
- Cadenas de conexión de Oracle
- Cadenas de conexión de ClickHouse
- Cadenas de conexión de DuckDB
- Cadenas de conexión de libSQL
- Todos los motores y formatos
- Formateador SQL
- Todas las herramientas gratuitas
Conéctate una vez. Luego solo escribe SQL.
SQLly es un entorno de trabajo SQL nativo para macOS, Windows y Linux. Pega una cadena de conexión en su editor de conexiones, guarda las contraseñas en el llavero del sistema y obtén IntelliSense que entiende el esquema en Redis, entre otros.