// herramienta gratuita

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.

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 claveSinónimosPredeterminadoLo 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 claveSinónimosPredeterminadoLo 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 claveSinónimosPredeterminadoLo 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://.

// olvídate de las cadenas por completo

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.