Construtor de string de conexão do Redis
Construa um URI de conexão Redis ou Valkey, uma string de configuração StackExchange.Redis ou um comando redis-cli a partir de um formulário, ou cole um para ver o que cada opção faz e se a senha atravessa a rede em texto puro. Tudo roda no seu navegador: nada do que você digita é enviado para lugar nenhum.
Abrir esta conexão no SQLly
Abre o editor de conexão do SQLly preenchido.
Abrir esta conexão no SQLly
Privado por design. O construtor e o decodificador são JavaScript puro rodando nesta aba. A página não envia nenhuma solicitação com o que você digita, não armazena nada (nem mesmo no seu navegador) e continua funcionando offline após carregada. O link Abrir no SQLly vai do seu navegador direto para o aplicativo no seu computador.
Formatos de string de conexão do Redis
Quase todo cliente Redis aceita um URI: redis://[[user]:password@]host[:port][/db], ou rediss:// para TLS. O cliente .NET StackExchange.Redis é a exceção: ele usa uma string de configuração separada por vírgulas, como host:6380,password=...,ssl=true.
redis:// é texto puro, senha AUTH incluída. Serviços gerenciados (Azure Cache for Redis, ElastiCache com criptografia em trânsito, Upstash) querem rediss://.
URI com TLS redis-py, node-redis, ioredis, go-redis, Lettuce, Jedis, SQLly
rediss://:[email protected]/0
URI com um usuário 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 Linha de comando
redis-cli -h cache.example.com -p 6380 --tls --askpass
Marcadores como your_password são exatamente isso: monte sua própria string no formulário acima. Mais sobre como conectar o SQLly ao Redis: SQLly para Redis.
Partes do URI do Redis
redis e rediss são esquemas de URI provisórios da IANA. Use percent-encoding nos caracteres especiais do usuário e da senha. Uma senha sem usuário (redis://:pw@host) faz login como o default usuário.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
scheme |
- | redis | redis:// TCP simples, rediss:// TLS. Os clientes Valkey aceitam o mesmo; alguns também aceitam valkey://. |
user |
- | padrão | Nome de usuário ACL (Redis 6+). |
password |
- | - | Senha AUTH. |
host:port |
- | localhost:6379 | Endereço do servidor. |
/db |
?db= | 0 | Índice do banco de dados, de 0 a 15 por padrão. |
Opções de configuração do StackExchange.Redis
Formato: host:port[,host2:port2],option=value,.... Os nomes das opções não diferenciam maiúsculas de minúsculas. Uma senha que contenha vírgula não pode ser escrita na string; defina ConfigurationOptions.Password no código.
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
password |
- | - | Senha AUTH. |
user |
- | - | Nome de usuário ACL. |
ssl |
- | falso | Use TLS. Com ssl=true e sem porta, a porta padrão é 6380. |
sslHost |
- | - | O nome do host ao qual o certificado deve corresponder. |
abortConnect |
- | true (false no Azure Cache for Redis) | false continua tentando em segundo plano em vez de lançar erro em Connect. |
connectTimeout |
- | 5000 | Milissegundos. |
syncTimeout |
- | 5000 | Milissegundos para operações síncronas. |
asyncTimeout |
- | syncTimeout | Milissegundos para operações assíncronas. |
connectRetry |
- | 3 | Tentativas de conexão. |
defaultDatabase |
- | - | Índice do banco de dados. |
name |
- | - | Nome do cliente (CLIENT SETNAME). |
allowAdmin |
- | falso | Permitir FLUSHALL, CONFIG e outros comandos de administração. |
keepAlive |
- | -1 (60 s) | Segundos entre os pings de keepalive. |
serviceName |
- | - | Nome do master do Sentinel. |
Flags de conexão do redis-cli
redis-cli também aceita -u redis://....
| Palavra-chave | Sinônimos | Padrão | O que faz |
|---|---|---|---|
-h |
- | 127.0.0.1 | Host. |
-p |
- | 6379 | Porta. |
--user |
- | - | Usuário ACL (com senha). |
-a / --pass |
- | - | Senha na linha de comando; visível no histórico do shell e na lista de processos. Prefira --askpass ou o REDISCLI_AUTH variável de ambiente. |
-n |
- | 0 | Índice do banco de dados. |
--tls |
- | - | Use TLS; adicionar --cacert para uma CA privada. |
Erros comuns de conexão Redis
NOAUTH Authentication required.
Por que: O servidor tem senha (requirepass ou usuários de ACL) e o cliente enviou um comando sem autenticar, geralmente porque a senha está ausente no URI.
Correção: Adicione a senha: redis://:password@host:6379, ou redis://user:password@host para um usuário ACL.
WRONGPASS invalid username-password pair or user is disabled.
Por que: Redis 6+ rejeitou as credenciais. Frequentemente a senha era dada como nome de usuário: alguns clientes leem redis://secret@host como usuário secret sem senha.
Correção: Escrever redis://:secret@host (observe os dois pontos) ou forneça tanto o usuário quanto a senha.
It was not possible to connect to the redis server(s).
Por que: StackExchange.Redis não conseguiu conectar: host ou porta incorretos, TLS necessário mas ssl=true ausente (ou vice-versa), ou um firewall. Com abortConnect=true (o padrão) lança imediatamente.
Correção: Verificar ssl e a porta (os endpoints TLS geralmente são 6380), e configure abortConnect=false para que o multiplexer continue tentando.
DENIED Redis is running in protected mode because protected mode is enabled
Por que: Um Redis sem senha e sem endereço de bind explícito recusa conexões de outras máquinas.
Correção: Defina uma senha (ou usuários ACL) e um bind endereço no servidor em vez de desativar o modo protegido.
FAQ sobre string de conexão do Redis
Qual é o formato da string de conexão do Redis?
redis://[[user]:password@]host[:port][/db], ou rediss:// para TLS. Por exemplo rediss://:[email protected]:6380/0. StackExchange.Redis usa host:port,password=...,ssl=true em vez disso.
Qual é a porta padrão do Redis?
6379. Muitos serviços gerenciados servem TLS na 6380, e o StackExchange.Redis assume 6380 quando ssl=true e nenhuma porta é dada.
Como colocar um nome de usuário em um URI do Redis?
O Redis 6 adicionou usuários ACL: redis://user:password@host:6379. Com apenas uma senha, escreva redis://:password@host; o servidor conecta você como o default usuário.
Essas strings funcionam para Valkey?
Sim. Valkey é compatível com o protocolo do Redis, então os mesmos URIs, strings de configuração e flags do redis-cli (ou valkey-cli) funcionam. O SQLly também lê valkey:// e valkeys://.
Outros mecanismos
- Strings de conexão do SQL Server
- Strings de conexão do PostgreSQL
- Strings de conexão do MySQL
- Strings de conexão do MariaDB
- Strings de conexão do SQLite
- Strings de conexão do Oracle
- Strings de conexão do ClickHouse
- Strings de conexão do DuckDB
- Strings de conexão do libSQL
- Todos os mecanismos e formatos
- Formatador SQL
- Todas as ferramentas gratuitas
Conecte-se uma vez. Depois é só escrever SQL.
O SQLly é um ambiente de trabalho SQL nativo para macOS, Windows e Linux. Cole uma string de conexão no editor de conexões, mantenha as senhas no chaveiro do sistema e tenha IntelliSense baseado no esquema no Redis e muito mais.